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. ZonderCREATE OR
detable_name
moet bestaan.-
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, tenzijREPLACE
ofIF 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 opgeeftDEEP CLONE
, wordt er een volledige, onafhankelijke kopie van de brontabel gemaakt.-
De naam van de Delta Lake-tabel die moet worden gekloond. De naam kan een tijdelijke specificatie bevatten.
-
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.