CREATE TABLE CLONE

Van toepassing op: Databricks SQL Databricks Runtime

Kloont een Delta-brontabel naar een doelbestemming op een specifieke versie. Een kloon kan diep of ondiep zijn: diepe klonen kopiëren over de gegevens uit de bron en ondiepe klonen niet. U kunt ook de Parquet- en Iceberg-brontabellen klonen. Zie Parquet- en Iceberg-tabellen incrementeel klonen naar Delta Lake.

In Databricks SQL en Databricks Runtime 13.3 LTS en hoger kunt u ondiepe kloon gebruiken met beheerde tabellen van Unity Catalog. In Databricks Runtime 12.2 LTS en hieronder is er geen ondersteuning voor ondiepe klonen in Unity Catalog. Zie Ondiepe kopie voor Unity Catalog-tabellen.

Belangrijk

Er zijn belangrijke verschillen tussen ondiepe en diepe klonen die kunnen bepalen hoe u ze het beste kunt gebruiken. Zie Een tabel klonen in Azure Databricks.

Syntaxis

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

• ALS DEZE NIET BESTAAT

  Indien opgegeven, wordt de instructie genegeerd als table_name deze al bestaat.

• [CREATE OR] VERVANGEN

  Als CREATE OR is opgegeven, wordt de tabel vervangen als deze bestaat en nieuw is gemaakt als dat niet het geval is. Zonder CREATE OR de table_name moet bestaan.

• table_name

  De naam van de Delta Lake-tabel die moet worden gemaakt. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten. Als de naam niet is gekwalificeerd, wordt de tabel gemaakt in het huidige schema. table_name mag niet al bestaan, tenzij REPLACE of IF NOT EXISTS is opgegeven.

• ONDIEPE KLOON of DIEPE KLOON

  Als u SHALLOW CLONE in Azure Databricks opgeeft, zal Azure Databricks een kopie van de definitie van de brontabel maken, maar bestanden van de brontabel raadplegen. Wanneer u DEEP CLONE (standaard) specificeert, maakt Azure Databricks een volledige, onafhankelijke kopie van de brontabel.

• source_table_name

  De naam van de Delta Lake-tabel die moet worden gekloond. De naam kan een tijdelijke specificatie of een aanduiding voor opties bevatten.

• TBLPROPERTIES

  U kunt desgewenst een of meer door de gebruiker gedefinieerde eigenschappen instellen.

• LOCATIEpad

  U kunt eventueel een externe tabel maken, met de opgegeven locatie als het pad waar de gegevens worden opgeslagen. Als table_name zelf een pad is in plaats van een tabelidentifier, zal de bewerking mislukken. path moet een letterlijke tekenreeks zijn.

Voorbeelden

U kunt gebruiken CREATE TABLE CLONE voor complexe bewerkingen, zoals gegevensmigratie, gegevensarchivering, reproductie van machine learning-stromen, experimenten op korte termijn en het delen van gegevens. Zie Een tabel klonen in Azure Databricks.