Actions51
- Authentication Actions
- Data Source Actions
- Flow Actions
- Group Actions
- Metadata API Actions
- Project Actions
- User Actions
- View Actions
- VizQL Data Service Actions
- Workbook Actions
VizQL Data Service → Query Datasource
AI-generatedSummary
Execute a VizQL query against a specified Tableau datasource to retrieve data based on defined fields and filters.
Inputs
- Authentication (required) — Choose authentication method: Connected App (JWT) or Personal Access Token.
- Impersonate User — Optionally authenticate as a different Tableau user (requires site admin privileges, available only with Connected App authentication).
- Datasource ID (required) — The LUID identifying the Tableau datasource to query.
- Query (required) — The JSON object specifying fields, filters, and parameters for the query. Usually generated by the "Build Query" operation or passed from its output.
- Options — A collection of optional flags to control querying behavior including bypassing metadata cache, disaggregating measures to return row-level data, formatting the return rows as objects or arrays, and limiting the number of returned rows.
- Connections — Optional list of connection credentials for live datasources with multiple connections, specifying connection LUID, username, and password.
Output shape
a list of rows containing the query results, formatted as objects (default) or arrays according to the Return Format option.
Output shape depends on the 'Return Format' option: rows can be keyed objects or arrays of values. The row limit option restricts output size but does not impact query performance. Impersonation requires appropriate permissions. Errors can be handled based on node retry and error continue settings.