wiki Unity Catalog

Important

Tato funkce je v beta verzi. Správci účtu mohou spravovat přístup k této funkci na stránce Previews v konzoli účtu. Viz Správa náhledů na úrovni účtu.

Wiki umožňuje vašemu týmu zdokumentovat význam tabulky, její zamýšlené využití a zdroje, a poté na těchto informacích spolupracovat. Vlastníci dat a správci vytvářejí a publikují wiki, aby zachytili byznysový kontext, který náleží k tabulce, například definice a známá omezení. Kdokoli, kdo může vidět metadata tabulky, si může přečíst zveřejněnou wiki, komentovat ji, navrhovat úpravy a reagovat na ni.

Wiki dokumentuje jednu tabulku. Page definuje podnikatelský koncept, který může zahrnovat mnoho aktiv. Použijte wiki pro kontext konkrétní tabulky a stránku pro sdílenou definici.

Wiki pracují vedle stávající poznámky k tabulce. Viz wiki a komentáře k tabulkám.

Co je na wiki

Wiki obsahuje následující pole:

Pole Description
Description Jednořádkové shrnutí tabulky, zobrazené nahoře na wiki.
Hlavní část stránky Dokumentace s formátovaným textem, která podporuje nadpisy, odkazy, obrázky a vložené zmínky o zabezpečených objektech Unity Catalog a objektech pracovního prostoru.
Sources Odkazy na stránky nebo externí zdroje, na kterých je obsah wiki založen.

Publikovaná wiki na záložce Přehled tabulky v Průzkumníku katalogů, s popisem, sekcemi hlavního obsahu stránek a odkazem na zdroje

Permissions

Wiki není zabezpečitelný objekt. Jde o metadata u dané tabulky, takže vaše stávající oprávnění Unity Catalog k tabulce určují, co můžete dělat s její wiki stránkou. Pro pozadí práv Unity Catalog viz koncepty modelu oprávnění Unity Catalog.

Tabulka oprávnění, která následuje, používá oprávnění k použití u nadřazených objektů k označení oprávnění k použití, která READ_METADATA, MANAGE nebo vlastnictví vyžadují k uplatnění. Závisí na objektu:

  • Tabulka: USE SCHEMA na nadřazeném schématu a USE CATALOG na nadřazeném katalogu.
  • Schema: USE CATALOG v nadřazeném katalogu.
  • Katalog: žádný.
Action Požadovaná oprávnění
Prohlížejte a spolupracujte na publikovaných wiki: prohlížejte publikované wiki, přidávejte, upravujte nebo mažte své vlastní komentáře, navrhujte úpravy a přidáváte reakce Jedna z následujících možností:
  • SELECT na stole, USE SCHEMA na schématu a USE CATALOG v katalogu
  • BROWSE v nadřazeném katalogu
  • READ_METADATA na tabulce, schématu, katalogu nebo metastore, s oprávněními použití na rodičovských objektech
  • MANAGE na tabulce, schématu nebo katalogu, s oprávněními k použití na rodičovských objektech
  • Vlastník tabulky, rodičovského schématu nebo rodičovského katalogu s oprávněními k používání rodičovských objektů
  • Správce metastoru
Zobrazit koncepty wiki Jedna z následujících možností:
  • READ_METADATA na tabulce, schématu, katalogu nebo metastore, s oprávněními k použití na nadřazených objektech
  • MANAGE na tabulce, schématu nebo katalogu, s oprávněními k použití na rodičovských objektech
  • Vlastník tabulky, rodičovského schématu nebo rodičovského katalogu s oprávněními k používání rodičovských objektů
  • Správce metastoru
Spravovat wiki a komentáře: vytvářet, upravovat, publikovat nebo rušit publikování wiki, přijímat nebo odmítat navrhované úpravy a mazat jakýkoli komentář Jedna z následujících možností:
  • MANAGE na tabulce, schématu nebo katalogu, s oprávněními k použití u nadřazených objektů
  • Vlastník tabulky, rodičovského schématu nebo rodičovského katalogu s oprávněními k používání rodičovských objektů
  • Správce metastoru

Vytvořte wiki

Pro vytvoření wiki potřebujete oprávnění ke správě wiki v tabulce. Viz Oprávnění.

