tables gruppo di comandi

Note

Queste informazioni si applicano all'interfaccia della riga di comando di Databricks versione 0.205 e successive. L'interfaccia della riga di comando di Databricks è disponibile in anteprima pubblica.

L'uso della CLI di Databricks è soggetto alla Licenza di Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

Il tables gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks contiene i comandi per gestire le tabelle in Unity Catalog. Una tabella si trova nel terzo livello dello spazio dei nomi a tre livelli di Unity Catalog. Contiene righe di dati.

Cancellazione delle tabelle Databricks

Eliminare una tabella dal catalogo padre e dallo schema specificati. Il chiamante deve essere il proprietario del catalogo padre, avere il USE_CATALOG privilegio per il catalogo padre e essere il proprietario dello schema padre oppure essere il proprietario della tabella e avere il USE_CATALOG privilegio per il catalogo padre e il USE_SCHEMA privilegio per lo schema padre.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo della tabella.

Options

Flag globali

Examples

Nell'esempio seguente viene eliminata una tabella:

databricks tables delete my_catalog.my_schema.my_table

Le tabelle di Databricks esistono

Ottiene un valore che indica se una tabella esiste nel metastore per un catalogo e uno schema specifici. Il chiamante deve soddisfare uno dei requisiti seguenti:

• Diventa un amministratore del metastore
• Essere proprietario del catalogo principale
• Essere proprietario dello schema padre e possedere il privilegio USE_CATALOG sul catalogo padre
• Avere il USE_CATALOG privilegio sul catalogo padre e il USE_SCHEMA privilegio sullo schema padre, ed essere il proprietario della tabella o avere il SELECT privilegio sulla tabella.
• Disporre BROWSE dei privilegi sul catalogo padre
• Disporre BROWSE del privilegio sullo schema padre.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo della tabella.

Options

Flag globali

Examples

Nell'esempio seguente viene verificato se esiste una tabella:

databricks tables exists my_catalog.my_schema.my_table

Ottenere le tabelle di databricks

Ottenere una tabella dal metastore per un catalogo e uno schema specifici. Il chiamante deve soddisfare uno dei requisiti seguenti:

• Diventa un amministratore del metastore
• Essere proprietario del catalogo principale
• Essere proprietario dello schema padre e possedere il privilegio USE_CATALOG sul catalogo padre
• Avere il USE_CATALOG privilegio sul catalogo padre e il USE_SCHEMA privilegio sullo schema padre, ed essere il proprietario della tabella o avere il SELECT privilegio sulla tabella.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    Nome completo della tabella.

Options

--include-browse

    Decidere se includere tabelle nella risposta per le quali il principale può accedere solo ai metadati selettivi.

--include-delta-metadata

    Indica se i metadati delta devono essere inclusi nella risposta.

--include-manifest-capabilities

    Indica se includere un manifesto contenente le funzionalità della tabella.

Flag globali

Examples

Nell'esempio seguente vengono recuperate informazioni su una tabella:

databricks tables get my_catalog.my_schema.my_table

L'esempio seguente ottiene una tabella con metadati differenziali inclusi:

databricks tables get my_catalog.my_schema.my_table --include-delta-metadata

Elenco di tabelle di Databricks

Elenca tutte le tabelle del metastore attuale nel catalogo principale e nello schema. Il chiamante deve essere un amministratore del metastore o un proprietario della tabella, oppure avere il SELECT privilegio sulla tabella. Per il secondo caso, il chiamante deve anche essere il proprietario o avere il USE_CATALOG privilegio sul catalogo padre e il USE_SCHEMA privilegio sullo schema padre. Non esiste alcuna garanzia di un ordinamento specifico degli elementi nella matrice.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Nome del catalogo padre per le tabelle di interesse.

SCHEMA_NAME

    Schema padre delle tabelle.

Options

--include-browse

    Decidere se includere tabelle nella risposta per le quali il principale può accedere solo ai metadati selettivi.

--include-delta-metadata

    Indica se i metadati delta devono essere inclusi nella risposta.

--include-manifest-capabilities

    Indica se includere un manifesto contenente le funzionalità della tabella.

--max-results int

    Numero massimo di tabelle da restituire.

--omit-columns

    Indica se omettere o meno le colonne della tabella dalla risposta.

--omit-properties

    Indica se omettere o meno le proprietà della tabella dalla risposta.

--omit-username

    Se omettere il nome utente della tabella ,ad esempio

--page-token string

    Token opaco da inviare per la pagina successiva dei risultati (paginazione).

Flag globali

Examples

Nell'esempio seguente vengono elencate tutte le tabelle in un catalogo e uno schema:

databricks tables list my_catalog my_schema

L'esempio seguente elenca le tabelle con colonne omesse:

databricks tables list my_catalog my_schema --omit-columns

Riepilogo elenco tabelle di Databricks

Elencare i riepiloghi per le tabelle per uno schema e un catalogo all'interno del metastore. I riepiloghi della tabella restituiti sono i seguenti:

• riepiloghi per le tabelle (all'interno del metastore corrente e del catalogo padre e dello schema), quando l'utente è un amministratore del metastore,
• o riepiloghi per tabelle e schema (all'interno del metastore corrente e del catalogo padre) per i quali l'utente ha la proprietà o il SELECT privilegio sulla tabella e la proprietà o il USE_SCHEMA privilegio sullo schema, purché l'utente abbia anche la proprietà o il USE_CATALOG privilegio sul catalogo padre.

Non esiste alcuna garanzia di un ordinamento specifico degli elementi nella matrice.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Nome del catalogo padre per le tabelle di interesse.

Options

--include-manifest-capabilities

    Indica se includere un manifesto contenente le funzionalità della tabella.

--max-results int

    Numero massimo di riepiloghi per le tabelle da restituire.

--page-token string

    Token di paginazione non trasparente per passare alla pagina successiva in base alla query precedente.

--schema-name-pattern string

    Modello SQL LIKE (% e _) per i nomi degli schemi.

--table-name-pattern string

    Modello SQL LIKE (% e _) per i nomi delle tabelle.

Flag globali

Examples

Nell'esempio seguente sono elencati i riepiloghi delle tabelle per un catalogo:

databricks tables list-summaries my_catalog

L'esempio seguente elenca i riepiloghi delle tabelle con il modello di nome dello schema:

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

L'esempio seguente elenca i riepiloghi delle tabelle con il modello di nome tabella:

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

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