Unity Catalog wikik

Important

Ez a funkció bétaverzióban érhető el. A fiókadminisztrátor a fiókkonzol Előzetes verzió lapján kezelheti a szolgáltatáshoz való hozzáférést. Lásd: Fiókszintű előzetes verziók kezelése.

A wiki lehetővé teszi, hogy a csapat dokumentálja a tábla jelentését, a célját és a forrásait, majd közvetlenül a Catalog Explorerben együttműködjön az információval kapcsolatban. Az adattulajdonosok és adatgondnokok wikiket készítenek és közzétesznek, hogy megragadják a táblázathoz tartozó üzleti kontextust, például definíciókat és ismert fenntartásokat. Bárki, aki megtekintheti a táblázat metaadatait, elolvashatja a közzétett wikit, kommentelhet, szerkesztéseket javasolhat és reagálhat rá.

Egy wiki egy táblázatot dokumentál. Az Page egy olyan üzleti koncepciót határoz meg, amely számos eszközt képes lefedni. Használj wikit egy adott táblával kapcsolatos kontextushoz, és egy Page-et használj közös definícióhoz.

A wikik a táblázat meglévő megjegyzése mellett működnek. Lásd a wikiket és a táblázatmegjegyzéseket.

Mi van egy wikiben

Egy wiki a következő mezőket tartalmazza:

Field Description
Description A táblázat egysoros összefoglalója, a wiki tetején látható.
Oldaltörzs Rich text formátumú dokumentáció, amely támogatja a Unity Catalog biztonságosan kezelhető objektumainak és munkaterületi objektumainak címsorait, linkjeit, képeit, valamint soron belüli megemlítéseit.
Sources Linkek azokra az oldalakra vagy külső forrásokra, amelyeken a wiki tartalma alapul.

Egy közzétett wiki a Catalog Explorer táblázatának Áttekintés fülén, leírással, oldal törzsrészeivel és Források linkkel

Támogatott biztosítható objektumok

Létrehozhatsz wikit a következő Unity Catalog biztonsági objektumokon:

Bankjegy

A wikik nem érhetők el az OpenSharing használatával megosztott biztosítható objektumokon.

Permissions

A wiki nem biztonsági jogosultságokkal rendelhető objektum. Ez a tábla metaadata, így a meglévő Unity Catalog-jogosultságaid a táblán határozzák meg, mit tehetsz a wikijével. A Unity Catalog jogosultságaival kapcsolatos háttér-információkért lásd a Unity Catalog jogosultsági modelljének alapfogalmait.

Az alábbi jogosultságok táblázata az anyaobjektumokon lévő használati jogosultságokat használja arra, hogy azokat a használati jogosultságokat jelölje, amelyek READ_METADATA, MANAGE vagy a tulajdonjog hatálybalépéséhez szükségesek. Az objektumtól függenek:

  • Táblázat: USE SCHEMA a szülő sémára és USE CATALOG a szülő katalógusra.
  • Séma: USE CATALOG a szülő katalóguson.
  • Katalógus: Nincs.
Művelet Szükséges jogosultságok
Közzétett wikik megtekintése és közös szerkesztése: közzétett wikik megtekintése, hozzászólások hozzáadása, saját hozzászólásaid szerkesztése vagy törlése, szerkesztési javaslatok tétele és reakciók hozzáadása Az alábbiak egyike:
  • SELECT az asztalon, USE SCHEMA a sémán és USE CATALOG a katalóguson
  • BROWSE a szülőkatalóguson
  • READ_METADATA a táblán, sémán, katalóguson vagy metastore-on, a szülő objektumokon meglévő használati jogosultságokkal
  • MANAGE a táblára, sémára vagy katalógusra, a szülő objektumokon érvényes használati jogosultságokkal
  • A tábla, a szülő séma vagy a szülőkatalógus tulajdonosa, aki használati jogosultságokkal rendelkezik a szülő objektumokon
  • Metaadattár-rendszergazda
Piszkozatwikik megtekintése Az alábbiak egyike:
  • READ_METADATA a táblán, sémán, katalóguson vagy metastore-on, a szülő objektumokon meglévő használati jogosultságokkal
  • MANAGE a táblára, sémára vagy katalógusra, a szülő objektumokon érvényes használati jogosultságokkal
  • A tábla, a szülő séma vagy a szülőkatalógus tulajdonosa, aki használati jogosultságokkal rendelkezik a szülő objektumokon
  • Metaadattár-rendszergazda
Wikik és hozzászólások kezelése: wikik létrehozása, szerkesztése, közzététele vagy kiadásának visszavonása, javasolt szerkesztések elfogadása vagy elutasítása, valamint minden hozzászólás törlése Az alábbiak egyike:
  • MANAGE a táblára, sémára vagy katalógusra, a szülő objektumokon érvényes használati jogosultságokkal
  • A tábla, a szülő séma vagy a szülőkatalógus tulajdonosa, aki használati jogosultságokkal rendelkezik a szülő objektumokon
  • Metaadattár-rendszergazda

Wiki létrehozása

Wiki létrehozásához szükséged van a wikik kezeléséhez szükséges jogosultságokra a táblán. Lásd : Engedélyek.

Manuálisan írhatsz egy wikit, vagy Genie Code-dal vázlatot készíthetsz hozzá.

Warning

