CREATE TABLE CLONE

Berlaku untuk: Databricks SQL Databricks Runtime

Mengkloning tabel Delta sumber ke tujuan target pada versi tertentu. Klon bisa dalam atau dangkal: klon dalam menyalin data dari sumber dan klon dangkal tidak. Anda juga dapat mengkloning tabel Parquet dan Iceberg sumber. Lihat Kloning bertahap tabel Parquet dan Iceberg ke Delta Lake.

Di Databricks SQL dan Databricks Runtime 13.3 LTS ke atas, Anda dapat menggunakan kloning dangkal dengan tabel terkelola Unity Catalog. Dalam Databricks Runtime 12.2 LTS dan di bawahnya, tidak ada dukungan untuk kloning dangkal di Unity Catalog. Lihat klon Shallow untuk tabel Unity Catalog.

Sintaks

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]

Parameter

• IF NOT EXISTS

  Jika ditentukan, pernyataan diabaikan jika table_name sudah ada.

• [CREATE OR] REPLACE

  Jika CREATE OR ditentukan, tabel akan diganti jika ada dan baru dibuat jika tidak. Tanpa CREATE OR sebuah table_name harus ada.

• table_name

  Nama tabel Delta Lake yang akan dibuat. Nama tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi. Jika nama tidak memenuhi syarat, tabel dibuat dalam skema saat ini. table_name tidak harus ada kecuali REPLACE atau IF NOT EXISTS telah ditentukan.

• KLON DANGKAL atau KLON DALAM

  Jika Anda menentukan SHALLOW CLONE, Azure Databricks akan membuat salinan definisi tabel sumber, tetapi merujuk pada file tabel sumber. Saat Anda menentukan DEEP CLONE (default) Azure Databricks akan membuat salinan tabel sumber yang lengkap dan independen.

• source_table_name

  Nama tabel Delta Lake yang akan dikloning. Nama dapat mencakup spesifikasi temporal atau spesifiasi opsi.

• TBLPROPERTIES

  Secara opsional mengatur satu atau beberapa properti yang ditentukan pengguna.

• Jalur LOKASI

  Secara opsional membuat tabel eksternal, dengan lokasi yang disediakan sebagai jalur tempat data disimpan. Jika table_name sendiri jalur alih-alih pengidentifikasi tabel, operasi akan gagal. path harus berupa STRING literal.

Contoh

Anda dapat menggunakan CREATE TABLE CLONE untuk operasi kompleks seperti migrasi data, pengarsipan data, reproduksi aliran pembelajaran mesin, eksperimen jangka pendek, dan berbagi data. Lihat Mengkloning tabel di Azure Databricks.