Lägga till kommentarer till data och AI-tillgångar

Den här artikeln introducerar kommentarer för data och AI-tillgångar och förklarar hur du lägger till dem. Kommentarer kan hjälpa dig och andra användare att hitta och hantera de data och AI-tillgångar du behöver.

Kommentarer ger ett metadatafält för att kommentera dina skyddsbara objekt. Du kan lägga till kommentarer till alla skyddsbara objekt i Unity Catalog, till exempel kataloger, scheman, tabeller, volymer, AI-modeller med mera. Du kan också lägga till kommentarer i tabellkolumner.

Du kan lägga till kommentarer manuellt eller låta Databricks skapa AI-genererade kommentarer åt dig. AI-genererade kommentarer (kallas även AI-genererad dokumentation) är tillgängliga för tabeller och tabellkolumner. Se Lägga till AI-genererade kommentarer till Unity Catalog-objekt.

När du ändrar kommentarer för en Unity Catalog-tabell (eller en Delta Lake-tabell i det äldre Hive-metaarkivet) registrerar en SET TBLPROPERTIES åtgärd i tabellhistoriken den SQL-fråga som användes för att definiera tabellkommentaren.

Innan du börjar

Du måste uppfylla följande krav för att kunna lägga till eller redigera kommentarer:

• Om du vill lägga till eller redigera kommentarer i en katalog, schema, volym, modell, resurs, mottagare, provider, lagringsautentiseringsuppgifter, extern plats eller anslutning måste du vara ägare till objektet eller ha MANAGE behörighet för objektet.
• Om du vill lägga till eller redigera kommentarer i en tabell eller kolumn måste du vara ägare eller ha följande behörigheter:
  • MODIFY och SELECT på tabellen.
  • USE CATALOG och USE SCHEMA i den överordnade katalogen och schemat.
• Du måste använda ett SQL-lager eller annan beräkning som stöder Unity Catalog (delad eller enskild användarberäkning).
• Om du vill använda AI-genererade kommentarer måste din arbetsyta vara aktiverad för AI-hjälpmedelsfunktioner. Se Lägga till AI-genererade kommentarer till Unity Catalog-objekt.

Lägga till och redigera kommentarer

Du kan lägga till kommentarer till skyddsbara objekt eller redigera dem med hjälp av SQL-kommandon eller Katalogutforskaren.

Katalogutforskaren

1. I sidofältet på arbetsytan klickar du på Katalog för att öppna Katalogutforskaren.

2. Sök efter och välj det objekt som du vill kommentera.

   Data- och AI-objekt visas och kan sökas i fönstret Katalog . Resurser, autentiseringsuppgifter för lagring, externa platser och anslutningar är tillgängliga via menyn som öppnas när du klickar på kugghjulsikonen .

3. Lägg till en kommentar eller redigera en befintlig kommentar.

   • Om du vill lägga till en kommentar i en tabell med AI-genererade kommentarer kan du visa DEN AI-föreslagna kommentaren i den högra rutan på fliken Översikt. Det kan ta några sekunder att visas. Acceptera det som det är eller Redigera och spara det.
   • Om du vill lägga till en kommentar i en tabellkolumn med AI-genererade kommentarer klickar du på knappen AI-generera ovanför kolumnlistan. Databricks genererar kommentarer för varje kolumn. Acceptera dem som de är eller redigera dem. Klicka på bockmarkeringen för att spara kommentaren.
   • Om du vill lägga till en kommentar i ett objekt som inte stöder AI-genererade kommentarer klickar du på Lägg till kommentar för att lägga till en kommentar.
   • Om du vill lägga till en kommentar i en tabellkolumn utan att använda AI-genererade kommentarer klickar du på ikonen Lägg till kommentar i kolumnraden.
   • Om det redan finns en kommentar visas den i den högra rutan på fliken Översikt eller under objektnamnet. Om den inte är AI-genererad klickar du på redigeringsikonen för att redigera den.

Du kan använda grundläggande Markdown för att formatera kommentarer i katalogutforskarens användargränssnitt. Markdown-formateringen återges inte när den returneras av DESCRIBE -instruktioner. All grundläggande syntax stöds i Katalogutforskaren förutom bilder, och endast två rubriknivåer återges. Mer information finns i Grundläggande syntax.

Mer information om AI-genererade kommentarer finns i Lägga till AI-genererade kommentarer till Unity Catalog-objekt.

SQL

Du kan använda ett SQL-kommando för att lägga till en strängliteral som en kommentar till alla skyddsbara objekt i Unity Catalog och till tabeller som hanteras i det äldre Hive-metaarkivet. DET SQL-kommando som du använder beror på vilket objekt du vill lägga till eller redigera kommentaren för:

• Om du vill lägga till eller uppdatera en kommentar för alla befintliga skyddsbara objekt förutom tabellkolumner använder du COMMENT ON kommandot . Se KOMMENTERA PÅ.

  Du kan också använda COMMENT alternativet med ALTER <object> kommandot för objektet (till exempel ALTER TABLE). Se SQL-referensartikeln ALTER <object> för kommandot.

• Om du vill lägga till eller uppdatera en kolumnkommentare för en befintlig tabell använder du ALTER TABLE kommandot med ALTER COLUMN -satsen och COMMENT alternativet i kolumnen. Se ALTER TABLE och ALTER TABLE ... COLUMN-sats.

• Om du vill lägga till en kommentar när du skapar ett objekt använder du alternativet COMMENT med CREATE <object> kommandot . Se SQL-referensartikeln för det CREATE <object> kommando som du vill använda.