Introduction to repositories and workspaces
BigQuery repositories and workspaces let you apply Git version control to code assets such as SQL queries, Python notebooks, data canvases, and data preparations. Version control helps you track file changes over time, collaborate with your team without overwriting shared work, and revert to earlier commits when needed. You store your shared codebase in a built-in or connected third-party Git repository. You then use individual workspaces to edit files, commit changes, and push or pull updates across branches.
For a folder-based version control experience, we recommend using BigQuery Studio Git repositories. This integration lets you work with Git branches directly in the BigQuery Studio file browser and clone multiple repositories at once without managing separate workspaces.
Repositories
BigQuery repositories function as Git repositories that provide version control for the files you use within BigQuery. You can use the built-in Git capabilities of BigQuery or connect to an existing third-party Git repository. Within each repository, you create workspaces to edit the code stored there.
For more information about creating and managing repositories, see Create and manage repositories.
Workspaces
Workspaces in BigQuery let you edit and manage code stored in repositories. Within a workspace, you can create and modify files while the parent repository uses Git to record changes and manage file versions.
For more information about creating and managing workspaces, see Create and manage workspaces.
Locations
You can create repositories in all BigQuery Studio locations. Each workspace within a repository uses the same location as the repository.
Quotas
Dataform quotas apply to use of BigQuery workspaces and repositories.
Pricing
You are not charged for creating, updating, or deleting a repository or a workspace, or for storage of the files in a workspace.
For more information about BigQuery pricing, see Pricing.
What's next
- To learn how to manage code with BigQuery Studio Git repositories, see Manage code with BigQuery Studio Git repositories.
- To learn how to create and use repositories, see Create and manage repositories.
- To learn how to create and use workspaces, see Create and manage workspaces.