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 Incrementeel Parquet- en Iceberg-tabellen 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 kloon 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 de tabel is opgegeven, wordt deze vervangen als deze bestaat en zojuist 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 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 Azure Databricks opgeeft SHALLOW CLONE , maakt u een kopie van de definitie van de brontabel, maar raadpleegt u de bestanden van de brontabel. Wanneer u (standaard) Azure Databricks opgeeft DEEP CLONE , wordt er een volledige, onafhankelijke kopie van de brontabel gemaakt.

• source_table_name

  De naam van de Delta Lake-tabel die moet worden gekloond. De naam kan een tijdelijke specificatie 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 zichzelf een pad in plaats van een tabel-id is, mislukt de bewerking. 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.