Skip to main content
Prizm connects to Tableau Server and Tableau Cloud to discover workbooks, datasources, and views, then maps field-level lineage back to the underlying source tables in your connected data warehouses.
Tableau connector setup form — server type, site name, authentication fields, and project scope

Prerequisites

  • Tableau Server 2019.1+ or Tableau Cloud (formerly Tableau Online).
  • A Tableau user account with Site Administrator Explorer role or higher (required to access the Tableau Metadata API).
  • Tableau Metadata API must be enabled on the Tableau Server instance (enabled by default on Tableau Cloud).

Connection Fields

FieldDescription
Connection NameA display name for this Tableau integration in Prizm (e.g., tableau-prod).
Server TypeSelect Tableau Server (self-hosted) or Tableau Cloud.
Server URLThe base URL of your Tableau Server (e.g., https://tableau.yourcompany.com). For Tableau Cloud, use https://prod-useast-a.online.tableau.com.
Site NameThe Tableau site to connect to. Leave blank for the Default site on Tableau Server.
Authentication TypeChoose Username & Password or Personal Access Token (PAT). PAT is recommended for production.
UsernameTableau account username. Required for Username & Password auth.
PasswordTableau account password. Required for Username & Password auth.
Token NamePAT name as shown in Tableau. Required for Personal Access Token auth.
Token SecretPAT secret generated in Tableau. Required for Personal Access Token auth.

Authentication

Auth MethodWhen to Use
Username & PasswordSuitable for testing or environments where PATs are not available. Password changes require updating the connector.
Personal Access Token (PAT)Recommended for production. PATs are scoped and revocable without affecting the user’s password. Generate under My Account Settings → Personal Access Tokens in Tableau.
Personal Access Tokens expire after 15 days of inactivity by default on Tableau Server. Configure a longer expiry or ensure the Prizm sync job runs at least once every 15 days to keep the token active.

Asset Scope

After a successful connection, Prizm discovers the following Tableau assets:
Asset TypeWhat Prizm Captures
WorkbooksName, owner, project path, last modified date, and embedded views.
Published DatasourcesName, connection type, embedded credentials flag, and upstream database connections.
Views / SheetsView name, workbook parent, and field-level usage.
FieldsCalculated fields and direct-column references mapped to source table columns.
Use Project Include/Exclude patterns to limit the scope to specific Tableau projects.

Lineage Mapping

Prizm uses the Tableau Metadata API (GraphQL) to extract upstreamTables and upstreamDatabases for each published datasource and workbook. These are matched against tables already profiled by Prizm connectors (Snowflake, BigQuery, etc.) to build cross-system lineage edges:
Tableau View → Published Datasource → Warehouse Table (Snowflake / BigQuery / etc.)
Lineage is only created for upstream tables that exist in a Prizm-connected data source. Tableau datasources backed by extracts (.hyper files) show lineage to the last known live source at the time the extract was created.

Job Schedules

Job TypeDefault FrequencyWhat It Does
Catalog SyncDailyDiscovers workbooks, datasources, views, and updates metadata in the Prizm catalog.
Lineage RebuildDailyRe-maps field-level lineage from Tableau assets to upstream warehouse tables.

What’s next

Snowflake Connector

Connect the Snowflake warehouse that your Tableau datasources query.

Lineage

Understand how Prizm combines Tableau field lineage with warehouse query lineage.

Catalog

See how Tableau assets appear alongside data warehouse tables in the Prizm catalog.

Data Quality

Learn how quality issues in source tables surface as risks to downstream Tableau reports.
Prizm connects to Tableau Server and Tableau Cloud to discover workbooks, datasources, and views, then maps field-level lineage back to the underlying source tables in your connected data warehouses.
Tableau connector setup form — server type, site name, authentication fields, and project scope

Prerequisites

  • Tableau Server 2019.1+ or Tableau Cloud (formerly Tableau Online).
  • A Tableau user account with Site Administrator Explorer role or higher (required to access the Tableau Metadata API).
  • Tableau Metadata API must be enabled on the Tableau Server instance (enabled by default on Tableau Cloud).

Connection Fields

FieldDescription
Connection NameA display name for this Tableau integration in Prizm (e.g., tableau-prod).
Server TypeSelect Tableau Server (self-hosted) or Tableau Cloud.
Server URLThe base URL of your Tableau Server (e.g., https://tableau.yourcompany.com). For Tableau Cloud, use https://prod-useast-a.online.tableau.com.
Site NameThe Tableau site to connect to. Leave blank for the Default site on Tableau Server.
Authentication TypeChoose Username & Password or Personal Access Token (PAT). PAT is recommended for production.
UsernameTableau account username. Required for Username & Password auth.
PasswordTableau account password. Required for Username & Password auth.
Token NamePAT name as shown in Tableau. Required for Personal Access Token auth.
Token SecretPAT secret generated in Tableau. Required for Personal Access Token auth.

Authentication

Auth MethodWhen to Use
Username & PasswordSuitable for testing or environments where PATs are not available. Password changes require updating the connector.
Personal Access Token (PAT)Recommended for production. PATs are scoped and revocable without affecting the user’s password. Generate under My Account Settings → Personal Access Tokens in Tableau.
Personal Access Tokens expire after 15 days of inactivity by default on Tableau Server. Configure a longer expiry or ensure the Prizm sync job runs at least once every 15 days to keep the token active.

Asset Scope

After a successful connection, Prizm discovers the following Tableau assets:
Asset TypeWhat Prizm Captures
WorkbooksName, owner, project path, last modified date, and embedded views.
Published DatasourcesName, connection type, embedded credentials flag, and upstream database connections.
Views / SheetsView name, workbook parent, and field-level usage.
FieldsCalculated fields and direct-column references mapped to source table columns.
Use Project Include/Exclude patterns to limit the scope to specific Tableau projects.

Lineage Mapping

Prizm uses the Tableau Metadata API (GraphQL) to extract upstreamTables and upstreamDatabases for each published datasource and workbook. These are matched against tables already profiled by Prizm connectors (Snowflake, BigQuery, etc.) to build cross-system lineage edges:
Tableau View → Published Datasource → Warehouse Table (Snowflake / BigQuery / etc.)
Lineage is only created for upstream tables that exist in a Prizm-connected data source. Tableau datasources backed by extracts (.hyper files) show lineage to the last known live source at the time the extract was created.

Job Schedules

Job TypeDefault FrequencyWhat It Does
Catalog SyncDailyDiscovers workbooks, datasources, views, and updates metadata in the Prizm catalog.
Lineage RebuildDailyRe-maps field-level lineage from Tableau assets to upstream warehouse tables.

What’s next

Snowflake Connector

Connect the Snowflake warehouse that your Tableau datasources query.

Lineage

Understand how Prizm combines Tableau field lineage with warehouse query lineage.

Catalog

See how Tableau assets appear alongside data warehouse tables in the Prizm catalog.

Data Quality

Learn how quality issues in source tables surface as risks to downstream Tableau reports.