Klonování spravované tabulky Iceberg

Můžete vytvořit úplnou nezávislou kopii spravované tabulky Iceberg pomocí DEEP CLONE. Hluboký klon zkopíruje datové soubory i metadata tabulky do nové spravované tabulky Iceberg v Unity Catalog.

Spravované tabulky Iceberg podporují pouze hloubkové klonování. Mělké klonování a převod formátu během klonování nejsou podporovány.

Metody klonování pro tabulky Iceberg

Operace klonování, kterou použijete, závisí na typech zdrojové a cílové tabulky:

Zdroj	Target	Operation
Spravovaný iceberg	Spravovaný iceberg	DEEP CLONE.
Cizí ledovec	Spravovaný iceberg	DEEP CLONE. Viz Naklonovat cizí tabulku Iceberg do spravovaného Icebergu.
Parquet nebo externí Iceberg	Spravované nebo externí Delta Lake	Přírůstkový klon. Viz přírůstkové klonování tabulek Parquet a Apache Iceberg do Delta Lake.

Pokud chcete vytvořit spravovanou tabulku Iceberg z výsledků dotazu místo klonování existující tabulky, použijte CREATE TABLE ... AS SELECT. Viz CREATE TABLE [POUŽITÍ].

SHALLOW CLONE nepodporuje tabulky Iceberg. Viz Omezení.

Requirements

Pokud chcete naklonovat spravovanou tabulku Iceberg, potřebujete:

• Databricks Runtime 16.4 LTS nebo vyšší
• SELECT oprávnění k zdrojové tabulce.
• Při nahrazení existující tabulky oprávnění CREATE TABLE pro cílové schéma nebo oprávnění MODIFY pro cílovou tabulku.
• V cílovém katalogu nebo schématu je povolená prediktivní optimalizace.

Hluboké klonování spravované tabulky Iceberg

Slouží CREATE TABLE ... DEEP CLONE ke kopírování spravované tabulky Iceberg:

CREATE TABLE <catalog>.<schema>.<target-table>
DEEP CLONE <catalog>.<schema>.<source-table>;

Nahrazení existující cílové tabulky:

CREATE OR REPLACE TABLE <catalog>.<schema>.<target-table>
DEEP CLONE <catalog>.<schema>.<source-table>;

Vytvořit cíl pouze v případě, že ještě neexistuje:

CREATE TABLE IF NOT EXISTS <catalog>.<schema>.<target-table>
DEEP CLONE <catalog>.<schema>.<source-table>;

Úplnou syntaxi CREATE TABLE CLONE najdete v CREATE TABLE CLONE.

Archivace produkční tabulky

Vytvoření nezávislého snímku produkční tabulky pro účely archivace nebo dodržování předpisů:

CREATE TABLE prod_catalog.archive.orders_snapshot_may2026
DEEP CLONE prod_catalog.main.orders;

Kopírování tabulky do vývojového prostředí

Klonování produkční tabulky do vývojového katalogu pro bezpečné experimentování bez ovlivnění produkčních dat:

CREATE OR REPLACE TABLE dev_catalog.test.orders
DEEP CLONE prod_catalog.main.orders;

Klonovat cizí tabulku Iceberg na spravovanou tabulku Iceberg

K migraci cizí tabulky Iceberg do katalogu Unity můžete použít DEEP CLONE jako spravovanou tabulku Iceberg. Klon zkopíruje všechna data a metadata do úložiště katalogu Unity. Původní soubory spravované externím katalogem se znovu nepoužívají.

CREATE TABLE <uc-catalog>.<schema>.<target-table>
DEEP CLONE <foreign-catalog>.<schema>.<source-table>;

Po dokončení klonování je cílová tabulka plně spravovaná tabulka Iceberg v Unity Catalog, nezávislá na zdrojovém katalogu.

Note

Migrace bez kopírování z cizího katalogu není podporována. Viz Omezení.

Nastavení vlastností tabulky v hlubokém klonování

V příkazu DEEP CLONE nelze nastavit vlastnosti tabulky Iceberg. Pokud chcete přidat nebo přepsat vlastnosti naklonované tabulky, použijte ALTER TABLE SET TBLPROPERTIES po dokončení klonování.

Pokud například chcete nastavit vlastní vlastnosti pro zaznamenání zdroje klonu použitého jako snímek:

CREATE TABLE prod_catalog.archive.orders_snapshot
DEEP CLONE prod_catalog.main.orders;

ALTER TABLE prod_catalog.archive.orders_snapshot
SET TBLPROPERTIES (
  'archive.source' = 'prod_catalog.main.orders',
  'archive.created_date' = '2026-05-11'
);

Chování při klonování

Důležité informace o fungování hlubokého klonování:

• Hluboký klon je úplná, nezávislá kopie zdrojové tabulky. Změny klonu nemají vliv na zdroj a změny ve zdroji nemají vliv na klon.
• Hluboký klon má nezávislou historii snapshotů. Časová cesta na klonu používá historii klonu, ne historii zdroje.
• Schéma, informace o dělení a vlastnosti tabulky se zkopírují do hloubkového klonu. Značky katalogu Unity se nekopírují.
• Po vytvoření Unity Catalog spravuje klon nezávisle pomocí prediktivní optimalizace.

omezení

• U spravovaných tabulek Icebergu se nepodporuje klonování v mělkém prostředí.
• Unity Catalog nepodporuje převod cizích tabulek Iceberg na spravované tabulky Iceberg bez kopírování. Musíte použít DEEP CLONE. Všechna data se během operace klonování zkopírují do úložiště katalogu Unity.
• Hluboké klony nekopírují historii tabulek, což ovlivňuje dotazy využívající cestování v čase.
• Během klonování nemůžete změnit formát tabulky. Cílem je vždy spravovaná tabulka Iceberg.
• Během klonování nelze nastavit vlastnosti tabulky. Použijte ALTER TABLE SET TBLPROPERTIES, až bude operace deep clone dokončena. Viz Nastavení vlastností tabulky u hloubkového klonu.