Megosztás a következőn keresztül:


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 és SELECT a table.
    • USE CATALOG és USE 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ő

  1. A munkaterület oldalsávjában kattintson Catalog ikonraCatalogCatalog Explorer megnyitásához.

  2. 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 fogaskerék ikonra kattintva megnyíló menüben érhetők el.

  3. 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 ikonra column címke vagy megjegyzés hozzáadásáhozMegjegyzé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 Szerkesztés ikon 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ával ALTER <object> is használhatja (például ALTER TABLE). Tekintse meg a parancs SQL-referenciacikkét ALTER <object> .

  • Meglévő tablecolumn megjegyzésének hozzáadásához vagy update a ALTER TABLE parancsot használja a ALTER 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 COMMENTCREATE <object> parancsot. Tekintse meg a használni kívánt parancs SQL-referenciacikkét CREATE <object> .