A wikiben tárolt adatokat nyugalmi állapotban Microsoft által kezelt kulcsokkal titkosítják. A wikik nem támogatják az ügyfél által kezelt kulcs (CMK) titkosítást. Ne vegyék fel a PII-t, szabályozott adatokat vagy más érzékeny információkat a wiki leírásokban vagy oldalak szövegében.

  1. A Catalog Explorerben nyisd meg a táblát.

  2. Az Áttekintés lapon kattintson a Wiki létrehozása lehetőségre. Ha bezártad a Wiki létrehozása szalagcímet, kattints az oldal jobb felső sarkában lévő kebab menüre., majd válaszd a Wiki létrehozása lehetőséget. Ha a táblázatban már van egy hozzászólás, akkor az inicializálja a wikioldal törzsét.

    A Wiki létrehozása banner a táblázat leírása felett az Áttekintés fülön

  3. Adja hozzá a wiki tartalmát:

    • Kézi létrehozáshoz töltse ki a Leírást és az Oldal törzsét, és adja hozzá a forrásokat.
    • A Genie Code-dal történő vázlatkészítéshez használja a wiki szerkesztő Genie Code paneljét. Csatolj fájlokat vagy más kontextust, amiből a Genie Code dolgozhat. Lásd : Genie Code.
  4. Kattints a Mentés piszkozatként lehetőségre, hogy tovább dolgozhass a wikin, vagy kattints a Közzétételre, hogy mindenki számára látható legyen, aki megtekintheti a táblázat metaadatait.

Miután közzétesz egy wikit, az megjelenik a táblázat Áttekintés fül tetején, és a táblázat Leírása átkerül a Részletek fülre.

Wikik szerkesztése és közzététele

Egy wiki szerkesztéséhez, közzétételéhez vagy közzétételének visszavonásához szükséged van a wikik táblán történő kezeléséhez szükséges jogosultságokra. Lásd : Engedélyek.

  1. A Catalog Explorerben nyisd meg a táblát.

  2. A wikiben kattints a Szerkesztésre.

  3. Tedd meg a változtatásokat, majd kattints a Mentésre a mentéshez, vagy kattints a Közzétételre, hogy egy piszkozat wiki láthatóvá váljon.

    Egy piszkozatwiki szerkesztési módban, Mégse, Mentés és Közzététel gombokkal

Ha el akarod rejteni egy közzétett wikit anélkül, hogy elveszítenéd a tartalmát, kattints a Szerkesztésre, kattints a kebab menüre, majd kattints a Közzététel visszavonása gombra. A wiki visszatér egy olyan vázlatra, amelyet csak azok a felhasználók láthatnak, akik megtekinthetik a vázlatokat. Amíg nem teszed közzé újra a wikit, a táblázat Leírása a Áttekintés fül tetején jelenik meg.

A Közzététel visszavonása opció a közzétett wiki kebab menüjében szerkesztés módban

Együttműködés a wikin

Bárki, aki meg tud nézni egy publikált wikit, együttműködhet rajta. Lásd : Engedélyek.

  • Hozzászólás: Tegyél fel kérdéseket vagy adj hozzá kontextust. Szerkesztheted vagy törölheted a saját hozzászólásodat.
  • Szerkesztések javaslata: Módosítások javaslata a wikioldal tartalmára. Kattints a Javaslatra, szerkeszd az oldal tartalmát, majd kattints a Mentésre. A wiki kezelésére jogosult felhasználó elfogadja vagy elutasítja a javaslatot.
  • Reagálj: Szavazd fel vagy le a wikit, hogy jelezd, hasznos volt-e a wiki.

Wikik és táblázatmegjegyzések

A wiki nem helyettesíti a táblázat kommentjét, így a meglévő pipeline-ok, amelyek olvassák vagy írják a kommentet, továbbra is működnek:

  • A hozzászólást még mindig beállíthatod a(z) COMMENT ON TABLE vagy ALTER TABLE használatával. A hozzászólás még mindig megjelenik a information_schema-ban és a Catalog Explorer Leírás mezőjében.
  • Amikor wikit hozol létre, a táblázat meglévő megjegyzése kitölti a wiki oldaltörzsét. Ezután a wiki és a hozzászólás független. Az egyik módosítása nem frissíti a másikat.

A táblázatmegjegyzésekkel kapcsolatos további információkért lásd: Megjegyzések hozzáadása adatokhoz és AI-eszközökhöz.

Wikik kezelése a REST API-val

Olvassa el és frissítse a táblázat wikijét programozott módon a wiki REST API-jával. Az API a következő műveleteket támogatja:

  • Wiki lekérése: A wiki lekérése egy táblához.
  • Wiki frissítése: Frissítsd a wikit egy táblához, vagy hozd létre, ha a táblához még nincs wiki. A wiki állapotának közzétételre állítása közzéteszi azt.

Az API ugyanazokat a jogosultságokat követeli, mint a UI. Lásd : Engedélyek. Hitelesítse kéréseit a munkaterületi felhasználójához tartozó Databricks személyes hozzáférési tokennel vagy OAuth-tal.

A kérések és válaszok részleteiért lásd a Wikis REST API hivatkozást.

Limitations

  • A wikik csak a Támogatott securables alatt felsorolt biztosítható objektumokon érhetők el. Az oszlopokról, sémákról, katalógusokról és más védhető objektumokról szóló wikik nem támogatottak.
  • Minden asztalnak lehet egy wikije.
  • Wikik nem elérhetők az Azure Government, Azure China vagy FedRAMP régiókban.