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.

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 tabel.

Saat Anda mengubah komentar untuk tabel Katalog Unity (atau tabel Delta Lake di metastore Apache Hive warisan), SET TBLPROPERTIES operasi dalam riwayat tabel merekam kueri SQL yang digunakan untuk menentukan 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.
• 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 Unity Catalog (komputasi bersama atau pengguna tunggal).
• Untuk menggunakan komentar yang dihasilkan AI, ruang kerja Anda harus diaktifkan untuk fitur bantuan AI. Lihat Menambahkan komentar yang dihasilkan AI ke tabel.

Menambahkan dan mengedit komentar

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

Penjelajah Katalog

1. Di bilah sisi ruang kerja, klik Katalog untuk membuka Penjelajah Katalog.

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. Gaya markdown tidak dirender saat dikembalikan oleh DESCRIBE pernyataan. Semua sintaks dasar didukung di Catalog Explorer kecuali gambar, dan hanya dua tingkat judul yang dirender. Untuk informasi selengkapnya, lihat Sintaks Dasar.

Untuk informasi selengkapnya tentang komentar yang dihasilkan AI, lihat Menambahkan komentar yang dihasilkan AI ke tabel.

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 untuk objek yang dapat diamankan yang ada kecuali kolom tabel, gunakan COMMENT ON perintah . Lihat KOMENTAR DI.

  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 ... Klausa COLUMN.

• 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.