AACFlow

Google BigQuery

Query, list, and insert data in Google BigQuery

Usage Instructions

Connect to Google BigQuery to run SQL queries, list datasets and tables, get table metadata, and insert rows.

Tools

google_bigquery_query

Input

ParameterTypeRequiredDescription
projectIdstringYesNo description
querystringYesNo description
useLegacySqlbooleanNoNo description
maxResultsnumberNoNo description
defaultDatasetIdstringNoNo description
locationstringNoProcessing location (e.g., "US", "EU")

Output

ParameterTypeDescription
columnsarrayArray of column names from the query result
rowsarrayArray of row objects keyed by column name
totalRowsstringTotal number of rows in the complete result set
jobCompletebooleanWhether the query completed within the timeout
totalBytesProcessedstringTotal bytes processed by the query
cacheHitbooleanWhether the query result was served from cache
jobReferenceobjectJob reference (useful when jobComplete is false)
projectIdstringProject ID containing the job
jobIdstringUnique job identifier
locationstringGeographic location of the job
pageTokenstringToken for fetching additional result pages

google_bigquery_list_datasets

Input

ParameterTypeRequiredDescription
projectIdstringYesNo description
maxResultsnumberNoNo description
pageTokenstringNoNo description

Output

ParameterTypeDescription
datasetsarrayArray of dataset objects
datasetIdstringUnique dataset identifier
projectIdstringProject ID containing this dataset
friendlyNamestringDescriptive name for the dataset
locationstringGeographic location where the data resides
nextPageTokenstringToken for fetching next page of results

google_bigquery_list_tables

Input

ParameterTypeRequiredDescription
projectIdstringYesNo description
datasetIdstringYesNo description
maxResultsnumberNoNo description
pageTokenstringNoNo description

Output

ParameterTypeDescription
tablesarrayArray of table objects
tableIdstringTable identifier
datasetIdstringDataset ID containing this table
projectIdstringProject ID containing this table
typestringTable type (TABLE, VIEW, EXTERNAL, etc.)
friendlyNamestringUser-friendly name for the table
creationTimestringTime when created, in milliseconds since epoch
totalItemsnumberTotal number of tables in the dataset
nextPageTokenstringToken for fetching next page of results

google_bigquery_get_table

Input

ParameterTypeRequiredDescription
projectIdstringYesNo description
datasetIdstringYesNo description
tableIdstringYesNo description

Output

ParameterTypeDescription
tableIdstringTable ID
datasetIdstringDataset ID
projectIdstringProject ID
typestringTable type (TABLE, VIEW, SNAPSHOT, MATERIALIZED_VIEW, EXTERNAL)
descriptionstringTable description
numRowsstringTotal number of rows
numBytesstringTotal size in bytes, excluding data in streaming buffer
schemaarrayArray of column definitions
namestringColumn name
typestringData type (STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP, RECORD, etc.)
modestringColumn mode (NULLABLE, REQUIRED, or REPEATED)
descriptionstringColumn description
creationTimestringTable creation time (milliseconds since epoch)
lastModifiedTimestringLast modification time (milliseconds since epoch)
locationstringGeographic location where the table resides

google_bigquery_insert_rows

Input

ParameterTypeRequiredDescription
projectIdstringYesNo description
datasetIdstringYesNo description
tableIdstringYesNo description
rowsstringYesNo description
skipInvalidRowsbooleanNoNo description
ignoreUnknownValuesbooleanNoNo description

Output

ParameterTypeDescription
insertedRowsnumberNumber of rows successfully inserted
errorsarrayArray of per-row insertion errors (empty if all succeeded)
indexnumberZero-based index of the row that failed
errorsarrayError details for this row
reasonstringShort error code summarizing the error
locationstringWhere the error occurred
messagestringHuman-readable error description

On this page

Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started