MEMBUAT KLON TABEL

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Klon 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 Mengkloning parquet dan tabel Iceberg secara bertahap 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 Kloning dangkal untuk tabel Unity Catalog.

Penting

Ada perbedaan penting antara klon dangkal dan dalam yang dapat menentukan cara terbaik untuk menggunakannya. Harap lihat Mengkloning tabel pada Azure Databricks.

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 diganti jika ada dan baru dibuat jika tidak. Tanpa CREATE OR sebuah table_name harus ada.

  • table_name

    Nama meja Delta Lake yang akan dibuat. Nama tidak boleh menyertakan spesifikasi temporal. 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 mengacu pada file tabel sumber. Saat Anda menentukan DEEP CLONE (default) Azure Databricks akan membuat salinan lengkap dan independen dari tabel sumber.

  • source_table_name

    Nama tabel Delta Lake yang akan dikloning. Nama tidak boleh menyertakan spesifikasi sementara.

  • 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 itu sendiri adalah jalur bukan pengenal 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. Harap lihat Mengkloning tabel pada Azure Databricks.