Looker integration summary

Stitch’s Looker integration replicates data using the Looker v3.1 API. Refer to the Schema section for a list of objects available for replication.

Looker feature snapshot

A high-level look at Stitch's Looker (v1) integration, including release status, useful links, and the features supported in Stitch.

STITCH
Release status

Beta

 Supported by

Singer Community
Stitch plan

Standard

 API availability

Available
Singer GitHub repository

singer-io/tap-looker
REPLICATION SETTINGS
Anchor Scheduling

Supported

 Advanced Scheduling

Supported
Table-level reset

Unsupported

 Configurable Replication Methods

Unsupported
DATA SELECTION
Table selection

Supported

 Column selection

Supported
Select all

Supported
TRANSPARENCY
Extraction Logs

Supported

 Loading Reports

Supported

Connecting Looker

Looker setup requirements

To set up Looker in Stitch, you need:

  • Looker Admin privileges. Admin privileges in Looker are required to generate credentials for Stitch.

Step 1: Generate Looker API credentials for Stitch

  1. Sign into your Looker account.
  2. Navigate to the Edit Users page.
  3. Click the Edit Keys button. This will take you to the Edit User API3 Keys page.
  4. Click the New API3 key button to generate a new key.
  5. Copy your Client ID and Client Secret. Keep it readily available for the next step.

Step 2: Add Looker as a Stitch data source

  1. Sign into your Stitch account.

  2. On the Stitch Dashboard page, click the Add Integration button.

  3. Click the Looker icon.

  4. Enter a name for the integration. This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your destination.

    For example, the name “Stitch Looker” would create a schema called stitch_looker in the destination. Note: Schema names cannot be changed after you save the integration.

  5. In the API Port field, enter your API Port number. Note: This value is usually 19999 unless you host Looker internally. If hosting internally, use your internal API Port value.
  6. In the Client ID field, paste the Client ID that you copied in Step 1.
  7. In the Client Secret field, paste the Client Secret that you copied in Step 1.
  8. In the Domain field, enter your Looker account domain. It’s typically looker.com, unless you use a white-labeled URL.
  9. In the Subdomain field, enter your Looker account subdomain. Your subdomain is the leading part of your Looker URL. For example: If the URL is https://stitch.looker.com, the value for this field would be stitch.

Step 3: Define the historical replication start date

The Sync Historical Data setting defines the starting date for your Looker integration. This means that:

  • For tables using Key-based Incremental Replication, data equal to or newer than this date will be replicated to your destination.
  • For tables using Full Table Replication, all data - including records that are older, equal to, or newer than this date - will be replicated to your destination.

Change this setting if you want to replicate data beyond Looker’s default setting of 1 year. For a detailed look at historical replication jobs, check out the Syncing Historical SaaS Data guide.

Step 4: Create a replication schedule

In the Replication Frequency section, you’ll create the integration’s replication schedule. An integration’s replication schedule determines how often Stitch runs a replication job, and the time that job begins.

Looker integrations support the following replication scheduling methods:

To keep your row usage low, consider setting the integration to replicate less frequently. See the Understanding and Reducing Your Row Usage guide for tips on reducing your usage.

Step 5: Set objects to replicate

The last step is to select the tables and columns you want to replicate. Learn about the available tables for this integration.

Note: If a replication job is currently in progress, new selections won’t be used until the next job starts.

For Looker integrations, you can select:

  1. Individual tables and columns

  2. All tables and columns

Click the tabs to view instructions for each selection method.

  1. In the integration’s Tables to Replicate tab, locate a table you want to replicate.

  2. To track a table, click the checkbox next to the table’s name. A blue checkmark means the table is set to replicate.

  3. To track a column, click the checkbox next to the column’s name. A blue checkmark means the column is set to replicate.

  4. Repeat this process for all the tables and columns you want to replicate.
  5. When finished, click the Finalize Your Selections button at the bottom of the screen to save your selections.
  1. Click into the integration from the Stitch Dashboard page.

  2. Click the Tables to Replicate tab.

  3. In the list of tables, click the box next to the Table Names column.

  4. In the menu that displays, click Track all Tables and Fields:

    The Track all Tables and Fields menu in the Tables to Replicate tab

  5. Click the Finalize Your Selections button at the bottom of the page to save your data selections.

Initial and historical replication jobs

After you finish setting up Looker, its Sync Status may show as Pending on either the Stitch Dashboard or in the Integration Details page.

For a new integration, a Pending status indicates that Stitch is in the process of scheduling the initial replication job for the integration. This may take some time to complete.

Free historical data loads

The first seven days of replication, beginning when data is first replicated, are free. Rows replicated from the new integration during this time won’t count towards your quota. Stitch offers this as a way of testing new integrations, measuring usage, and ensuring historical data volumes don’t quickly consume your quota.

Looker table reference

color_collections

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Get all color collections

The color_collections table contains information about color collections in your Looker account.

color_collections table schema

id
STRING

The color collection ID.

Reference:

categoricalPalettes
ARRAY

Click to expand categoricalPalettes

colors
ARRAY

Click to expand colors

value
STRING

