Dodawanie komentarzy do danych i zasobów sztucznej inteligencji

W tym artykule przedstawiono komentarze dotyczące danych i zasobów sztucznej inteligencji oraz wyjaśniono, jak je dodać. Komentarze mogą ułatwić Tobie i innym użytkownikom znajdowanie potrzebnych danych i zasobów sztucznej inteligencji oraz zarządzanie nimi.

Komentarze udostępniają pole metadanych do dodawania adnotacji do zabezpieczanych obiektów. Komentarze można dodawać do dowolnego zabezpieczanego obiektu w wykazie aparatu Unity, takich jak wykazy, schematy, tabele, woluminy, modele sztucznej inteligencji i inne. Możesz również dodawać komentarze do kolumn tabeli.

Możesz dodać komentarze ręcznie lub zezwolić usłudze Databricks na tworzenie komentarzy generowanych przez sztuczną inteligencję. Komentarze generowane przez sztuczną inteligencję (znane również jako dokumentacja generowana przez sztuczną inteligencję) są dostępne dla tabel i kolumn tabel. Zobacz Dodawanie komentarzy generowanych przez sztuczną inteligencję do obiektów wykazu aparatu Unity.

Podczas modyfikowania komentarzy dla tabeli wykazu aparatu Unity (lub tabeli usługi Delta Lake w starszym magazynie metadanych Hive) SET TBLPROPERTIES operacja w historii tabeli rejestruje zapytanie SQL, które zostało użyte do zdefiniowania komentarza do tabeli.

Zanim rozpoczniesz

Aby dodać lub edytować komentarze, musisz spełnić następujące wymagania:

• Aby dodać lub edytować komentarze do katalogu, schematu, woluminu, modelu, udziału, adresata, dostawcy, poświadczeń magazynu, lokalizacji zewnętrznej lub połączenia, musisz być właścicielem obiektu.
• Aby dodać lub edytować komentarze do tabeli lub kolumny, musisz być właścicielem lub mieć następujące uprawnienia:
  • MODIFY i SELECT na stole.
  • USE CATALOG i USE SCHEMA w katalogu nadrzędnym i schemacie.
• Musisz użyć usługi SQL Warehouse lub innego środowiska obliczeniowego obsługującego wykaz aparatu Unity (współużytkowanego lub pojedynczego użytkownika obliczeniowego).
• Aby korzystać z komentarzy generowanych przez sztuczną inteligencję, obszar roboczy musi być włączony dla funkcji pomocniczych sztucznej inteligencji. Zobacz Dodawanie komentarzy generowanych przez sztuczną inteligencję do obiektów wykazu aparatu Unity.

Dodawanie i edytowanie komentarzy

Komentarze można dodawać do zabezpieczanych obiektów lub edytować za pomocą poleceń SQL lub Eksploratora wykazu.

Eksplorator wykazu

1. Na pasku bocznym obszaru roboczego kliknij pozycję Wykaz , aby otworzyć Eksploratora wykazu.

2. Wyszukaj i wybierz obiekt, nad którym chcesz dodać komentarz.

   Obiekty danych i sztucznej inteligencji są wyświetlane i można je przeszukiwać w okienku Wykaz . Udziały, poświadczenia magazynu, lokalizacje zewnętrzne i połączenia są dostępne przy użyciu menu otwierane po kliknięciu ikony koła zębatego .

3. Dodaj komentarz lub edytuj istniejący komentarz.

   • Aby dodać komentarz do tabeli przy użyciu komentarzy generowanych przez sztuczną inteligencję, wyświetl sugerowany komentarz sztucznej inteligencji w okienku po prawej stronie karty Przegląd . Może upłynąć kilka sekund. Zaakceptuj go jako lub Edytuj i zapisz.
   • Aby dodać komentarz do kolumny tabeli przy użyciu komentarzy generowanych przez sztuczną inteligencję, kliknij przycisk Generowanie sztucznej inteligencji nad listą kolumn. Usługa Databricks generuje komentarze dla każdej kolumny. Zaakceptuj je w taki sposób, jak jest, lub edytuj je. Kliknij znacznik wyboru, aby zapisać komentarz.
   • Aby dodać komentarz do obiektu, który nie obsługuje komentarzy generowanych przez sztuczną inteligencję, kliknij przycisk Dodaj komentarz , aby dodać komentarz.
   • Aby dodać komentarz do kolumny tabeli bez używania komentarzy generowanych przez sztuczną inteligencję, kliknij ikonę Dodaj komentarz w wierszu kolumny.
   • Jeśli komentarz już istnieje, zostanie wyświetlony w okienku po prawej stronie na karcie Przegląd lub pod nazwą obiektu. Jeśli nie jest wygenerowana sztuczna inteligencja, kliknij ikonę edycji, aby ją edytować.

Możesz użyć podstawowego języka Markdown do tworzenia stylów komentarzy w interfejsie użytkownika Eksploratora wykazu. Styl markdown nie jest renderowany w przypadku zwracania przez DESCRIBE instrukcje. Cała podstawowa składnia jest obsługiwana w Eksploratorze wykazu z wyjątkiem obrazów i renderowane są tylko dwa poziomy nagłówków. Aby uzyskać więcej informacji, zobacz Podstawowa składnia.

Aby uzyskać więcej informacji na temat komentarzy generowanych przez sztuczną inteligencję, zobacz Dodawanie komentarzy generowanych przez sztuczną inteligencję do obiektów wykazu aparatu Unity.

SQL

Możesz użyć polecenia SQL, aby dodać literał ciągu jako komentarz do dowolnego zabezpieczanego obiektu w wykazie aparatu Unity i tabel zarządzanych w starszym magazynie metadanych Hive. Używane polecenie SQL zależy od obiektu, dla którego chcesz dodać lub edytować komentarz:

• Aby dodać lub zaktualizować komentarz dla dowolnego istniejącego zabezpieczanego obiektu z wyjątkiem kolumn tabeli, użyj COMMENT ON polecenia . Zobacz KOMENTARZ NA TEMAT.

  Możesz również użyć COMMENT opcji z poleceniem ALTER <object> dla obiektu (na przykład ALTER TABLE). Zapoznaj się z artykułem dokumentacja języka SQL dla ALTER <object> polecenia .

• Aby dodać lub zaktualizować komentarz kolumny dla istniejącej tabeli, użyj ALTER TABLE polecenia z ALTER COLUMN klauzulą i COMMENT opcją w kolumnie. Zobacz ALTER TABLE i ALTER TABLE ... Klauzula COLUMN.

• Aby dodać komentarz podczas tworzenia obiektu, użyj COMMENT opcji z poleceniem CREATE <object> . Zapoznaj się z artykułem referencyjnym sql dotyczącym CREATE <object> polecenia, którego chcesz użyć.