Menambahkan komentar ke data dan aset AI

Artikel ini memperkenalkan komentar untuk data dan aset AI dan menjelaskan cara menambahkannya. Komentar dapat membantu Anda dan pengguna lain menemukan dan mengelola data dan aset AI yang Anda butuhkan.

Komentar menyediakan bidang metadata untuk menganotasi objek yang dapat diamankan. Anda dapat menambahkan komentar ke objek yang dapat diamankan di Unity Catalog, seperti katalog, skema, tabel, volume, model AI, dan banyak lagi. Anda juga dapat menambahkan komentar ke kolom tabel.

Setelah menambahkan komentar ke objek yang dapat diamankan, setiap pengguna dengan BROWSE hak istimewa dapat melihat komentar. Ini meningkatkan kemampuan penemuan data di seluruh katalog Anda.

Anda dapat menambahkan komentar secara manual, atau Anda dapat mengizinkan Databricks membuat komentar yang dihasilkan AI untuk Anda. Komentar yang dihasilkan AI (juga dikenal sebagai dokumentasi yang dihasilkan AI) tersedia untuk tabel dan kolom tabel. Lihat Menambahkan komentar yang dihasilkan AI ke objek Katalog Unity.

Saat Anda mengubah komentar untuk tabel Katalog Unity (atau tabel Delta Lake dalam metastore Hive versi lama), suatu operasi SET TBLPROPERTIES dalam riwayat tabel merekam kueri SQL yang digunakan untuk mendefinisikan komentar tabel.

Sebelum Anda mulai

Anda harus memenuhi persyaratan berikut untuk menambahkan atau mengedit komentar:

• Untuk menambahkan atau mengedit komentar pada katalog, skema, volume, model, berbagi, penerima, penyedia, kredensial penyimpanan, lokasi eksternal, atau koneksi, Anda harus menjadi pemilik objek atau memiliki hak istimewa MANAGE pada objek.
• Untuk menambahkan atau mengedit komentar pada tabel atau kolom, Anda harus menjadi pemilik atau memiliki hak istimewa berikut:
  • MODIFY dan SELECT di atas meja.
  • USE CATALOG dan USE SCHEMA pada katalog dan skema induk.
• Anda harus menggunakan gudang SQL atau komputasi lain yang mendukung Katalog Unity.
• Untuk menggunakan komentar yang dihasilkan AI, ruang kerja Anda harus diaktifkan untuk fitur bantuan AI. Lihat Menambahkan komentar yang dihasilkan AI ke objek Katalog Unity.

Menambahkan dan mengedit komentar

Anda dapat menambahkan komentar ke objek yang dapat diamankan atau mengeditnya menggunakan perintah SQL atau Catalog Explorer.

Eksplorer Katalog

Penting

Menyimpan komentar memicu perintah SQL ALTER, yang dapat mengganggu alur dan pekerjaan Azure Databricks.

1. Di bar samping ruang kerja, klik Katalog untuk membuka Catalog Explorer.

2. Cari dan pilih objek yang ingin Anda komentari.

   Objek data dan AI dicantumkan dan dapat dicari di panel Katalog . Berbagi, kredensial penyimpanan, lokasi eksternal, dan koneksi dapat diakses menggunakan menu yang terbuka saat Anda mengklik ikon gerigi.

3. Tambahkan komentar atau edit komentar yang sudah ada.

   • Untuk menambahkan komentar ke tabel menggunakan komentar yang dihasilkan AI, lihat Komentar yang Disarankan AI di panel kanan tab Gambaran Umum. Mungkin perlu beberapa detik untuk muncul. Terima apa adanya atau Edit dan simpan.
   • Untuk menambahkan komentar ke kolom tabel menggunakan komentar yang dihasilkan AI, klik tombol buat AI di atas daftar kolom. Databricks menghasilkan komentar untuk setiap kolom. Terima apa adanya atau edit. Klik tanda centang untuk menyimpan komentar.
   • Untuk menambahkan komentar ke objek yang tidak mendukung komentar yang dihasilkan AI, klik Tambahkan komentar untuk menambahkan komentar.
   • Untuk menambahkan komentar ke kolom tabel tanpa menggunakan komentar yang dihasilkan AI, klik ikon Tambahkan komentar di baris kolom.
   • Jika komentar sudah ada, komentar tersebut muncul di panel kanan pada tab Gambaran Umum atau di bawah nama objek. Jika tidak dihasilkan AI, klik ikon edit untuk mengeditnya.

Anda dapat menggunakan Markdown dasar untuk menata komentar di UI Penjelajah Katalog. Pengaturan markdown tidak ditampilkan saat dikembalikan oleh pernyataan DESCRIBE. Semua sintaks dasar didukung di Catalog Explorer, kecuali gambar. Untuk informasi selengkapnya, lihat Sintaks Dasar.

Untuk informasi selengkapnya tentang komentar yang dihasilkan AI, lihat Menambahkan komentar yang dihasilkan AI ke objek Katalog Unity.

SQL

Anda dapat menggunakan perintah SQL untuk menambahkan string harfiah sebagai komentar ke objek yang dapat diamankan di Katalog Unity dan ke tabel yang dikelola di metastore Apache Hive warisan. Perintah SQL yang Anda gunakan bergantung pada objek yang ingin Anda tambahkan atau edit komentarnya:

• Untuk menambahkan atau memperbarui komentar pada objek yang ada dan dapat diamankan, kecuali kolom tabel, gunakan perintah COMMENT ON. Lihat COMMENT ON.

  Anda juga dapat menggunakan COMMENT opsi dengan ALTER <object> perintah untuk objek (misalnya, ALTER TABLE). Lihat artikel referensi SQL untuk perintah .ALTER <object>

• Untuk menambahkan atau memperbarui komentar kolom untuk tabel yang sudah ada, gunakan ALTER TABLE perintah dengan ALTER COLUMN klausa dan COMMENT opsi pada kolom. Lihat ALTER TABLE dan ALTER TABLE ... COLUMN klausa.

• Untuk menambahkan komentar saat Anda membuat objek, gunakan COMMENT opsi dengan CREATE <object> perintah . Lihat artikel referensi SQL untuk CREATE <object> perintah yang ingin Anda gunakan.