List Datasets returns all datasets within a specific Google BigQuery project. Use this to explore your BigQuery structure, find available datasets, or dynamically select datasets for other operations.


When to Use It

  • Explore and inventory your BigQuery project structure
  • Find available datasets before building data workflows
  • Use it as AI Tool for AI Agents to understand your data organization

Inputs

FieldTypeRequiredDescription
ProjectSelectYesGoogle BigQuery project to list datasets from
LimitNumberNoMaximum number of datasets to return (1-1000)

Outputs

OutputDescription
Datasets ListList of all datasets with names, IDs, and metadata

Credit Cost

1 credit per operation.


Real-World Example

BigQuery AI Agent:

AI Agent → List Datasets → List Tables → Run Query
"Allow AI to discover all available datasets and then run SQL queries"

Understanding Dataset Information

The returned data includes:

Dataset Metadata:

  • Dataset ID and name
  • Creation time and last modified date
  • Location (region) information
  • Access permissions and settings

Useful for:

  • Understanding data organization
  • Planning data architecture
  • Identifying unused or outdated datasets
  • Managing data governance and compliance

FAQ