Dela via


CREATE TABLE CLONE

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Klonar en deltakälla table till ett målmål i en viss version. En klon kan vara antingen djup eller ytlig: djupa kloner kopierar över data från källan och grunda kloner gör det inte. Du kan också klona källan Parquet och Iceberg tables. Se Stegvis klona Parquet och Iceberg tables till Delta Lake.

I Databricks SQL och Databricks Runtime 13.3 LTS och senare kan du använda ytlig klon med Unity Catalog hanterad tables. I Databricks Runtime 12.2 LTS och nedan finns det inget stöd för grunda kloner i Unity Catalog. Se Shallow-klon för Unity Catalogtables.

Viktigt!

Det finns viktiga skillnader mellan grunda och djupa kloner som kan avgöra hur de bäst ska användas. Se klona en table på Azure Databricks.

Syntax

CREATE TABLE [IF NOT EXISTS] table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]
[CREATE OR] REPLACE TABLE table_name
   [SHALLOW | DEEP] CLONE source_table_name [TBLPROPERTIES clause] [LOCATION path]

Parameters

  • OM INTE FINNS

    Om det anges ignoreras -instruktionen om table_name den redan finns.

  • [SKAPA ELLER] ERSÄTTA

    Om CREATE OR anges ersätts table om den finns och nyligen har skapats om den inte gör det. CREATE OR Utan table_name måste finnas.

  • table_name

    Namnet på Delta Lake table som ska skapas. Namnet får inte innehålla en temporal specifikation eller alternativspecifikation. Om namnet inte är specificerat skapas table i den aktuella schema. table_name får inte redan finnas om inte REPLACE eller IF NOT EXISTS har angetts.

  • GRUNT KLON ELLERDJUPKLONING

    Om du anger SHALLOW CLONE kommer Azure Databricks att göra en kopia av källdefinitionen table, men hänvisa till källan table:s filer. När du anger DEEP CLONE (standard) gör Azure Databricks en fullständig, oberoende kopia av källan table.

  • source_table_name

    Namnet på Delta Lake table klonas. Namnet kan innehålla en temporal specifikation eller alternativspecifikation.

  • TBLPROPERTIES

    Du kan också ange en eller flera användardefinierade egenskaper.

  • PLATSsökväg

    Skapar valfritt en extern tablemed den angivna platsen som sökväg där where data lagras. Om table_name är en sökväg istället för en tableidentifier, misslyckas operationen. path måste vara en STRING-literal.

Exempel

Du kan använda CREATE TABLE CLONE för komplexa åtgärder som datamigrering, dataarkivering, reproduktion av maskininlärningsflöden, kortsiktiga experiment och datadelning. Se Klona en table på Azure Databricks.