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 Catalog bármely biztonságos objektumához, például katalógusokhoz, sémákhoz, táblákhoz, kötetekhez, AI-modellekhez stb. Megjegyzéseket is hozzáadhat a táblázatoszlopokhoz.

Miután megjegyzéseket adott hozzá egy biztonságos objektumhoz, minden jogosultsággal rendelkező BROWSE felhasználó megtekintheti a megjegyzéseket. Ez javítja az adatok felderíthetőségét a katalógusban.

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ó) táblákhoz és táblázatoszlopokhoz érhetők el. Lásd: AI által létrehozott megjegyzések hozzáadása Unity Catalog-objektumokhoz.

Ha módosít megjegyzéseket egy Unity Catalog-táblához (vagy egy Delta Lake-táblához az örökölt Hive-metaadattárban), a táblaelőzmények egyik SET TBLPROPERTIES művelete rögzíti a tábla megjegyzésének meghatározásához használt SQL-lekérdezést.

Mielőtt elkezdené

A megjegyzések hozzáadásához vagy szerkesztéséhez meg kell felelnie a következő követelményeknek:

• A katalógusra, sémára, kötetre, modellre, megosztásra, címzettre, szolgáltatóra, tároló hitelesítő adatokra, külső helyre vagy kapcsolatra vonatkozó megjegyzések hozzáadásához vagy szerkesztéséhez az objektum tulajdonosának kell lennie, vagy MANAGE jogosultsággal kell rendelkeznie az objektumon.
• Ha megjegyzéseket szeretne hozzáadni vagy szerkeszteni egy táblán vagy oszlopon, tulajdonosnak kell lennie, vagy a következő jogosultságokkal kell rendelkeznie:
  • MODIFY és SELECT az asztalon.
  • USE CATALOG és USE SCHEMA a szülőkatalógus és séma esetében.
• Ha megjegyzéseket szeretne hozzáadni vagy szerkeszteni egy nézethez vagy materializált nézethez, a nézet tulajdonosának kell lennie. MANAGE A jogosultság nem elegendő.
• A Unity Catalogot támogató SQL Warehouse-t vagy más számítást kell használnia.
• 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 Unity Catalog-objektumokhoz.

Megjegyzések hozzáadása és szerkesztése

Megjegyzéseket fűzhet biztonságos objektumokhoz, vagy szerkesztheti őket SQL-parancsokkal vagy a Catalog Explorerrel.

Katalóguskezelő

Fontos

A megjegyzések mentése egy ALTER SQL-parancsot aktivál, amely megzavarhatja az Azure Databricks-folyamatokat és -feladatokat.

1. A munkaterület oldalsávjában kattintson az Katalógus a Catalog Explorer megnyitásához.

2. Keresse meg és jelölje ki azt az objektumot, amelyhez megjegyzést szeretne fűzni.

   Az adatok és AI-objektumok a Katalógus panelen jelennek meg és kereshetők. A megosztások, a tárolási hitelesítő adatok, a külső helyek és a kapcsolatok a 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ések használatával szeretne megjegyzést fűzni egy táblához, tekintse meg az AI javasolt megjegyzését 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 AI által létrehozott megjegyzések használatával szeretne megjegyzést fűzni egy táblaoszlophoz, kattintson az AI-létrehozás gombra az oszloplista fölött. A Databricks minden oszlophoz megjegyzéseket hoz létre. 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 AI által létrehozott megjegyzések használata nélkül szeretne megjegyzést fűzni egy táblázatoszlophoz, kattintson a Megjegyzés hozzáadása ikonra az oszlopsorban.
   • 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.

A Katalóguskezelő felhasználói felületén az egyszerű Markdown használatával stílusjegyeket fűzhet a megjegyzésekhez. A Markdown-stílus nem jelenik meg, amikor a DESCRIBE utasítások visszaadják. A Katalóguskezelőben minden alapszintű szintaxis támogatott, kivéve a képeket. További információ: Alapszintű szintaxis.

További információ az AI által létrehozott megjegyzésekről: AI által létrehozott megjegyzések hozzáadása Unity Catalog-objektumokhoz.

SQL

A SQL parancs segítségével beszúrhat egy karakterláncot kommentárként a Unity Catalog bármely biztonságos objektumához, valamint az örökölt Hive-metaadattárban kezelt táblákhoz. A használt SQL-parancs attól az objektumtól függ, amelyhez hozzá szeretné adni vagy szerkeszteni szeretné a megjegyzést:

• Ha a táblaoszlopok kivételével bármely meglévő biztonságos objektumhoz megjegyzést szeretne hozzáadni vagy frissíteni, használja a COMMENT ON parancsot. Lásd COMMENT ON.

  Az COMMENT opciót is használhatja az ALTER <object> parancsával az objektumhoz (például ALTER TABLE). Tekintse meg a parancs SQL-referenciacikkét ALTER <object> .

• Egy meglévő táblázat oszlophoz fűzött megjegyzés hozzáadásához vagy frissítéséhez használja a ALTER TABLE parancsot az ALTER COLUMN záradék segítségével és az COMMENT opcióval az oszlopon. Lásd ALTER TABLE és a ALTER TABLE ... COLUMN záradékot.

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