docs(ingest/tableau): tweak permissions docs (#12460)

This commit is contained in:
Harshal Sheth 2025-01-27 08:55:23 -08:00 committed by GitHub
parent 0c98cdce2e
commit 1ca95cc2ab
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -12,16 +12,15 @@ DataHub supports two authentication methods:
1. Username/Password
2. [Personal Access Token](https://help.tableau.com/current/pro/desktop/en-us/useracct.htm#create-and-revoke-personal-access-tokens)
Either way, the user/token must have the **Site Administrator Explorer** site role.
Either way, the user/token must have at least the **Site Administrator Explorer** site role.
:::info
We need the **Site Administrator Explorer** site role in order to get complete metadata from Tableau.
We need at least the **Site Administrator Explorer** site role in order to get complete metadata from Tableau. Roles with higher privileges, like **Site Administrator Creator** or **Server Admin** also work.
With any lower role, the Tableau Metadata API returns missing/partial metadata.
This particularly affects data source fields and definitions, which impacts our ability to extract most columns and generate column lineage. Some table-level lineage is also impacted.
Other site roles, including Site Administrator Creator and Viewer, are insufficient due to these limitations in the current Tableau Metadata API.
Other site roles, like Viewer or Explorer, are insufficient due to these limitations in the current Tableau Metadata API.
:::