Troubleshooting and FAQs: Tableau (PAT version, CLI-only)

Resolving "Invalid Personal Access Token (401001)" Error

If you encounter a "The personal access token you provided is invalid (401001)" error when connecting to Tableau, you can resolve this by updating your token. Follow this guide for detailed steps: Troubleshooting Tableau Error 401001.

Enable Metadata API

You must enable Tableau's metadata API in order for this integration to work. Please see the Tableau docs here on how to enable. Once this endpoint is enabled, it may take anywhere from a day to a week to populate all of your data into the API store. For further questions on the metadata API and how Tableau creates its store, please reach out to your Tableau representative.

When trying to onboard, this means you will see errors like BACKFILL RUNNING or Still creating the Metadata API Store. Results from the query might be incomplete at this time until that process is complete. Please use the --skip-validation toggle to add this integration to Monte Carlo as Monte Carlo will attempt to collector your metadata every 12 hours, so once the backfill is finished, Monte Carlo will then automatically begin pulling in your data to make lineage:

Tableau Cloud Quarterly Server Maintenance

During Tableau's quarterly server upgrades, you may receive Monte Carlo validation emails with errors like BACKFILL RUNNING or Still creating the Metadata API Store. Results from the query might be incomplete at this time. This situation is temporary and once Tableau completes its server upgrade, Monte Carlo will resume normal collection operations within approximately 12 hours.

SSL Certificate Failure

If you are deploying your Tableau server with an SSL certificate, by default Monte Carlo will attempt to verify that. This can cause failures like unable to get local issuer certificate when trying to integrate to Monte Carlo.

To solve, please integrate Tableau to Monte Carlo using the API or CLI which will allow you bypass this verification:

1. Download and get set up with the CLI: Using the CLI
2. Run montecarlo integrations add-tableau making sure to include the --no-verify-ssl flag:

This should allow you to successfully onboard Tableau!

If you would prefer to use the API, you can also do so, please see here for the call details: addTableauAccount