Megjegyzések hozzáadása adatokhoz és AI-eszközökhöz
Ez a cikk bemutatja az adatokra és az AI-eszközökre vonatkozó megjegyzéseket, és ismerteti azok hozzáadásának módját. A megjegyzések segítségével Ön és más felhasználók megkereshetik és kezelhetik a szükséges adatokat és AI-eszközöket.
A megjegyzések metaadatmezőt biztosítanak a biztonságos objektumok megjegyzéséhez. Megjegyzéseket fűzhet a Unity Catalogbármely biztonságos objektumához, például catalogs, sémákhoz, tables, volumes, AI-modellekhez stb. Megjegyzéseket is hozzáadhat tablecolumns.
Megjegyzéseket manuálisan is hozzáadhat, vagy engedélyezheti, hogy a Databricks AI által létrehozott megjegyzéseket hozzon létre Önnek. Az AI által létrehozott megjegyzések (más néven AI által létrehozott dokumentáció) a tables és tablecolumnsszámára érhetők el. Lásd: AI által létrehozott megjegyzések hozzáadása a Unity Catalog objektumokhoz.
Amikor megjegyzéseket módosít egy Unity Catalogtable vagy egy Delta Lake table az örökölt Hive-metaadattárban, a table előzményrekordjaiban a SET TBLPROPERTIES
művelet rögzíti az SQL-lekérdezést, amelyet a table megjegyzés meghatározásához használtak.
Mielőtt elkezdené
A megjegyzések hozzáadásához vagy szerkesztéséhez meg kell felelnie a következő követelményeknek:
- Ha megjegyzéseket szeretne fűzni egy catalog, schema, kötethez, modellhez, megosztáshoz, címzetthez, szolgáltatóhoz, tároló hitelesítő adataihoz, külső helyéhez vagy kapcsolatához, az objektum tulajdonosának kell lennie, vagy
MANAGE
jogosultsággal kell rendelkeznie az objektumon. - Ha megjegyzéseket szeretne hozzáadni vagy szerkeszteni egy table vagy column, tulajdonosnak kell lennie, vagy a következő jogosultságokkal kell rendelkeznie:
-
MODIFY
ésSELECT
a table. -
USE CATALOG
ésUSE SCHEMA
a szülő catalog és schema.
-
- Olyan SQL-raktárat vagy más számítást kell használnia, amely támogatja a Unity Catalog (megosztott vagy egyfelhasználós számítás).
- Az AI által létrehozott megjegyzések használatához engedélyezni kell a munkaterületet az AI-kisegítő funkciókhoz. Lásd: AI által létrehozott megjegyzések hozzáadása a Unity Catalog objektumokhoz.
Megjegyzések hozzáadása és szerkesztése
Megjegyzéseket fűzhet biztonságos objektumokhoz, vagy SQL-parancsokkal vagy Catalog Explorerrel szerkesztheti őket.
Catalog Felfedező
A munkaterület oldalsávjában kattintson
CatalogCatalog Explorer megnyitásához.
Keresse meg és hajtsa végre a select műveletet az objektumon, amelyhez megjegyzést szeretne fűzni.
Az adatok és AI-objektumok a Catalog panelen jelennek meg és kereshetők. Shares, tárolási credentials, külső helyek és connections a
fogaskerék ikonra kattintva megnyíló menüben érhetők el.
Megjegyzés hozzáadása vagy meglévő megjegyzés szerkesztése.
- Ha AI által létrehozott megjegyzésekhasználatával szeretne megjegyzést fűzni egy table, tekintse meg a AI által javasolt megjegyzés az Áttekintés lap jobb oldali ablaktábláján. A megjelenés eltarthat néhány másodpercig. Fogadja el , vagy szerkessze és mentse.
- Ha mi által létrehozott megjegyzésekhasználatával szeretne megjegyzést fűzni egy tablecolumn, kattintson a columnlistfölött található AI generate gombra. A Databricks megjegyzéseket hoz létre minden column-hoz. Fogadja el őket, vagy szerkessze őket. A megjegyzés mentéséhez kattintson a pipára.
- Ha olyan objektumhoz szeretne megjegyzést fűzni, amely nem támogatja az AI által létrehozott megjegyzéseket, kattintson a Megjegyzés hozzáadása elemre a megjegyzés hozzáadásához.
-
Ha az AI által létrehozott megjegyzéseknélkül szeretne megjegyzést hozzáadni egy tablecolumn, kattintson a
Megjegyzés hozzáadása ikonhoz a column sorban.
-
Ha már létezik megjegyzés, az az Áttekintés lap jobb oldali ablaktábláján vagy az objektum neve alatt jelenik meg. Ha nem AI-generált, a szerkesztési
ikonra kattintva szerkesztheti.
Az alapszintű Markdown használatával megjegyzéseket formázhat az Catalog Explorer felhasználói felületén. A Markdown-stílus nem jelenik meg utasítások visszaadásakor DESCRIBE
. Az Catalog Explorerben minden alapszintaxis támogatott a képek kivételével, és csak két címsorszint jelenik meg. További információ: Alapszintű szintaxis.
Az AI által létrehozott megjegyzésekkel kapcsolatos további információkért lásd: AI által létrehozott megjegyzések hozzáadása a Unity Catalog objektumokhoz.
SQL
Az SQL-parancsokkal megjegyzésként hozzáadhat egy sztringkonstanst a Unity Catalog bármely védhető objektumához, és az örökölt Hive-metaadattárban tárolt tables elemek között is megjegyzést helyezhet el. A használt SQL-parancs attól az objektumtól függ, amelyhez hozzá szeretné adni vagy szerkeszteni szeretné a megjegyzést:
Ha a tablecolumnskivételével bármely meglévő biztonságos objektumhoz megjegyzést szeretne hozzáadni vagy update, használja a
COMMENT ON
parancsot. Lásd: COMMENT ON.A lehetőséget az
COMMENT
objektum parancsávalALTER <object>
is használhatja (példáulALTER TABLE
). Tekintse meg a parancs SQL-referenciacikkétALTER <object>
.Meglévő tablecolumn megjegyzésének hozzáadásához vagy update a
ALTER TABLE
parancsot használja aALTER COLUMN
záradékkal és a columnCOMMENT
beállításával. Lásd: ALTER TABLE és ALTER TABLE ... COLUMN záradék.Ha megjegyzést szeretne fűzni egy objektum létrehozásakor, használja a
COMMENT
CREATE <object>
parancsot. Tekintse meg a használni kívánt parancs SQL-referenciacikkétCREATE <object>
.