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 provider | Connection method |
|---|---|
| Microsoft Azure DevOps Services | SSH |
| Bitbucket | SSH |
| GitHub | SSH or HTTPS |
| GitLab | SSH 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.comLocations
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
- Learn how tocreate repositories.
- Learn how tocreate workspaces.
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.