LogoLogo
WebsiteDocumentationChangelogStatusTerms
  • Getting Started
    • Overview
    • FAQs
    • Reference
      • Identifier Types
      • Identifier Profiles
      • Identity Clusters
      • Identity Resolution
      • Regular Expressions
      • Tabular Data Schema
      • Advanced Query Interface
      • IP Allowlisting
    • Global Data Regulations
  • Data
    • Sources
      • Amazon S3
      • API Source
      • Azure Blob Storage
      • BigQuery
      • Databricks
      • File Upload
      • Google Cloud Storage
      • Mailchimp
      • SDK Sources
        • Android SDK
        • iOS SDK
        • JavaScript SDK
      • SendGrid
      • Shopify
      • Snowflake
    • Data Configuration
      • Custom Identifiers
      • Traits
      • Events
      • Labels
  • Identity
    • EIDs Switchboard
  • Audiences
    • Audiences
      • Audience Builder
      • Insights
      • Activation
        • Real-Time Targeting
        • Google Ad Manager
        • Permutive
      • Exports
        • Metadata file
    • Destinations
      • Amazon DSP
      • Amazon S3
      • Azure Blob Storage
      • Campaign Manager 360
      • Display & Video 360
      • Google Ads
      • Google Cloud Storage (GCS)
      • Meta Ads
      • The Trade Desk
      • TikTok
      • Yahoo! Japan Ads
  • collaborate
    • Clean Rooms
      • Insights Clean Rooms
      • Activation Clean Rooms
      • Augmentation Clean Rooms
      • Prospecting Clean Rooms
    • Partnerships
      • Flash Partners
        • Optable Flash Node
        • AWS Connector
        • Snowflake Connector
      • Enterprise Partners
      • Flash Partner Settings
  • Differential Privacy
  • Admin
    • General
    • Accounts
      • Managing User Accounts
      • Roles
        • Permissions
      • Authentication
    • Real-Time API
    • Data Subject Requests
  • Profile Settings
    • Notifications
  • Guides
    • AWS Connector: Guides
      • Enterprise DCN
      • AWS Connector
    • Snowflake Connector: Guide
    • Optable CLI
    • Data Warehouse Exports
      • Google BigQuery
      • Snowflake
  • Announcements
    • Deprecation Notices
      • Q1 2025: Deprecation of Exports & Introduction of Syncs
      • Feb 21st, 2024: Removal of regex_allowed_http_origins
      • Dec 8th, 2022: Exports to Export Configurations
      • Deprecated uses in the CLI
Powered by GitBook
On this page
  • Why an Advanced Query Interface?
  • Use Cases
  • Using the Advanced Query Interface
  • Getting Access to Advanced Query Interface
  • Allowlist and View Link
  • Data Schema

Was this helpful?

  1. Getting Started
  2. Reference

Advanced Query Interface

Query your ID graph without moving data

Last updated 6 months ago

Was this helpful?

Why an Advanced Query Interface?

Your requirements are unique, and no platform can realistically address all use cases. Instead of guessing what you need, Optable believes you should be able to query your data from your own BigQuery account, while also keeping your data secure.

The Advanced Query Interface enables you to have a view of your entire ID graph made accessible from Google BigQuery without having to move data.

Use Cases

Here are some examples of operations you can currently perform through the Advanced Query Interface:

  • Join your identity graph with non-Optable data

  • Run custom algorithms (e.g., a lookalike model)

  • Run aggregation functions to generate insights

  • Create new computed traits and reingest them into your DCN (for when you do not control the schema of your data source and need to improve it)

Using the Advanced Query Interface

Your Advanced Query Interface contains:

  • Your full identity_graph

  • Filtered views per and

  • Routines, which are predicates you can use in a SQL WHERE clause, facilitating queries between views without joining them.

For instance, if you want the intersection between match 2 and audience 19, you can use the view audience_19 and filter it with the filter_match_2 predicate.

Another way to achieve the same result is to use two predicates.

Getting Access to Advanced Query Interface

Allowlist and View Link

Allowlist

Because Advanced Query Interface leverages Google BigQuery, user emails must be linked to a Google account, and groups must be Google Groups.

A User Type must be specified for each user:

  • Users: individual users, such as john@mediaco.com

  • Groups: group emails, such as adops@mediaco.com, which includes many individual users such as john@mediaco.com and jane@mediaco.com

  • Domains: you can give access to anyone in your organization by giving domain access to, for instance, mediaco.com

  • Service Accounts

If you gave access to a group such as adops@mediaco.com, but users within that group, such as jane@mediaco.com cannot access the Advanced Query Interface, check that the User Type is set to Group and not User.

View Link

The Advanced Query Interface is not "discoverable". Not only do you need to be included in the Allowlist, but you also must know your unique DCN's project_name.dataset_name.view_name (View Link) in order to access it from your Google BigQuery account.

There are two ways to access your data.

  1. You can copy the link from the UI or CLI and use it in your BigQuery query.

2. You can add the project to your BigQuery pinned projects. The project name is the first part of the View Link, before the dot. E.g., optable-platform.

Data Schema

To get access to the Advanced Query Interface, you will need to know the interface's View Link, and to be in the Allowlist. Both fields can be found/configured in the Settings > section on the UI.

The is only available to select users.

Your Optable ID graph has a predefined schema. You can optionally take advantage of to customize it to your need. Your schema will then look like this:

General
Advanced Query Interface
audience
match
Trait Typing