Bagikan melalui

COMMENT ON

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

Mengatur komentar pada katalog, skema, tabel, kolom, berbagi, penerima, penyedia, atau volume.

Catatan

Jika Anda ingin menambahkan komentar yang dihasilkan AI untuk kolom tabel atau tabel yang dikelola oleh Katalog Unity, lihat Menambahkan komentar yang dihasilkan AI ke objek Katalog Unity.

Katalog, berbagi, penerima, dan penyedia hanya didukung di Katalog Unity.

Sintaks

COMMENT ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      CONNECTION connection_name |
      PROVIDER provider_name |
      RECIPIENT recipient_name |
      { SCHEMA | DATABASE } schema_name |
      SHARE share_name |
      TABLE relation_name |
      VOLUME volume_name }
    IS comment

Parameter

  • catalog_name

    Nama katalog tempat komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik katalog atau memiliki hak istimewa MANAGE terhadapnya.

  • nama_relasi . nama_kolom

    Berlaku untuk: diberi tanda centang ya Databricks SQL diberi tanda centang ya Databricks Runtime 16.1 ke atas

    Nama lengkap kolom yang Anda komentari. relation_name harus mengidentifikasi tabel, tampilan, atau tampilan materialisasi. relation_name tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi.

    Jika Anda menggunakan Katalog Unity, untuk menjalankan pernyataan ini, Anda harus memiliki:

    • MODIFY hak istimewa tersedia di atas meja.
    • OWNER sebagai inti tampilan.

  • nama_koneksi

    Berlaku untuk:ditandai dengan tanda centang Databricks SQL ditandai dengan tanda centang Databricks Runtime 13.3 LTS ke atas dicentang Unity Catalog saja

    Nama koneksi tempat komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik koneksi atau memiliki hak istimewa MANAGE terhadapnya.

  • schema_name

    Nama skema tempat komentar Anda muncul.

    Jika Anda menggunakan Katalog Unity, untuk menjalankan pernyataan ini, Anda harus menjadi pemilik skema atau memiliki MANAGE hak istimewa di atasnya.

  • nama_relasi

    Nama tabel, atau tampilan, yang Anda komentari. Nama tabel tidak boleh menyertakan spesifikasi temporal atau spesifikasi opsi.

    Jika Anda menggunakan Katalog Unity, untuk menjalankan pernyataan ini, Anda harus memiliki:

    • MODIFY hak istimewa tersedia di atas meja.
    • OWNER sebagai inti tampilan.

  • share_name

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    Nama bagian di mana komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik berbagi.

  • recipient_name

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    Nama penerima tempat komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penerima.

  • provider_name

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    Nama penyedia tempat komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penyedia.

  • volume_name

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 13.3 LTS ke atas

    Nama volume tempat komentar Anda muncul. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik volume atau memiliki hak akses MANAGE pada volume tersebut.

  • komentar

    Harfiah STRING atau NULL. Jika Anda menentukan NULL komentar apa pun yang ada akan dihapus.

Contoh

> COMMENT ON CATALOG my_catalog IS 'This is my catalog';

> COMMENT ON COLUMN my_table.c1 IS 'This is my column';

> COMMENT ON CONNECTION mysql_connection IS 'this is a mysql connection';

> COMMENT ON SCHEMA my_schema IS 'This is my schema';

> COMMENT ON TABLE my_table IS 'This is my table';

> COMMENT ON TABLE my_table IS NULL;

> COMMENT ON SHARE my_share IS 'A good share';

> COMMENT ON RECIPIENT my_recipient IS 'A good recipient';

> COMMENT ON PROVIDER my_provider IS 'A good provider';

> COMMENT ON VOLUME my_volume IS 'Huge volume';
  • Last updated on