Properti tabel dan opsi tabel

  • Artikel

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

Mendefinisikan tag yang ditentukan pengguna untuk tabel dan tampilan.

  • properti tabel

    Properti tabel adalah pasangan nilai kunci yang dapat Anda inisialisasi saat Anda melakukan BUAT TABEL atau BUAT TAMPILAN. Anda dapat MEMBATALKAN SET properti tabel yang sudah ada atau MENGATUR properti tabel baru atau yang sudah ada menggunakan ALTER TABLE atau ALTER VIEW.

    Anda dapat menggunakan properti tabel untuk menandai tabel dengan informasi yang tidak dilacak oleh SQL.

  • opsi tabel

    Tujuan dari opsi tabel adalah untuk meneruskan properti penyimpanan ke penyimpanan yang mendasarinya, seperti properti SERDE ke Apache Hive.

    Opsi tabel adalah pasangan nilai kunci yang dapat Anda inisialisasi saat Anda melakukan BUAT TABEL. Anda tidak dapat SET atau UNSET opsi tabel.

TBLPROPERTIES

Mengatur satu atau beberapa properti tabel dalam tabel atau tampilan baru.

Anda dapat menggunakan properti tabel untuk menandai tabel dengan informasi yang tidak dilacak oleh SQL.

Sintaks

TBLPROPERTIES ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Parameter

  • property_key

    Kunci properti. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau literal string.

    Kunci properti harus unik dan peka huruf besar/kecil.

  • property_val

    Nilai untuk properti. Nilainya harus berupa BOOLEAN, , STRINGINTEGER, atau DECIMAL harfiah.

Contoh

-- Create table with user defined table properties
> CREATE TABLE T(c1 INT) TBLPROPERTIES('this.is.my.key' = 12, this.is.my.key2 = true);
> SHOW TBLPROPERTIES T;
option.serialization.format     1
this.is.my.key  12
this.is.my.key2 true
transient_lastDdlTime   1649783569

ATUR TBLPROPERTIES

Mengatur satu atau beberapa properti tabel dalam tabel atau tampilan yang sudah ada.

Sintaks

SET TBLPROPERTIES ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Parameter

  • property_key

    Kunci properti. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau literal string.

    Kunci properti harus unik dan peka huruf besar/kecil.

  • property_val

    Nilai baru untuk properti. Nilainya harus berupa BOOLEAN, , STRINGINTEGER, atau DECIMAL harfiah.

Contoh

-- Alter the a table's table properties.
>  ALTER TABLE T SET TBLPROPERTIES(this.is.my.key = 14, 'this.is.my.key2' = false);
> SHOW TBLPROPERTIES T;
option.serialization.format     1
this.is.my.key  14
this.is.my.key2 false
transient_lastDdlTime   1649783980

HAPUS PENGATURAN TBLPROPERTIES

Menghapus satu atau beberapa properti tabel dari tabel atau tampilan.

Sintaks

UNSET TBLPROPERTIES [ IF EXISTS ] ( property_key [, ...] )

property_key
  { identifier [. ...] | string_literal }

Parameter

  • JIKA ADA

    Klausa opsional yang mengarahkan Databricks SQL untuk tidak memunculkan kesalahan jika salah satu kunci properti tidak ada.

  • property_key

    Kunci properti yang akan dihapus. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau literal string.

    Kunci properti peka huruf besar/kecil. Jika property_key tidak ada dan kesalahan muncul kecuali IF EXISTS telah ditentukan.

Contoh

-- Remove a table's table properties.
>  ALTER TABLE T UNSET TBLPROPERTIES(this.is.my.key, 'this.is.my.key2');
> SHOW TBLPROPERTIES T;
option.serialization.format     1
transient_lastDdlTime   1649784415

OPSI

Mengatur satu atau beberapa opsi tabel di tabel baru.

Tujuan dari opsi tabel adalah untuk meneruskan properti penyimpanan ke penyimpanan yang mendasarinya, seperti properti SERDE ke Apache Hive.

Menentukan opsi tabel untuk tabel Delta Lake juga akan menggemakan opsi ini sebagai properti tabel.

Sintaks

OPTIONS ( { property_key [ = ] property_val } [, ...] )

property_key
  { identifier [. ...] | string_literal }

Parameter

  • property_key

    Kunci properti. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau literal string.

    Kunci properti harus unik dan peka huruf besar/kecil.

  • property_val

    Nilai untuk properti. Nilainya harus berupa BOOLEAN, , STRINGINTEGER, atau DECIMAL harfiah.

    Dalam Databricks SQL dan Databricks Runtime 13.3 LTS ke atas property_val dapat menjadi ekspresi konstan.

Contoh

-- Create table with user defined table option
-- The options appears with an `option.` prefix.
> CREATE TABLE T(c1 INT) OPTIONS(this.is.my.key = 'blue' || 'green');
> SHOW TBLPROPERTIES T;
option.this.is.my.key bluegreen
option.serialization.format     2

Kunci properti tabel yang dipesan

Azure Databricks mencadangkan beberapa kunci properti untuk penggunaannya sendiri dan menimbulkan kesalahan jika Anda mencoba menggunakannya:

  • external

    Gunakan BUAT TABEL EKSTERNAL untuk membuat tabel eksternal.

  • location

    Gunakan LOCATION klausul ALTER TABLE dan CREATE TABLE untuk mengatur lokasi tabel.

  • owner

    Gunakan klausul [SET] OWNER TO dari ALTER TABLE dan ALTER VIEW untuk mentransfer kepemilikan tabel atau tampilan. SET diizinkan sebagai kata kunci opsional di Databricks SQL.

  • provider

    Gunakan klausul USING dari BUAT TABEL untuk mengatur sumber data tabel

Anda tidak boleh menggunakan kunci properti yang dimulai dengan pengidentifikasi option. Pengidentifikasi awalan ini akan difilter di TAMPILKAN TBLPROPERTIES. Awalan option juga digunakan untuk menampilkan opsi tabel.

Kunci TBLPROPERTIES dan OPTIONS umum

Pengaturan berikut biasanya digunakan dengan Delta Lake:

  • delta.appendOnly: Atur ke true untuk menonaktifkan operasi UPDATE dan DELETE.
  • delta.dataSkippingNumIndexedCols: Atur ke jumlah kolom jarak antar baris yang akan dikumpulkan dan dipertimbangkan statistiknya.
  • delta.deletedFileRetentionDuration: Atur ke interval seperti 'interval 7 days' untuk mengontrol kapan VACUUM diizinkan untuk menghapus file.
  • delta.logRetentionDuration: Atur ke interval seperti 'interval 60 days' untuk mengontrol berapa lama riwayat disimpan untuk kueri perjalanan waktu.