color_collections (table), colors (attribute)

id
STRING

label
STRING

type
STRING

color_collections (table), categoricalPalettes (attribute)

divergingPalettes
ARRAY

Click to expand divergingPalettes

id
STRING

label
STRING

stops
ARRAY

Click to expand stops

color
STRING

offset
NUMBER

color_collections (table), stops (attribute)

type
STRING

color_collections (table), divergingPalettes (attribute)

label
STRING

sequentialPalettes
ARRAY

Click to expand sequentialPalettes

id
STRING

label
STRING

stops
ARRAY

Click to expand stops

color
STRING

offset
NUMBER

color_collections (table), stops (attribute)

type
STRING

color_collections (table), sequentialPalettes (attribute)

connections

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

name
API endpoint :

Get all connections

The connections table contains information about connections in your Looker account.

connections table schema

name
STRING

The name of the connection.

after_connect_statements
STRING

certificate
STRING

created_at
STRING

database
STRING

db_timezone
STRING

dialect
OBJECT

Click to expand dialect

automatically_run_sql_runner_snippets
BOOLEAN

connection_tests
ARRAY

Click to expand connection_tests

value
STRING

connections (table), connection_tests (attribute)

label
STRING

name
STRING

persistent_table_distkey
STRING

persistent_table_indexes
STRING

persistent_table_sortkeys
STRING

supports_cost_estimate
BOOLEAN

supports_inducer
BOOLEAN

supports_streaming
BOOLEAN

supports_upload_tables
BOOLEAN

connections (table), dialect (attribute)

dialect_name
STRING

example
BOOLEAN

file_type
STRING

host
STRING

jdbc_additional_params
STRING

last_reap_at
INTEGER

last_regen_at
INTEGER

maintenance_cron
STRING

max_billing_gigabytes
NUMBER

max_connections
INTEGER

password
STRING

pdt_context_override
OBJECT

Click to expand pdt_context_override

after_connect_statements
STRING

certificate
STRING

context
STRING

database
STRING

file_type
STRING

has_password
BOOLEAN

host
STRING

jdbc_additional_params
STRING

password
STRING

port
STRING

schema
STRING

username
STRING

connections (table), pdt_context_override (attribute)

pool_timeout
INTEGER

port
STRING

query_timezone
STRING

schema
STRING

snippets
ARRAY

Click to expand snippets

label
STRING

name
STRING

sql
STRING

connections (table), snippets (attribute)

sql_runner_precache_tables
BOOLEAN

ssl
BOOLEAN

tmp_db_name
STRING

user_attribute_fields
ARRAY

Click to expand user_attribute_fields

value
STRING

connections (table), user_attribute_fields (attribute)

user_db_credentials
BOOLEAN

user_id
STRING

Reference:

username
STRING

uses_oauth
BOOLEAN

verify_ssl
BOOLEAN

content_favorites

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Search favorite contents

The content_favorites table contains info about users’ favorite content in your Looker instance.

content_favorites table schema

id
STRING

The content favorite ID.

Reference:

content_metadata_id
STRING

Reference:

dashboard
OBJECT

Click to expand dashboard

content_favorite_id
STRING

Reference:

content_metadata_id
STRING

Reference:

description
STRING

folder
OBJECT

Click to expand folder

child_count
INTEGER

content_metadata_id
STRING

Reference:

creator_id
STRING

Reference:

external_id
STRING

id
STRING

Reference:

is_embed
BOOLEAN

is_embed_shared_root
BOOLEAN

is_embed_users_root
BOOLEAN

is_personal
BOOLEAN

is_personal_descendant
BOOLEAN

is_shared_root
BOOLEAN

is_users_root
BOOLEAN

name
STRING

parent_id
STRING

Reference:

content_favorites (table), folder (attribute)

hidden
BOOLEAN

id
STRING

Reference:

model
OBJECT

Click to expand model
content_favorites (table), model (attribute)

query_timezone
STRING

readonly
BOOLEAN

refresh_interval
STRING

refresh_interval_to_i
INTEGER

space
OBJECT

Click to expand space

child_count
INTEGER

content_metadata_id
STRING

Reference:

creator_id
STRING

Reference:

external_id
STRING

id
STRING

Reference:

is_embed
BOOLEAN

is_embed_shared_root
BOOLEAN

is_embed_users_root
BOOLEAN

is_personal
BOOLEAN

is_personal_descendant
BOOLEAN

is_shared_root
BOOLEAN

is_users_root
BOOLEAN

name
STRING

parent_id
STRING

Reference:

content_favorites (table), space (attribute)

title
STRING

user_id
STRING

Reference:

content_favorites (table), dashboard (attribute)

dashboard_id
STRING

Reference:

look
OBJECT

Click to expand look

content_metadata_id
STRING

Reference:

id
STRING

Reference:

title
STRING

content_favorites (table), look (attribute)

look_id
STRING

Reference:

user_id
STRING

Reference:

content_metadata

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Get all content metadatas

The content_metadata table contains information about content metadata in your Looker instance.

content_metadata table schema

id
STRING

The content metadata ID.

Reference:

content_type
STRING

