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

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.

Po přidání komentářů k zabezpečitelnému objektu může komentáře zobrazit každý uživatel s oprávněními BROWSE . Tím se zlepší zjistitelnost dat v katalogu.

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 ke katalogu, schématu, svazku, modelu, sdílené složce, 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 nebo mít oprávnění k objektu MANAGE.
• 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 na stole.
  • USE CATALOG a USE SCHEMA na nadřazeném katalogu a schématu.
• Musíte použít SQL Warehouse nebo jiný výpočetní objekt, který podporuje katalog Unity.
• Aby bylo možné používat komentáře generované umělou inteligencí, musí být ve vašem pracovním prostoru povolené funkce asistované umělou inteligencí. 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

Důležité

Ukládání komentářů aktivuje příkaz ALTER SQL, který může narušit kanály a úlohy Azure Databricks.

1. Na bočním panelu pracovního prostoru klikněte na Otevřete Průzkumníka katalogu pro otevření katalogu.

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

   Data a objekty AI jsou uvedené a prohledávatelné v podokně Katalog . Sdílení, údaje pro úložiště, externí umístění a připojení jsou přístupné pomocí nabídky, která se otevře po kliknutí na

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

   • Pokud chcete do tabulky přidat komentář pomocí komentářů generovaných umělou inteligencí, zobrazte navrhovaný komentář generovaný umělou inteligencí 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 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 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ů. 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 COMMENT ON.

  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 ... COLUMN klauzule.

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