CREATE TABLE CLONE

Berlaku untuk: Databricks SQL Databricks Runtime

Menggandakan sumber Delta, Apache Iceberg terkelola, atau tabel Apache Parquet ke lokasi target pada versi yang spesifik. Kloning dapat dalam atau dangkal: klon mendalam menyalin data, sementara kloning dangkal mereferensikan data sumber tanpa menyalinnya.

• Tabel Delta, Parquet, dan Foreign Iceberg mendukung kloning yang dalam dan dangkal.
• Tabel Iceberg terkelola hanya mendukung kloning mendalam, dan Anda tidak dapat mengubah format tabel selama kloning.

Untuk informasi selengkapnya, lihat Mengkloning tabel Parquet dan Apache 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 klon Shallow untuk tabel Unity Catalog.

Penting

Ada perbedaan penting antara klon dangkal dan dalam yang dapat menentukan cara terbaik untuk menggunakannya. Lihat Mengkloning tabel di 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

• JIKA TIDAK ADA

  Jika ditentukan, pernyataan diabaikan jika table_name sudah ada.

• [BUAT ATAU] MENGGANTI

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

• table_name

  Nama tabel 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 lihat file tabel sumber. Saat Anda menentukan DEEP CLONE (default) Azure Databricks akan membuat salinan tabel sumber yang lengkap dan independen.

  Tabel Iceberg terkelola hanya mendukung kloning mendalam, bukan kloning dangkal.

• source_table_name

  Nama tabel yang akan dikloning. Nama ini dapat mencakup spesifikasi temporal atau spesifikasi 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 itu sendiri adalah 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.