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

Stitch

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

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.

id
STRING

The color collection ID.

Reference:

categoricalPalettes
ARRAY

colors
ARRAY

value
STRING

color_collections (table), colors (attribute)

id
STRING

label
STRING

type
STRING

color_collections (table), categoricalPalettes (attribute)

divergingPalettes
ARRAY

id
STRING

label
STRING

stops
ARRAY

color
STRING

offset
NUMBER

color_collections (table), stops (attribute)

type
STRING

color_collections (table), divergingPalettes (attribute)

label
STRING

sequentialPalettes
ARRAY

id
STRING

label
STRING

stops
ARRAY

color
STRING

offset
NUMBER

color_collections (table), stops (attribute)

type
STRING

color_collections (table), sequentialPalettes (attribute)

Replication Method :

Full Table

Primary Key :

name

API endpoint :

Get all connections

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

name
STRING

The name of the connection.

after_connect_statements
STRING

certificate
STRING

created_at
STRING

database
STRING

db_timezone
STRING

dialect
OBJECT

automatically_run_sql_runner_snippets
BOOLEAN

connection_tests
ARRAY

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

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

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

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

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.

id
STRING

The content favorite ID.

Reference:

content_metadata_id
STRING

Reference:

dashboard
OBJECT

content_favorite_id
STRING

Reference:

content_metadata_id
STRING

Reference:

description
STRING

folder
OBJECT

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

query_timezone
STRING

readonly
BOOLEAN

refresh_interval
STRING

refresh_interval_to_i
INTEGER

space
OBJECT

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

content_metadata_id
STRING

Reference:

id
STRING

Reference:

title
STRING

content_favorites (table), look (attribute)

look_id
STRING

Reference:

user_id
STRING

Reference:


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.

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

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.

id
STRING

The access record ID.

content_metadata_id
STRING

Reference:

group_id
STRING

Reference:

permission_type
STRING

user_id
STRING

Reference:


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.

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


dashboard_elements

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.

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

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

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

client_id
STRING

column_limit
STRING

dynamic_fields
STRING

expanded_share_url
STRING

fields
ARRAY

value
STRING

dashboard_elements (table), fields (attribute)

fill_fields
ARRAY

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

value
STRING

dashboard_elements (table), pivots (attribute)

query_timezone
STRING

row_total
STRING

runtime
NUMBER

share_url
STRING

slug
STRING

sorts
ARRAY

value
ANYTHING

dashboard_elements (table), sorts (attribute)

subtotals
ARRAY

value
STRING

dashboard_elements (table), subtotals (attribute)

total
BOOLEAN

url
STRING

view
STRING

vis_config
OBJECT

visible_ui_sections
STRING

dashboard_elements (table), query (attribute)

query_id
STRING

Reference:

short_url
STRING

space
OBJECT

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), space (attribute)

space_id
STRING

Reference:

title
STRING

updated_at
DATE-TIME

url
STRING

user
OBJECT

user_id
STRING

Reference:

view_count
INTEGER

dashboard_elements (table), look (attribute)

look_id
STRING

Reference:

lookml_link_id
STRING

merge_result_id
STRING

note_display
STRING

note_state
STRING

note_text
STRING

note_text_as_html
STRING

query
OBJECT

client_id
STRING

column_limit
STRING

dynamic_fields
STRING

expanded_share_url
STRING

fields
ARRAY

value
STRING

dashboard_elements (table), fields (attribute)

fill_fields
ARRAY

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

value
STRING

dashboard_elements (table), pivots (attribute)

query_timezone
STRING

row_total
STRING

runtime
NUMBER

share_url
STRING

slug
STRING

sorts
ARRAY

value
ANYTHING

dashboard_elements (table), sorts (attribute)

subtotals
ARRAY

value
STRING

dashboard_elements (table), subtotals (attribute)

total
BOOLEAN

url
STRING

view
STRING

vis_config
OBJECT

visible_ui_sections
STRING

dashboard_elements (table), query (attribute)

query_id
STRING

Reference:

refresh_interval
STRING

refresh_interval_to_i
INTEGER

result_maker
OBJECT