bigquery-execute-sql

About

A bigquery-execute-sql tool executes a SQL statement against BigQuery.

bigquery-execute-sql accepts the following parameters:

• sql (required): The GoogleSQL statement to execute.
• dry_run (optional): If set to true, the query is validated but not run, returning information about the execution instead. Defaults to false.

The behavior of this tool is influenced by the combination of the readOnly and writeMode settings on its bigquery source:

Note: Conflicting configurations, such as readOnly: true combined with writeMode: allowed, are rejected during server startup.

The tool’s behavior is influenced by the allowedDatasets restriction on the bigquery source. Similar to writeMode, this setting provides an additional layer of security by controlling which datasets can be accessed:

• Without allowedDatasets restriction: The tool can execute any valid GoogleSQL query.
• With allowedDatasets restriction: Before execution, the tool performs a dry run to analyze the query. It will reject the query if it attempts to access any table outside the allowed datasets list. To enforce this restriction, the following operations are also disallowed:
  • Dataset-level operations (e.g., CREATE SCHEMA, ALTER SCHEMA).
  • Unanalyzable operations where the accessed tables cannot be determined statically (e.g., EXECUTE IMMEDIATE, CREATE PROCEDURE, CALL).

Note: This tool is intended for developer assistant workflows with human-in-the-loop and shouldn’t be used for production agents.

Compatible Sources

Example

kind: tool
name: execute_sql_tool
type: bigquery-execute-sql
source: my-bigquery-source
description: Use this tool to execute sql statement.

Reference