> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trydatawise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tableau

Connect Datawise to Tableau to surface Tableau workbooks as downstream assets in your lineage graph. When a schema change is detected, Datawise shows which Tableau workbooks are at risk.

## Prerequisites

* Tableau Server or Tableau Cloud with a user that has **Site Administrator Explorer** role or higher.
* A Tableau personal access token (PAT). Recommended over username/password for stability.
* The host URL for your Tableau Server or Tableau Cloud site.

## Create a Personal Access Token

1. Click your profile icon and go to **My Account Settings**.
2. Under **Personal Access Tokens**, click **Create new token**.
3. Give it a name (e.g., `datawise-token`) and click **Create**.
4. Copy the token name and token value. Both are required. The value is only shown once.

## Connection Setup

Go to **Connectors**, click **Add Connector**, and select Tableau.

### Required Fields

| Field       | Description                                                                                      |
| ----------- | ------------------------------------------------------------------------------------------------ |
| Host URL    | Base URL of your Tableau instance. Example: `https://10ay.online.tableau.com` for Tableau Cloud. |
| Token Name  | The name of the personal access token you created.                                               |
| Token Value | The token value. Treat this like a password.                                                     |
| Name        | A display name for this connector in Datawise.                                                   |

### Optional Fields

| Field        | Description                                                                        |
| ------------ | ---------------------------------------------------------------------------------- |
| Projects     | Restrict ingestion to specific Tableau projects. Leave empty for all.              |
| Tableau Site | If your server has multiple sites, specify the site name. Leave blank for default. |
| Username     | Fallback username if PAT is not available. Not recommended for production.         |
| Password     | Used with Username above.                                                          |

### Settings

| Setting                   | Default | Description                                                       |
| ------------------------- | ------- | ----------------------------------------------------------------- |
| Ingest Tags               | Off     | Pull Tableau workbook and view tags into Datawise asset metadata. |
| Ingest Owner              | Off     | Pull workbook owner information into Datawise.                    |
| Enable Stateful Ingestion | Off     | Process only new or changed assets on subsequent runs.            |

## After Connecting

* Tableau workbooks and views appear in **Data Assets** as downstream assets.
* The **Lineage** view shows Tableau workbooks connected to the dbt models and warehouse tables they depend on.
* When Schema Radar detects a breaking schema change, impacted Tableau workbooks appear in the downstream impact view.