What's New

🕐 3 min read

VizQL Data Service 2025.2

June 2025

This release has two enhancements: multiple credentials support and updates to the schema.

Support for multiple credentials

The VizQL Data Service now supports multiple credentials. For more information, see Data sources that require multiple credentials.

Schema update

We updated the OpenAPI schema. The most significant change is that the Request data source metadata method now returns defaultAggregation. For more information, see the API documentation and the OpenAPI schema.

VizQL Data Service 2025.1

February 2025

This is the initial public release of the VizQL Data Service (VDS). VDS provides a way for you to access your data outside of a Tableau visualization (viz).

With a viz, you perform operations like dragging a pill to rows or columns. This achieves two things: It fetches data from the data source, and it creates a visualization of that data. VDS allows you to perform a fetch of the data without the need for any visualization.

Changes from the earlier release

There are substantial changes from the previous developer preview release. If you used the developer preview release, note these changes:

• We now refer to fields instead of columns. For more information, see the VDS API Documentation.
• Our authentication process has changed to use the Tableau REST API methods. For more information, see Configuration
• We now accept the data source LUID instead of the data source name, and have changed the syntax for specifying database credentials. For more information, see Connect to your data source.
• Quantitative filters used to handle both numbers and dates. This has been broken out into QuantitativeNumericalFilter and QuantitativeDateFilter, which are specific to their types.
• The Filter object has changed. Now each ‘Filter requires a FilterField.
• By default, a Filter excludes null values. Use an includeNulls field with a quantitative filter.
• We removed the SPECIAL filter type, and now a quantitative filter has new options of ONLY_NULL, and ONLY_NON_NULL, which you can use to filter appropriately.
• We updated the RelativeDateFilter. The LASTN NEXTN are used with rangeN to specify relative ranges. The other date range types are shortcuts. For more information, see the Relative date filters.
• We added a new MatchFilter type to do string matching.
• Some function have new and improved names.

VizQL Data Service Developer Preview

October 2024

In this developer preview release, we added the API Access permission capability. To query a data source with the VizQL Data Service, you must assign this capability in the Permission dialog. For more information, see Assign API access capability in Configuration.

We also moved theVizQL Data Service Postman collection from its location in the Tableau pre-release site to its new GitHub repository.

June 2024

This is the initial developer preview release of the VizQL Data Service. This is a closed release, only available to a small number of developers.

This release introduces the initial set of API methods and endpoints for using the VizQL Data Service.