external-metadata gruppo di comandi

Il external-metadata gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks contiene i comandi per registrare e gestire i metadati relativi ai sistemi esterni all'interno di Unity Catalog.

databricks external-metadata create-external-metadata

Creare un nuovo oggetto metadati esterno nel metastore padre se il chiamante è un amministratore del metastore o ha il privilegio CREATE_EXTERNAL_METADATA . Concede BROWSE a tutti gli utenti dell'account al momento della creazione per impostazione predefinita.

databricks external-metadata create-external-metadata NAME SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nome dell'oggetto metadati esterno.

SYSTEM_TYPE

    Tipo di sistema esterno. Valori supportati: AMAZON_REDSHIFT, AZURE_SYNAPSECONFLUENT, DATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, . WORKDAYMICROSOFT_FABRICMICROSOFT_SQL_SERVERMONGODBMYSQLORACLEOTHERPOSTGRESQLPOWER_BISALESFORCESAPSERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATA

ENTITY_TYPE

    Tipo di entità all'interno del sistema esterno.

Options

--description string

    Descrizione di testo in formato libero fornita dall'utente.

--json JSON

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

--owner string

    Proprietario dell'oggetto metadati esterno.

--url string

    URL associato all'oggetto metadati esterno.

Flag globali

Esempi

Nell'esempio seguente viene creato un oggetto metadati esterno per una tabella Snowflake:

databricks external-metadata create-external-metadata my_snowflake_table SNOWFLAKE TABLE --description "Production sales table" --url "https://example.snowflakecomputing.com/table/sales"

L'esempio seguente crea un oggetto metadati esterno usando JSON:

databricks external-metadata create-external-metadata tableau_dashboard TABLEAU DASHBOARD --json '{"description": "Sales dashboard", "owner": "user@example.com"}'

L'esempio seguente crea un oggetto metadati esterno usando un file JSON:

databricks external-metadata create-external-metadata bigquery_dataset GOOGLE_BIGQUERY DATASET --json @external-metadata.json

databricks external-metadata delete-external-metadata

Eliminare l'oggetto metadati esterno che corrisponde al nome specificato. Il chiamante deve essere un amministratore del metastore, il proprietario dell'oggetto metadati esterno o un utente con il privilegio MANAGE .

databricks external-metadata delete-external-metadata NAME [flags]

Arguments

NAME

    Nome dell'oggetto metadati esterno da eliminare.

Options

Flag globali

Esempi

Nell'esempio seguente viene eliminato un oggetto metadati esterno:

databricks external-metadata delete-external-metadata my_snowflake_table

databricks external-metadata get-external-metadata

Ottenere l'oggetto metadati esterno specificato in un metastore. Il chiamante deve essere un amministratore del metastore, il proprietario dell'oggetto metadati esterno o un utente che dispone del privilegio BROWSE .

databricks external-metadata get-external-metadata NAME [flags]

Arguments

NAME

    Nome dell'oggetto metadati esterno da ottenere.

Options

Flag globali

Esempi

L'esempio seguente ottiene un oggetto metadati esterno:

databricks external-metadata get-external-metadata my_snowflake_table

databricks external-metadata list-external-metadata

Elencare gli oggetti metadati esterni nel metastore. Se il chiamante è l'amministratore del metastore, verranno recuperati tutti gli oggetti metadati esterni. In caso contrario, verranno recuperati solo gli oggetti di metadati esterni su cui il chiamante dispone di BROWSE . Non esiste alcuna garanzia di un ordinamento specifico degli elementi nella matrice.

databricks external-metadata list-external-metadata [flags]

Options

--page-size int

    Numero massimo di oggetti metadati esterni da restituire per pagina.

--page-token string

    Token per recuperare la pagina successiva dei risultati.

Flag globali

Esempi

Nell'esempio seguente sono elencati tutti gli oggetti metadati esterni:

databricks external-metadata list-external-metadata

L'esempio seguente elenca gli oggetti metadati esterni con paginazione:

databricks external-metadata list-external-metadata --page-size 10

databricks external-metadata update-external-metadata

Aggiornare l'oggetto metadati esterno che corrisponde al nome specificato. Il chiamante può aggiornare solo il proprietario o altri campi di metadati in una richiesta. Il chiamante deve essere un amministratore del metastore, il proprietario dell'oggetto metadati esterno o un utente con privilegi MODIFY . Se il chiamante aggiorna il proprietario, deve avere anche il privilegio MANAGE .

databricks external-metadata update-external-metadata NAME UPDATE_MASK SYSTEM_TYPE ENTITY_TYPE [flags]

Arguments

NAME

    Nome dell'oggetto metadati esterno.

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.

SYSTEM_TYPE

    Tipo di sistema esterno. Valori supportati: AMAZON_REDSHIFT, AZURE_SYNAPSECONFLUENT, DATABRICKS, GOOGLE_BIGQUERY, KAFKA, LOOKER, . WORKDAYMICROSOFT_FABRICMICROSOFT_SQL_SERVERMONGODBMYSQLORACLEOTHERPOSTGRESQLPOWER_BISALESFORCESAPSERVICENOWSNOWFLAKESTREAM_NATIVETABLEAUTERADATA

ENTITY_TYPE

    Tipo di entità all'interno del sistema esterno.

Options

--description string

    Descrizione di testo in formato libero fornita dall'utente.

--json JSON

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

--owner string

    Proprietario dell'oggetto metadati esterno.

--url string

    URL associato all'oggetto metadati esterno.

Flag globali

Esempi

Nell'esempio seguente viene aggiornata la descrizione di un oggetto metadati esterno:

databricks external-metadata update-external-metadata my_snowflake_table "description" SNOWFLAKE TABLE --description "Updated production sales table"

Nell'esempio seguente viene aggiornato il proprietario di un oggetto metadati esterno:

databricks external-metadata update-external-metadata my_snowflake_table "owner" SNOWFLAKE TABLE --owner "newowner@example.com"

L'esempio seguente aggiorna un oggetto metadati esterno usando JSON:

databricks external-metadata update-external-metadata my_snowflake_table "description,url" SNOWFLAKE TABLE --json '{"description": "Latest sales data", "url": "https://example.snowflakecomputing.com/table/sales_v2"}'

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