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