Introduction to repositories

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of theService Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see thelaunch stage descriptions.

Note: To provide feedback or ask questions that are related to this Previewfeature, contactbigquery-repositories-feedback@google.com.

This document helps you understand the concept of repositories inBigQuery. You can use repositories to perform version control onfiles you use in BigQuery. BigQuery uses Git to recordchanges and manage file versions.

Each BigQuery repository represents a Git repository. You canuse BigQuery's built-in Git capabilities, or you can connect toa third-party Git repository. Within each repository, you can create one or moreworkspaces to edit the code stored in therepository.

To view repositories, on the BigQuery page, in the left pane,clickExplorer,and then clickRepositories. Your repositories are displayed inalphabetical order in a new tab in the details pane.

Important: If you create an asset in a BigQuery repository—for example,a query, notebook (including a notebook with an Apache Spark job),BigQuery pipeline, or Dataform workflow—you cannotschedule it for execution in BigQuery repository. For scheduling andexecuting Dataform workflows, you need to useDataform repositories. For scheduling queries and notebooks,use BigQuery Studio. For more information, seeScheduling queries,Schedule notebooks, andSchedule pipelines.

Third-party repositories

You can connect a BigQuery repository toa third-party Git repository if you choose. In this case, the third-party repository storesthe repository code instead of BigQuery. BigQuery interacts with the third-partyrepository to allow you to edit and execute its contents in aBigQuery workspace. Depending on the type of repository youchoose, you can connect to a third-party repository by using SSH or HTTPS.

The following table lists supported Git providers and the connectionmethods that are available for their repositories:

Git providerConnection method
Microsoft Azure DevOps ServicesSSH
BitbucketSSH
GitHubSSH or HTTPS
GitLabSSH or HTTPS

For more information, seeConnect to a third-party repository.

Service account

All BigQuery repositories are connected to the defaultDataform service agent. This service account is derived from yourproject number in the following format:

service-YOUR_PROJECT_NUMBER@gcp-sa-dataform.iam.gserviceaccount.com

Locations

You can create repositories in allBigQuery Studio locations.

Quotas

Dataform quotas apply to use ofBigQuery repositories.

Pricing

You are not charged for creating, updating, or deleting a repository.

For more information on BigQuery pricing, seePricing.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.