entity-tag-assignments gruppo di comandi

Il entity-tag-assignments gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks contiene i comandi per creare, aggiornare, eliminare ed elencare le assegnazioni di tag tra le entità del catalogo Unity. I tag sono attributi che includono chiavi e valori facoltativi che è possibile usare per organizzare e classificare le entità in Unity Catalog. Vedi Applicare tag agli oggetti proteggibili del catalogo Unity.

creazione di entity-tag-assignments di databricks

Creare un'assegnazione di tag per un'entità catalogo Unity.

Per aggiungere tag alle entità del catalogo Unity, è necessario possedere l'entità o disporre dei privilegi seguenti:

• APPLY TAG sull'entità
• USE SCHEMA nello schema padre dell'entità
• USE CATALOG nel catalogo padre dell'entità

Per aggiungere un tag regolamentato alle entità del catalogo Unity, è necessario disporre anche dell'autorizzazione ASSIGN o MANAGE per i criteri di tag. Vedere Gestire le autorizzazioni dei criteri per i tag.

databricks entity-tag-assignments create ENTITY_NAME TAG_KEY ENTITY_TYPE [flags]

Arguments

ENTITY_NAME

    Nome completo dell'entità a cui è assegnato il tag.

TAG_KEY

    Chiave del tag.

ENTITY_TYPE

    Tipo dell'entità a cui è assegnato il tag. I valori consentiti sono: catalogs, schemastables, columns, , . volumes

Options

--json JSON

    La stringa JSON inline o @path nel file JSON con il corpo della richiesta

--tag-value string

    Il valore del tag.

Flag globali

Esempi

L'esempio seguente crea un'assegnazione di tag per una tabella:

databricks entity-tag-assignments create my_catalog.my_schema.my_table environment tables --tag-value production

L'esempio seguente crea un'assegnazione di tag usando JSON:

databricks entity-tag-assignments create my_catalog.my_schema.my_table department tables --json '{"tag_value": "finance"}'

eliminazione di entity-tag-assignments di databricks

Eliminare un'assegnazione di tag per un'entità del catalogo Unity in base alla relativa chiave.

Per eliminare i tag dalle entità del catalogo Unity, è necessario possedere l'entità o disporre dei privilegi seguenti:

• APPLY TAG sull'entità
• USE_SCHEMA nello schema padre dell'entità
• USE_CATALOG nel catalogo padre dell'entità

Per eliminare un tag regolamentato dalle entità del catalogo Unity, è necessario disporre anche dell'autorizzazione ASSIGN o MANAGE per i criteri di tag. Vedere Gestire le autorizzazioni dei criteri per i tag.

databricks entity-tag-assignments delete ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    Tipo dell'entità a cui è assegnato il tag. I valori consentiti sono: catalogs, schemastables, columns, , . volumes

ENTITY_NAME

    Nome completo dell'entità a cui è assegnato il tag.

TAG_KEY

    Chiave del tag da eliminare.

Options

Flag globali

Esempi

Nell'esempio seguente viene eliminata un'assegnazione di tag da una tabella:

databricks entity-tag-assignments delete tables my_catalog.my_schema.my_table environment

databricks entity-tag-assignments get

Ottenere un'assegnazione di tag per un'entità del catalogo Unity in base alla chiave del tag.

databricks entity-tag-assignments get ENTITY_TYPE ENTITY_NAME TAG_KEY [flags]

Arguments

ENTITY_TYPE

    Tipo dell'entità a cui è assegnato il tag. I valori consentiti sono: catalogs, schemastables, columns, , . volumes

ENTITY_NAME

    Nome completo dell'entità a cui è assegnato il tag.

TAG_KEY

    Chiave del tag.

Options

Flag globali

Esempi

L'esempio seguente ottiene un'assegnazione di tag per una tabella:

databricks entity-tag-assignments get tables my_catalog.my_schema.my_table environment

elenco entity-tag-assignments di databricks

Elencare le assegnazioni di tag per un'entità del catalogo Unity.

databricks entity-tag-assignments list ENTITY_TYPE ENTITY_NAME [flags]

