Aggiungere commenti ai dati e agli asset IA

Questo articolo presenta i commenti per i dati e gli asset IA e spiega come aggiungerli. I commenti possono aiutare gli utenti a trovare e gestire i dati e gli asset di IA necessari.

I commenti forniscono un campo di metadati dove annotare gli oggetti a protezione diretta. È possibile aggiungere commenti a qualsiasi oggetto a protezione diretta nel catalogo Unity, ad esempio cataloghi, schemi, tabelle, volumi, modelli di intelligenza artificiale e altro ancora. È anche possibile aggiungere commenti alle colonne della tabella.

È possibile aggiungere commenti manualmente oppure consentire a Databricks di creare automaticamente commenti generati dall'intelligenza artificiale. I commenti generati dall'intelligenza artificiale (nota anche come documentazione generata dall'intelligenza artificiale) sono disponibili per tabelle e colonne di tabella. Vedere Aggiungere commenti generati dall’IA agli oggetti del catalogo unity.

Quando si modificano i commenti per una tabella del catalogo Unity (o una tabella Delta Lake nel metastore Hive legacy), un'operazione SET TBLPROPERTIES nella cronologia delle tabelle registra la query SQL usata per definire il commento della tabella.

Operazioni preliminari

Per aggiungere o modificare i commenti, è necessario soddisfare i requisiti seguenti:

• Per aggiungere o modificare commenti in un catalogo, uno schema, un volume, un modello, una condivisione, un destinatario, un provider, credenziali di archiviazione, una posizione esterna o una connessione, è necessario essere il proprietario dell'oggetto o avere il privilegio MANAGE per l'oggetto.
• Per aggiungere o modificare commenti in una tabella o una colonna, è necessario essere il proprietario o disporre dei privilegi seguenti:
  • MODIFY e SELECT sulla tabella.
  • USE CATALOG e USE SCHEMA nel catalogo padre e nello schema.
• È necessario usare un'istanza di SQL Warehouse o un altro ambiente di calcolo che supporti Unity Catalog (calcolo condiviso o singolo utente).
• Per usare i commenti generati dall'IA, l'area di lavoro deve essere abilitata per le funzionalità di assistenza IA. Vedere Aggiungere commenti generati dall’IA agli oggetti del catalogo unity.

Aggiungere e modificare commenti

È possibile aggiungere commenti a oggetti a protezione diretta o modificarli usando i comandi SQL o Esplora cataloghi.

Esplora cataloghi

1. Nella barra laterale dell'area di lavoro fare clic su Catalogo per aprire Esplora cataloghi.

2. Cercare e selezionare l’oggetto che si desidera commentare.

   I dati e gli oggetti di IA sono elencati e ricercabili nel riquadro Catalogo. Condivisioni, credenziali di archiviazione, posizioni esterne e connessioni sono accessibili usando il menu che si apre quando si fa clic sull'icona a forma di ingranaggio.

3. Aggiungere un nuovo commento o modificare un commento esistente.

   • Per aggiungere un commento a una tabella usando i commenti generati dall'IA, visualizzare il Commento suggerito dall’IA nel riquadro destro della scheda Informazioni generali. L’operazione potrebbe richiedere alcuni secondi. Accettarlo così com’è, oppure scegliere di modificarlo e salvarlo.
   • Per aggiungere un commento a una colonna di tabella usando i commenti generati dall’IA, fare clic sul pulsante Generato dall’IA sopra l'elenco di colonne. Databricks genera commenti per ogni colonna. Accettarli così come sono o modificarli. Fare clic sul segno di spunta per salvare il commento.
   • Per aggiungere un commento a un oggetto che non supporta i commenti generati dall’IA, fare clic su Aggiungi commento per aggiungere un commento.
   • Per aggiungere un commento a una colonna di tabella senza usare commenti generati dall’IA, fare clic sull'icona Aggiungi commento nella riga della colonna.
   • Se esiste già un commento, viene visualizzato nel riquadro destro nella scheda Informazioni generali o sotto il nome dell'oggetto. Se non è generato dall'intelligenza artificiale, fare clic sull'icona di modifica per modificarla.

È possibile usare Markdown di base per applicare uno stile ai commenti nell'interfaccia utente di Esplora cataloghi. Lo stile Markdown non viene eseguito quando viene restituito dalle istruzioni DESCRIBE. Tutta la sintassi di base è supportata in Esplora cataloghi, ad eccezione delle immagini, e il rendering viene eseguito solo per due livelli di intestazione. Per maggiori informazioni, vedere Sintassi di base.

Per altre informazioni sui commenti generati dall'IA, vedere Aggiungere commenti generati dall'IA agli oggetti del catalogo Unity.

SQL

È possibile usare un comando SQL per aggiungere un valore letterale stringa come commento a qualsiasi oggetto a protezione diretta nel catalogo Unity e alle tabelle gestite nel metastore Hive legacy. Il comando SQL usato dipende dall'oggetto per cui si vuole aggiungere o modificare il commento per:

• Per aggiungere o aggiornare un commento per qualsiasi oggetto a protezione diretta esistente, ad eccezione delle colonne della tabella, usare il comando COMMENT ON. Vedere COMMENT ON.

  È anche possibile usare l'opzione COMMENT con il comando ALTER <object> per l'oggetto (ad esempio ALTER TABLE). Vedere l’articolo di riferimento SQL per il comando ALTER <object>.

• Per aggiungere o aggiornare un commento di colonna per una tabella esistente, usare il comando ALTER TABLE con la clausola ALTER COLUMN e l'opzione COMMENT nella colonna. Vedere le clausole ALTER TABLE e ALTER TABLE... COLUMN.

• Per aggiungere un commento quando si crea un oggetto, usare l'opzione COMMENT con il comando CREATE <object>. Vedere l'articolo di riferimento su SQL per il comando CREATE <object> che si vuole usare.