Wiki můžete vytvořit ručně nebo ji sestavit v Genie Code.

Warning

Wiki data jsou v klidu šifrována klíči spravovanými Microsoft. Wiki nepodporují šifrování pomocí zákaznicky spravovaných klíčů (CMK). Nezařazujte osobní údaje (PII), regulovaná data ani jiné citlivé informace do popisů wiki nebo těl stránek.

  1. V Catalog Explorer otevřete tabulku.

  2. Na záložce Přehled klikněte na Vytvořit wiki. Pokud jste zavřeli banner Vytvořit wiki, klikněte na ikonu nabídky kebab v pravém horním rohu stránky a místo toho vyberte Vytvořit wiki. Pokud tabulka obsahuje existující komentář, předvyplní tělo stránky wiki.

    Banner Vytvořit wiki nad popisem tabulky na záložce Přehled

  3. Přidejte obsah wiki:

    • Pro ruční autorství vyplňte popis a tělo stránky a přidejte všechny zdroje.
    • Při psaní pomocí Genie Code použijte panel Genie Code v editoru wiki. Přiložte soubory nebo jiný kontext, ze kterého může Genie Code pracovat. Viz Genie Code.

  4. Klikněte na Uložit jako návrh pro pokračování v práci na wiki, nebo na Publikovat , abyste ji zpřístupnili všem, kdo mohou vidět metadata tabulky.

Po zveřejnění wiki se objeví nahoře v záložce Přehled tabulky a popis tabulky se přesune na záložku Detaily .

Upravovat a publikovat wiki

Pro úpravu, publikaci nebo zrušení publikace wiki potřebujete oprávnění ke správě wiki v tabulce. Viz Oprávnění.

  1. V Catalog Explorer otevřete tabulku.

  2. Na wiki klikněte na Editovat.

  3. Provedete změny, pak klikněte na Uložit pro jejich uložení, nebo klikněte na Publikovat , abyste zpřístupnili koncept wiki.

    Návrh wiki v režimu úprav, s tlačítky Zrušit, Uložit a Publikovat

Chcete-li skrýt publikovanou wiki, aniž byste ztratili její obsah, klikněte na Upravit, klikněte na menu kebabu a poté na Zrušit publikaci. Wiki se vrací k návrhu, který mohou vidět jen uživatelé, kteří mohou vidět návrhy. Dokud wiki znovu nezveřejníte, popis tabulky se objevuje nahoře na záložce Přehled.

Možnost Zrušit publikaci v menu kebabu na publikované wiki v režimu úprav

Spolupracujte na wiki

Kdokoliv, kdo může vidět publikovanou wiki, na ní může spolupracovat. Viz Oprávnění.

  • Komentář: Ptejte se na otázky nebo doplňujte kontext. Můžete upravovat nebo mazat své vlastní komentáře.
  • Navrhněte úpravy: Navrhujte změny v těle stránky wiki. Klikněte na Navrhnout, upravte tělo stránky a klikněte na Uložit. Uživatel s oprávněním spravovat wiki návrh přijímá nebo odmítá.
  • React: Hlasujte pro nebo proti wiki, abyste naznačili, zda to bylo užitečné.

Wiki a komentáře k tabulce

Wiki nenahrazuje komentář tabulky, takže stávající pipeline, které čtou nebo píší komentáře, fungují dál:

  • Stále můžete nastavit komentář pomocí COMMENT ON TABLE nebo ALTER TABLE. Komentář se stále objevuje v information_schema a v poli Popis v Průzkumníku katalogu.
  • Když vytvoříte wiki, stávající komentář tabulky předvyplní tělo stránky wiki. Poté jsou wiki a komentář nezávislé. Změny u jednoho neaktualizují druhý.

Více o komentářích k tabulkám najdete v článku Přidat komentáře k datům a aktivům AI.

Limitations

  • Wiki jsou dostupné pouze na tabletech. Wikiny o sloupcích, schématech, katalozích a dalších zabezpečitelných objektech nejsou podporovány.
  • Každá tabulka může mít jednu stránku wiki.
  • Wiki nejsou dostupné v regionech Azure Government, Azure China ani FedRAMP.
  • Poslední aktualizace v