Aggiungere commenti ai dati e agli asset di intelligenza artificiale

Questo articolo presenta i commenti per gli asset di dati e intelligenza artificiale e spiega come aggiungerli. I commenti possono aiutare l'utente e altri utenti a trovare e gestire i dati e gli asset di intelligenza artificiale necessari.

I commenti forniscono un campo di metadati per annotare gli oggetti a protezione diretta. È possibile aggiungere commenti a qualsiasi oggetto a protezione diretta in Unity Catalog, 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'intelligenza artificiale a una tabella.

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.
• 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 il catalogo unity (calcolo condiviso o utente singolo).
• Per usare i commenti generati dall'intelligenza artificiale, l'area di lavoro deve essere abilitata per le funzionalità di ai-assistive. Vedere Aggiungere commenti generati dall'intelligenza artificiale a una tabella.

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 da impostare come commento.

   I dati e gli oggetti di intelligenza artificiale 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 commento o modificare un commento esistente.

   • Per aggiungere un commento a una tabella usando i commenti generati dall'intelligenza artificiale, visualizzare il commento suggerito dall'intelligenza artificiale nel riquadro destro della scheda Panoramica. Potrebbero essere necessari alcuni secondi. Accettarlo così come è o Modifica e salvarlo.
   • Per aggiungere un commento a una colonna di tabella usando i commenti generati dall'intelligenza artificiale, fare clic sul pulsante Genera intelligenza artificiale 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'intelligenza artificiale, fare clic su Aggiungi commento per aggiungere un commento.
   • Per aggiungere un commento a una colonna di tabella senza usare commenti generati dall'intelligenza artificiale, fare clic sull'icona Aggiungi commento nella riga della colonna.
   • Se esiste già un commento, viene visualizzato nel riquadro destro nella scheda Panoramica o sotto il nome dell'oggetto. Se non è generato dall'intelligenza artificiale, fare clic sull'icona di modifica per modificarla.

Puoi 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 DESCRIBE istruzioni . Tutta la sintassi di base è supportata in Esplora cataloghi, ad eccezione delle immagini e viene eseguito il rendering solo di due livelli di intestazione. Per altre informazioni, vedere Sintassi di base.

Per altre informazioni sui commenti generati dall'intelligenza artificiale, vedere Aggiungere commenti generati dall'intelligenza artificiale a una tabella.

SQL

È possibile usare un comando SQL per aggiungere un valore letterale stringa come commento a qualsiasi oggetto a protezione diretta in Unity Catalog 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 COMMENT ON comando . Vedere COMMENT ON.

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

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

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