KLON (SQL Analytics)

Důležité

Tato funkce je ve verzi Public Preview.

Naklonuje zdrojovou rozdílovou tabulku do cílového cíle v konkrétní verzi. Klon může být buď hluboko, nebo bez něj: hluboká klonování kopíruje data ze zdrojového a neomezeného klonu.

Důležité

Existují důležité rozdíly mezi neomezenými a hlubokými klony, které určují, jak jsou nejvhodnější. Viz klonování rozdílové tabulky.

Syntax

CREATE TABLE [IF NOT EXISTS] target_table_identifier
[SHALLOW | DEEP] CLONE source_table_identifier [<time_travel_version>]
[LOCATION 'path']
[CREATE OR] REPLACE TABLE target_table_identifier
[SHALLOW | DEEP] CLONE source_table_identifier [<time_travel_version>]
[LOCATION 'path']
  • table_identifier
    • [database_name.] table_name: Název tabulky, volitelně kvalifikovaný s názvem databáze.
    • delta.`<path-to-table>`: Umístění existující rozdílové tabulky.

kde:

<time_travel_version>  =
  TIMESTAMP AS OF timestamp_expression |
  VERSION AS OF version
  • Tuto hodnotu zadejte CREATE IF NOT EXISTS , chcete-li se vyhnout vytváření tabulky target_table , pokud tabulka již existuje. Pokud tabulka již v cíli existuje, operace klonování je no-op.
  • Zadejte CREATE OR REPLACE , chcete-li nahradit cíl operace klonování, pokud existuje tabulka target_table . Tím se aktualizuje metastore s novou tabulkou, pokud se použije název tabulky.
  • Pokud nezadáte SHALLOW nebo DEEP , ve výchozím nastavení se vytvoří hluboká klonování.
  • LOCATION vytvoří externí tabulku se zadaným umístěním jako cestu, kde jsou data uložená. Pokud je cílem místo názvu tabulky cesta, operace se nezdaří.

Příklady

Můžete použít CLONE pro komplexní operace, jako je migrace dat, archivace dat, reprodukce toků strojového učení, krátkodobé experimenty, sdílení dat atd. Několik příkladů najdete v části případy použití klonování .