COMMENT ON

  • Artikel

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

Mengatur komentar pada katalog, skema, tabel, 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 tabel.

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

Untuk mengatur komentar kolom tabel, gunakan ALTER TABLE.

Sintaks

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

Parameter

  • catalog_name

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

  • connection_name

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 13.3 LTS dan di atas centang ditandai ya Unity Catalog saja

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

  • schema_name

    Nama skema di mana komentar Anda muncul.

    Jika Anda menggunakan Katalog Unity, untuk menjalankan pernyataan ini, Anda harus menjadi pemilik skema.

  • table_name

    Nama tabel yang Anda komentari. Nama tidak boleh menyertakan spesifikasi temporal.

    Jika menggunakan Katalog Unity, untuk menjalankan pernyataan ini, Anda harus memiliki hak istimewa MODIFY di tabel.

  • share_name

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

    Nama berbagi tempat 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.

  • 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 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 PROVIDER my_volume IS 'Huge volume';