doc(ingestion/tableau): doc update for derived permission (#11054)

Co-authored-by: Pedro Silva <[email protected]> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Harshal Sheth <[email protected]>
datahub-project · Aug 1, 2024 · d5eda0d · d5eda0d
1 parent 2369032
commit d5eda0d
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 0 deletions.
diff --git a/docs/quick-ingestion-guides/tableau/setup.md b/docs/quick-ingestion-guides/tableau/setup.md
@@ -51,6 +51,14 @@ In order to configure ingestion from Tableau, you'll first have to enable Tablea
    - Open a command prompt as an admin on the initial node (*where TSM is installed*) in the cluster
    - Run the command: `tsm maintenance metadata-services enable`
 
+3. **Enable Derived Permissions:** This step is required only when the site is using external assets. For more detail, refer to the tableau documentation [Manage Permissions for External Assets](https://help.tableau.com/current/online/en-us/dm_perms_assets.htm).
+
+   Follow the below steps to enable the derived permissions:
+
+   -  Sign in to Tableau Cloud or Tableau Server as an admin.
+   -  From the left navigation pane, click Settings.
+   -  On the General tab, under Automatic Access to Metadata about Databases and Tables, select the `Automatically grant authorized users access to metadata about databases and tables` check box.
+
 
 ## Next Steps
 

diff --git a/metadata-ingestion/docs/sources/tableau/tableau_pre.md b/metadata-ingestion/docs/sources/tableau/tableau_pre.md
@@ -81,3 +81,12 @@ This may happen when the Tableau API returns NODE_LIMIT_EXCEEDED error in respon
 
 - reducing the page size using the `page_size` config param in datahub recipe (Defaults to 10).
 - increasing tableau configuration [metadata query node limit](https://help.tableau.com/current/server/en-us/cli_configuration-set_tsm.htm#metadata_nodelimit) to higher value.
+
+### `PERMISSIONS_MODE_SWITCHED` error in ingestion report 
+This error occurs if the Tableau site is using external assets. For more detail, refer to the Tableau documentation [Manage Permissions for External Assets](https://help.tableau.com/current/online/en-us/dm_perms_assets.htm).
+
+Follow the below steps to enable the derived permissions:
+
+1.  Sign in to Tableau Cloud or Tableau Server as an admin.
+2.  From the left navigation pane, click Settings.
+3.  On the General tab, under Automatic Access to Metadata about Databases and Tables, select the `Automatically grant authorized users access to metadata about databases and tables` check box.