🕐 5 min read
February 2026
In this release, VizQL Data Service (VDS) has the following enhancements:
Result streaming: VDS now streams back the results from a query request immediately, improving performance and lifting the previous 1-GB response size limit. For more information, see Results handling and error checking.
Server sent events (SSE): Use the new optional returnServerSentEvents boolean field to stream results back using the standard server-sent event (SSE) protocol. See Server sent event support.
Row limits: You can now specify a rowLimit within the options object to restrict the number of rows returned in a query.
Enhanced sorting: The sorting algorithm now aligns with Tableau’s native sort, enabling more human-readable results for string-based numbers.
New metadata fields: The Request data source metadata method now returns the following information:
Group formulas: If the data includes groups (that is, categorical bins), you can view what the groupings are when you specify the includeGroupFormulas option in the request.
Aliases: You can now see aliases for domain values of parameters and dimensions.
Field types and roles: The read-metadata response now includes the fieldType of each column, which can be NOMINAL, ORDINAL, or CONTINUOUS. NOMINAL and ORDINAL are subtypes of DISCRETE. The response also includes fieldRole of each column, which can be either MEASURE or DIMENSION.
Hidden fields: You can now show hidden fields using the includeHiddenFields option in the request.
Decimal formatting: The response now shows the number of decimal spaces set in the Number Format dialog box. The decimal formatting supports the following default number formats: Number(Custom), Currency(Custom), Scientific, Percentage, and Custom.
Field descriptions: Field descriptions now included in the metadata response. The field description is what appears under the Lineage tab, if you have Tableau Catalog. Tableau Catalog is available with Tableau Enterprise and Tableau+ licenses.
Image role: If a field has been assigned an image role (the field contains URLs that point to web images), this is shown in the metadata response.
LOD indicator The response now indicates when a calculation contains a level of detail (LOD) expression.
Groups in queries: You can now query groups directly within both calculations and filters.
Logical table references: Calculations now accept logical table names (for example, COUNT([Addresses])) directly. Note that the option interpretFieldCaptionsAsFieldNames still applies to logical tables, so when that option is set (true) the calculation, COUNT([Addresses_200CC1380B5240B4B6592656B323D414] is also valid and will return the same data.
Calculated fields: You can now reference calculated fields as dimensions in table calculations.
Expanded filter support: You can use aliases for members in a set and use those values as filters in a query ("filterType": "SET"). For more information, see Set filters.
List supported functions: You can use the List supported Tableau functions method to return the list of Tableau functions supported for the specified data source. These are the functions that can be used when you create calculated fields in Tableau. The method returns the name of the function, the number and types of arguments, and the return type.
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.