Přidání komentářů k datům a prostředkům AI

  • Článek

Tento článek představuje komentáře k datům a prostředkům AI a vysvětluje, jak je přidat. Komentáře vám a dalším uživatelům můžou pomoct najít a spravovat data a prostředky umělé inteligence, které potřebujete.

Komentáře poskytují pole metadat pro přidávání poznámek k zabezpečitelným objektům. Do libovolného zabezpečitelného objektu v katalogu Unity můžete přidávat komentáře, jako jsou katalogy, schémata, tabulky, svazky, modely AI a další. Do sloupců tabulky můžete také přidávat komentáře.

Komentáře můžete přidávat ručně nebo můžete databricks nechat vytvářet komentáře generované AI za vás. Komentáře generované AI (označované také jako dokumentace generované AI) jsou k dispozici pro tabulky a sloupce tabulky. Viz Přidání komentářů generovaných AI do objektů katalogu Unity.

Při úpravě komentářů pro tabulku katalogu Unity (nebo tabulky Delta Lake ve starším metastore Hive) SET TBLPROPERTIES zaznamená operace v historii tabulek dotaz SQL, který byl použit k definování komentáře tabulky.

Než začnete

Abyste mohli přidávat nebo upravovat komentáře, musíte splnit následující požadavky:

  • Pokud chcete přidat nebo upravit komentáře k katalogu, schématu, svazku, modelu, sdílení, příjemci, poskytovateli, přihlašovacím údajům úložiště, externímu umístění nebo připojení, musíte být vlastníkem objektu.
  • Pokud chcete přidat nebo upravit komentáře k tabulce nebo sloupci, musíte být vlastníkem nebo mít následující oprávnění:
    • MODIFY a SELECT v tabulce.
    • USE CATALOG a USE SCHEMA v nadřazené katalogu a schématu.
  • Musíte použít SQL Warehouse nebo jiný výpočetní objekt, který podporuje katalog Unity (sdílené výpočetní prostředky nebo výpočetní prostředky s jedním uživatelem).
  • Pokud chcete používat komentáře generované AI, musí být váš pracovní prostor povolený pro funkce usnadnění AI. Viz Přidání komentářů generovaných AI do objektů katalogu Unity.

Přidání a úprava komentářů

Komentáře můžete přidávat k zabezpečitelným objektům nebo je upravovat pomocí příkazů SQL nebo Průzkumníka katalogu.

Průzkumník katalogu

  1. Na bočním panelu pracovního prostoru kliknutím na Ikona katalogu Katalog otevřete Průzkumníka katalogu.

  2. Vyhledejte a vyberte objekt, který chcete okomentovat.

    Data a objekty AI jsou uvedené a prohledávatelné v podokně Katalog . Sdílené složky, přihlašovací údaje k úložišti, externí umístění a připojení jsou přístupné pomocí nabídky, která se otevře po kliknutí na ikonu ozubeného Ikona ozubeného kolečka kola.

  3. Přidejte komentář nebo upravte existující komentář.

    • Pokud chcete do tabulky přidat komentář pomocí komentářů generovaných pomocí AI, zobrazte si navrhovaný komentář AI v pravém podokně na kartě Přehled . Zobrazení může trvat několik sekund. Buď ho přijměte tak, jak je, nebo ho upravte a uložte.
    • Pokud chcete přidat komentář ke sloupci tabulky pomocí komentářů generovaných pomocí AI, klikněte na tlačítko Vygenerovat AI nad seznamem sloupců. Databricks generuje komentáře pro každý sloupec. Přijměte je tak, jak jsou, nebo je upravte. Kliknutím na značku zaškrtnutí komentář uložte.
    • Pokud chcete přidat komentář k objektu, který nepodporuje komentáře generované AI, klikněte na Přidat komentář a přidejte komentář.
    • Pokud chcete přidat komentář do sloupce tabulky bez použití komentářů generovaných pomocí umělé inteligence, klikněte na Ikona pro přidání značky sloupce nebo komentáře ikonu Přidat komentář na řádku sloupce.
    • Pokud komentář již existuje, zobrazí se v pravém podokně na kartě Přehled nebo pod názvem objektu. Pokud není generovaná AI, klikněte na Ikona Upravit ikonu pro úpravy a upravte ji.

Pomocí základního Markdownu můžete stylovat komentáře v uživatelském rozhraní Průzkumníka katalogu. Styling Markdownu se při vrácení příkazů DESCRIBE nevykreslí. Všechny základní syntaxe jsou podporovány v Průzkumníku katalogu s výjimkou obrázků a vykreslují se pouze dvě úrovně nadpisů. Další informace naleznete v tématu Základní syntaxe.

Další informace o komentářích generovaných pomocí AI najdete v tématu Přidání komentářů generovaných AI do objektů katalogu Unity.

SQL

Příkaz SQL můžete použít k přidání řetězcového literálu jako komentáře k libovolnému zabezpečitelnému objektu v katalogu Unity a k tabulkám spravovaným ve starším metastoru Hive. Příkaz SQL, který použijete, závisí na objektu, pro který chcete přidat nebo upravit komentář pro:

  • Pokud chcete přidat nebo aktualizovat komentář pro jakýkoli existující zabezpečitelný objekt s výjimkou sloupců tabulky, použijte COMMENT ON příkaz. Viz KOMENTÁŘ.

    Můžete také použít COMMENT možnost s příkazem ALTER <object> pro objekt (například ALTER TABLE). Příkaz najdete v referenčním ALTER <object> článku SQL.

  • Pokud chcete přidat nebo aktualizovat komentář ke sloupci pro existující tabulku, použijte ALTER TABLE příkaz s ALTER COLUMN klauzulí a COMMENT možností sloupce. Viz ALTER TABLE a ALTER TABLE ... KLAUZULE COLUMN.

  • Pokud chcete přidat komentář při vytváření objektu, použijte COMMENT možnost s příkazem CREATE <object> . Informace o příkazu, který chcete použít, najdete v referenčním CREATE <object> článku SQL.