Requirements


Note: This is the developer preview release of the VizQL Data Service. This release is intended to offer developers early access to unreleased features.

🕐 2 min read

Permissions

For a user to query a data source with VizQL Data Service, you must first assign the API Access capability in the Permission dialog. For information about setting up this data source capability in Tableau Cloud, see Permission Capabilities and Templates. For information about setting up this data source capability in Tableau Server, see Permission Capabilities and Templates.

Authentication

Authentication on Tableau works using a personal access token (PAT) or a JSON web token (JWT). Before you begin using the VizQL Data Service, do one of the following.

Create a personal access token

A personal access token (PAT) lets you create long-lived authentication tokens. Using a PAT, you can sign in to the VizQL Data Service without hard-coded credentials (username and password) or interactive sign-in. For detailed information about this task, see Create a personal access token.

Create a connected app

A connected app can be used to securely authenticate (SSO) you to Tableau content embedded in a custom application. A connected app enables you to establish a trusted relationship between Tableau and any custom application by using JWTs. For detailed information about this task, see Create a connected app.

Special Notes:

Postman

If you plan to use Postman with VizQL Data Service and you’re using a Mac, we recommend that you download the Postman Desktop agent. This prevents you from getting the following error:

Error: could not send request