Applicare tag a oggetti proteggibili di Unity Catalog

Questo articolo illustra come applicare tag a oggetti a protezione diretta di Unity Catalog.

I tag sono attributi che includono chiavi e valori facoltativi che è possibile usare per organizzare e categorizzare oggetti protetti nel Unity Catalog. L'uso dei tag semplifica anche la ricerca e l'individuazione di tabelle e viste usando la funzionalità di ricerca dell'area di lavoro.

I dati dei tag possono essere replicati a livello globale. Non usare nomi di tag o valori che potrebbero compromettere la sicurezza delle risorse. Ad esempio, non usare nomi di tag che contengono informazioni personali o riservate.

Oggetti a protezione diretta supportati

L'assegnazione di tag agli oggetti proteggibili è attualmente supportata nei cataloghi, negli schemi, nelle tabelle, nelle colonne di tabella, nei volumi, nelle viste, nei modelli registrati e nelle versioni del modello. Per ulteriori informazioni sugli oggetti proteggibili, vedere Oggetti proteggibili in Unity Catalog.

Requisiti

Per aggiungere tag a oggetti a protezione diretta di Unity Catalog, è necessario possedere l'oggetto o disporre di tutti i privilegi seguenti:

• APPLY TAG sull'oggetto
• USE SCHEMA sullo schema padre dell'oggetto
• USE CATALOG nel catalogo padre dell'oggetto

Vincoli

Di seguito è riportato un elenco di vincoli di tag:

• È possibile assegnare un massimo di 50 tag a un singolo oggetto a protezione diretta.

• La lunghezza massima di una chiave tag è di 255 caratteri.

• La lunghezza massima di un valore di tag è di 1000 caratteri.

• I caratteri seguenti non sono consentiti nelle chiavi dei tag:

  . , - = / :

• La ricerca di tag tramite l'interfaccia utente di ricerca dell'area di lavoro è supportata solo per tabelle, viste e colonne di tabella.

• La ricerca di tag richiede la corrispondenza esatta dei termini.

Aggiungere e aggiornare i tag usando Catalog Explorer

Per aggiungere e aggiornare tag di oggetti proteggibili tramite Catalog Explorer:

1. Fare clic sull'icona Catalogo nella barra laterale.

2. Selezionare un oggetto proteggibile.

3. Nella pagina panoramica dell'oggetto aggiungere o aggiornare un tag:

   • Se non sono presenti tag, fare clic sul pulsante Aggiungi tag.
   • Se sono presenti tag, fare clic sull'icona Aggiungi/Modifica tag.

   È possibile usare la finestra di dialogo Aggiungi/Modifica tag per aggiungere ed eliminare più tag.

   Le chiavi dei tag sono obbligatorie. I valori dei tag sono facoltativi.

   Per aggiungere o eliminare tag di colonna della tabella, fare clic sull'icona Icona Aggiungi tag.

Aggiungere e aggiornare i tag usando i comandi SQL

Nota

Questa funzionalità è disponibile nelle versioni di Databricks Runtime 13.3 e successive.

È possibile usare il comando SQL ALTER <object> per contrassegnare cataloghi, schemi, tabelle (incluse viste, viste materializzate, tabelle di streaming), volumi e colonne di tabella. Ad esempio, è possibile usare le clausole SET TAGS e UNSET TAGS con ALTER TABLE per gestire i tag in una tabella. Per un elenco dei comandi DDL (Data Definition Language) disponibili e la loro sintassi, consultare le istruzioni indicate in .

Per i modelli registrati, è necessario usare Esplora cataloghi o MLflow ClientAPI. Vedere Usare i tag nei modelli.

Usare i tag per cercare tabelle

È possibile usare la barra di ricerca dell'area di lavoro di Azure Databricks per cercare tabelle, viste e colonne di tabella usando chiavi di tag e valori di tag. È possibile usare sia tag di tabella che tag di colonna di tabella. Non è possibile usare tag per cercare altri oggetti con tag, ad esempio cataloghi, schemi o volumi.

Nei risultati della ricerca vengono visualizzate solo le tabelle e le viste per cui si dispone dell'autorizzazione. Ciò significa che è necessario disporre almeno del privilegio BROWSE per l'oggetto (o per il catalogo e lo schema padre dell'oggetto) per restituire l'oggetto nei risultati della ricerca.

Per informazioni dettagliate, vedere Utilizzare tag per cercare tabelle.

Recuperare informazioni sui tag dalle tabelle dello schema delle informazioni

Ogni catalogo creato in Unity Catalog include un INFORMATION_SCHEMA. Questo schema include tabelle che descrivono gli oggetti noti al catalogo dello schema. Per visualizzare le informazioni sullo schema, è necessario disporre dei privilegi appropriati.

Per recuperare le informazioni sui tag, è possibile eseguire le seguenti query:

• INFORMATION_SCHEMA.CATALOG_TAGS
• INFORMATION_SCHEMA.COLUMN_TAGS
• INFORMATION_SCHEMA.SCHEMA_TAGS
• INFORMATION_SCHEMA.TABLE_TAGS
• INFORMATION_SCHEMA.VOLUME_TAGS

Per altre informazioni, vedere Schema delle informazioni.