Applicare tag a oggetti a protezione diretta di Unity Catalog

Articolo
11/22/2024

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 classificare oggetti a protezione diretta in 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 a protezione diretta è attualmente supportata in cataloghi, schemi, tabelle, colonne di tabella, volumi, viste, modelli registrati e versioni del modello. Per ulteriori informazioni sugli oggetti a protezione diretta, vedere Oggetti a protezione diretta 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 nello schema padre dell'oggetto
USE CATALOG nel catalogo padre dell'oggetto

Vincoli

Di seguito è riportato un elenco di vincoli dei 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 o nei valori 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 Esplora cataloghi

Per aggiungere e aggiornare un oggetto a protezione diretta usando Esplora cataloghi:

Fare clic su Catalogo nella barra laterale.
Selezionare un oggetto a protezione diretta.
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 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. Vedere Istruzioni DDL per un elenco dei comandi DDL (Data Definition Language) disponibili e la relativa sintassi.

Per i modelli registrati, è necessario usare Esplora cataloghi oppure 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 sia 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 compaiono solo le tabelle e le viste che l'utente è autorizzato a visualizzare. 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 Usare i tag per cercare tabelle.

Recuperare informazioni sui tag dalle tabelle dello schema delle informazioni

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

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

Per altre informazioni, vedere Schema delle informazioni.

Condividi tramite