dashboard_id
STRING

Reference:

folder_id
STRING

Reference:

inheriting_id
STRING

inherits
BOOLEAN

look_id
STRING

Reference:

name
STRING

parent_id
STRING

Reference:

slug
STRING

space_id
STRING

Reference:

content_metadata_access

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Get all content metadata accesses

The content_metadata_access table contains information about content metadata access records in your Looker instance.

content_metadata_access table schema

id
STRING

The access record ID.

content_metadata_id
STRING

Reference:

group_id
STRING

Reference:

permission_type
STRING

user_id
STRING

Reference:

content_views

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Search users

The content_views table contains info about user content views recorded in your Looker instance.

content_views table schema

id
STRING

The content view ID.

content_metadata_id
STRING

Reference:

dashboard_id
STRING

Reference:

favorite_count
INTEGER

group_id
STRING

Reference:

last_viewed_at
STRING

look_id
STRING

Reference:

start_of_week_date
STRING

user_id
STRING

Reference:

view_count
INTEGER

dashboards

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Get all dashboards

The dashboards table contains information about all active dashboards in your Looker account.

dashboards table schema

id
STRING

The dashboard ID.

Reference:

content_favorite_id
STRING

Reference:

content_metadata_id
STRING

Reference:

description
STRING

folder
OBJECT

Click to expand folder

child_count
INTEGER

content_metadata_id
STRING

Reference:

creator_id
STRING

Reference:

external_id
STRING

id
STRING

Reference:

is_embed
BOOLEAN

is_embed_shared_root
BOOLEAN

is_embed_users_root
BOOLEAN

is_personal
BOOLEAN

is_personal_descendant
BOOLEAN

is_shared_root
BOOLEAN

is_users_root
BOOLEAN

name
STRING

parent_id
STRING

Reference:

dashboards (table), folder (attribute)

hidden
BOOLEAN

model
OBJECT

query_timezone
STRING

readonly
BOOLEAN

refresh_interval
STRING

refresh_interval_to_i
INTEGER

space
OBJECT

Click to expand space

child_count
INTEGER

content_metadata_id
STRING

Reference:

creator_id
STRING

Reference:

external_id
STRING

id
STRING

Reference:

is_embed
BOOLEAN

is_embed_shared_root
BOOLEAN

is_embed_users_root
BOOLEAN

is_personal
BOOLEAN

is_personal_descendant
BOOLEAN

is_shared_root
BOOLEAN

is_users_root
BOOLEAN

name
STRING

parent_id
STRING

Reference:

dashboards (table), space (attribute)

title
STRING

user_id
STRING

Reference:

dashboard_elements

View table schema on GitHub
Replication Method :

Full Table

 Primary Key :

id
API endpoint :

Get all dashboard elements

The dashboard_elements table contains information about all dashboard elements in your Looker instance.

dashboard_elements table schema

id
STRING

The dashboard element ID.

Reference:

alert_count
INTEGER

body_text
STRING

body_text_as_html
STRING

dashboard_id
STRING

Reference:

edit_uri
STRING

look
OBJECT

Click to expand look

content_favorite_id
STRING

Reference:

content_metadata_id
STRING

Reference:

created_at
DATE-TIME

deleted
BOOLEAN

deleted_at
DATE-TIME

deleter_id
STRING

Reference:

description
STRING

embed_url
STRING

excel_file_url
STRING

favorite_count
INTEGER

folder
OBJECT

Click to expand folder

child_count
INTEGER

content_metadata_id
STRING

Reference:

creator_id
STRING

Reference:

external_id
STRING

id
STRING

Reference:

is_embed
BOOLEAN

is_embed_shared_root
BOOLEAN

is_embed_users_root
BOOLEAN

is_personal
BOOLEAN

is_personal_descendant
BOOLEAN

is_shared_root
BOOLEAN

is_users_root
BOOLEAN

name
STRING

parent_id
STRING

Reference:

dashboard_elements (table), folder (attribute)

folder_id
STRING

Reference:

google_spreadsheet_formula
STRING

id
STRING

Reference:

image_embed_url
STRING

is_run_on_load
BOOLEAN

last_accessed_at
DATE-TIME

last_updater_id
STRING

Reference:

last_viewed_at
DATE-TIME

model
OBJECT

public
BOOLEAN

public_slug
STRING

public_url
STRING

query
OBJECT

Click to expand query

client_id
STRING

column_limit
STRING

dynamic_fields
STRING

expanded_share_url
STRING

fields
ARRAY

Click to expand fields

value
STRING

dashboard_elements (table), fields (attribute)

fill_fields
ARRAY

Click to expand fill_fields

value
STRING

dashboard_elements (table), fill_fields (attribute)

filter_config
OBJECT

filter_expression
STRING

filters
OBJECT

has_table_calculations
BOOLEAN

id
STRING

Reference:

limit
STRING

model
STRING

pivots
ARRAY

Click to expand pivots

value
STRING

dashboard_elements (table), pivots (attribute)

query_timezone
STRING

row_total
STRING

runtime
NUMBER

share_url
STRING

slug
STRING

sorts
ARRAY