Stay organized with collections Save and categorize content based on your preferences.
Introduction to table clonesThis document gives an overview of table clones in BigQuery. It is intended for users who are familiar with BigQuery and BigQuery tables.
A table clone is a lightweight, writable copy of another table (called the base table). You are only charged for storage of data in the table clone that differs from the base table, so initially there is no storage cost for a table clone. Other than the billing model for storage, and some additional metadata for the base table, a table clone is similar to a standard table—you can query it, make a copy of it, delete it, and so on.
Common use cases for table clones include the following:
After you create a table clone, it is independent of the base table. Any changes made to the base table or table clone aren't reflected in the other.
If you need read-only, lightweight copies of your tables, consider using table snapshots.
A table clone has the same metadata as a standard table, plus the following:
For more information, see INFORMATION_SCHEMA.TABLES.
Table clone operationsIn general, you use table clones in the same way as you use standard tables, including the following operations:
However, the creation of a table clone is different from the creation of a standard table. For more information, see Create table clones.
Storage costsStorage costs apply for table clones, but BigQuery only charges for the data in a table clone that is not already charged to another table:
When a table clone is created, there is initially no storage cost for the table clone.
If data is added or changed in a table clone, then you are charged for the storage of the added or updated data.
If data is deleted in a table clone, then you are not charged for the storage of the deleted data.
If data is changed or deleted in the base table that also exists in a table clone, then you are charged for the table clone storage of the changed or deleted data. If there are multiple clones that contain the changed or deleted data, you are only charged for the storage used by the oldest clone.
If data is added to the base table after the table clone was created, then you aren't charged for storage of that data in the table clone, but you are charged for it in the base table,
The difference between base table and table clone storage charges is shown in the following image:
Note:For more information, see BigQuery storage pricing.
Limitations--append_table=true
and --clone=true
in the same bq cp
command. To append data when duplicating a table, use a copy operation instead.Table clones are subject to the same quotas and limits as standard tables. For more information, see table quotas and limits. They also have table clone limits that apply.
What's nextExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["Table clones are writable, lightweight copies of a base table, incurring storage costs only for data that differs from the base table."],["Common uses for table clones include creating development/testing environments and sandboxes for user analytics without duplicating all production data."],["Table clones are independent of their base tables, meaning changes to one are not reflected in the other."],["Table clones have similar functionality to standard tables, allowing for querying, access control, and deletion, among other operations."],["Storage costs for table clones are incurred when data is added, updated, or if data is changed or deleted in the base table that also exist in the clone."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4