🕐 5 min read
October 2025
In this release, VizQL Data Service (VDS) has the following enhancements:
View updated metadata: The Request data source metadata method now returns groups, bins, and parameters. You can also see the column class and calculation formulas. For more information, see the Example output section in Request Data Source Metadata.
Query existing bins: You can now query bins and view the result. For more information, see the Parameters with bins example in Query a Data Source.
Override existing parameters: You can now override the values currently persisted on the published data source. For more information, see the Calculated field with a parameter example in Query a Data Source.
Query new bins on the fly: You can now create a new bin that does not already exist on the published data source. For more information, see the Create a new bin section in Creating Queries.
Query using fieldName instead of fieldCaption: VDS now supports passing the fieldName in its methods. This allows renamed fields to be resolved correctly, preventing query failures. For more information, see the interpretFieldCaptionsAsFieldNames option in either the Request data source metadata, Request data source model or Query data source methods.
Expose type for all fields and formulas for calculations: VDS now returns the current read metadata return value for a field to include parameters for columnClass, and formula. For more information, see the Request data source metadata response section in Request Data Source Metadata.
Query table calculations: VDS supports everything you see in the quick table calculations, as well as custom table calculations and nested table calculations. For more information, see the Table Calculations section.
See the data source model: You can now see the logical table and relationship metadata in a published data source. For more information, see Get Data Source Model.
June 2025
This release has three enhancements: multiple credentials support, updates to the schema, and a Python client library.
The VizQL Data Service now supports multiple credentials. For more information, see Data sources that require multiple credentials.
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.
The VizQL Data Service Python SDK is a lightweight client library that enables interaction with Tableau’s VizQL Data Service APIs. It supports both Tableau Cloud and Tableau Server deployments and offers both synchronous and asynchronous methods for querying the APIs. For more information, see the VizQL Data Service Python SDK GitHub repo.
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.
There are substantial changes from the previous developer preview release. If you used the developer preview release, note these changes:
QuantitativeNumericalFilter and QuantitativeDateFilter, which are specific to their types.Filter object has changed. Now each ‘Filter requires a FilterField.Filter excludes null values. Use an includeNulls field with a quantitative filter.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.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.MatchFilter type to do string matching.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.