Skip to main content
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

You’ll receive dataset ID, name, creation date, last modified date, location, and basic metadata. This helps you understand the structure and organization of your BigQuery project.
No, you’ll only see datasets that your connected Google account has permission to view. Hidden or restricted datasets won’t appear in the results.
No, this node only lists existing datasets. You’ll need to create datasets through the BigQuery console or other BigQuery management tools.
For active projects, weekly or monthly dataset inventory can help with organization. For stable projects, quarterly reviews are usually sufficient.
You can increase the limit parameter up to 1000, or run multiple queries with different filters. Consider if you really need all datasets for your specific use case.
Regular dataset listing helps track data growth, identify unused datasets, and maintain organized data architecture. Export results to spreadsheets for governance documentation.
I