Arguments

ENTITY_TYPE

    Tipo dell'entità a cui è assegnato il tag. I valori consentiti sono: catalogs, schemastables, columns, , . volumes

ENTITY_NAME

    Nome completo dell'entità a cui è assegnato il tag.

Options

--max-results int

    Numero massimo di risultati da restituire.

--page-token string

    Token per recuperare la pagina successiva dei risultati.

Flag globali

Esempi

Nell'esempio seguente vengono elencate tutte le assegnazioni di tag per una tabella:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table

L'esempio seguente elenca le assegnazioni di tag con la paginazione:

databricks entity-tag-assignments list tables my_catalog.my_schema.my_table --max-results 10

aggiornamento di entity-tag-assignments di databricks

Aggiornare un'assegnazione di tag esistente per un'entità catalogo Unity.

Per aggiornare i tag alle entità del catalogo Unity, è necessario possedere l'entità o disporre dei privilegi seguenti:

• APPLY TAG sull'entità
• USE SCHEMA nello schema padre dell'entità
• USE CATALOG nel catalogo padre dell'entità

Per aggiornare un tag regolamentato alle entità del catalogo Unity, è necessario disporre anche dell'autorizzazione ASSIGN o MANAGE per i criteri di tag. Vedere Gestire le autorizzazioni dei criteri per i tag.

databricks entity-tag-assignments update ENTITY_TYPE ENTITY_NAME TAG_KEY UPDATE_MASK [flags]

Arguments

ENTITY_TYPE

    Tipo dell'entità a cui è assegnato il tag. I valori consentiti sono: catalogs, schemastables, columns, , . volumes

ENTITY_NAME

    Nome completo dell'entità a cui è assegnato il tag.

TAG_KEY

    Chiave del tag.

UPDATE_MASK

    La maschera di campo deve essere una singola stringa, con più campi separati da virgole (senza spazi). Il percorso del campo è relativo all'oggetto risorsa, usando un punto (.) per esplorare i sottocampi ,ad esempio author.given_name. La specifica degli elementi nei campi sequenza o mappa non è consentita, perché è possibile specificare solo l'intero campo della raccolta. I nomi dei campi devono corrispondere esattamente ai nomi dei campi delle risorse.

    Una maschera di campo asterisco (*) indica la sostituzione completa. È consigliabile elencare sempre in modo esplicito i campi da aggiornare ed evitare di usare caratteri jolly, in quanto può causare risultati imprevisti se l'API cambia in futuro.

Options

--json JSON

    La stringa JSON inline o @path nel file JSON con il corpo della richiesta

--tag-value string

    Il valore del tag.

Flag globali

Esempi

L'esempio seguente aggiorna un'assegnazione di tag per una tabella:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --tag-value staging

L'esempio seguente aggiorna un'assegnazione di tag usando JSON:

databricks entity-tag-assignments update tables my_catalog.my_schema.my_table environment "tag_value" --json '{"tag_value": "development"}'

Bandiere globali

--debug

  Indica se abilitare la registrazione di debug.

-h oppure --help

    Mostra la guida per il Databricks CLI, il gruppo di comandi correlato o il comando correlato.

--log-file stringa

    Stringa che rappresenta il file in cui scrivere i log di output. Se questo flag non viene specificato, l'impostazione predefinita prevede la scrittura dei log di output su stderr.

--log-format formato

    Tipo di formato del log, text o json. Il valore predefinito è text.

--log-level stringa

    Stringa che rappresenta il livello di formato del log. Se non specificato, il livello di formato del log è disabilitato.

tipo

    Tipo di output del comando, text o json. Il valore predefinito è text.

-p, --profile stringa

    Nome del profilo nel ~/.databrickscfg file da usare per eseguire il comando . Se questo flag non viene specificato, se esiste, viene usato il profilo denominato DEFAULT .

--progress-format formato

    Formato per visualizzare i log di stato: default, append, inplaceo json

-t, --target stringa

    Se applicabile, la destinazione del bundle da utilizzare