Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 metastores gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire i metastore. Un metastore è il contenitore di primo livello degli oggetti nel catalogo unity. Archivia gli asset di dati (tabelle e viste) e le autorizzazioni che ne regolano l'accesso. Vedere Metastore.
Assegnare i metastore Databricks
Creare una nuova assegnazione di metastore. Se esiste un'assegnazione per la stessa workspace_id, verrà sovrascritta dalla nuova metastore_id e default_catalog_name. Il chiamante deve essere un amministratore dell'account.
databricks metastores assign WORKSPACE_ID METASTORE_ID DEFAULT_CATALOG_NAME [flags]
Arguments
WORKSPACE_ID
ID dell'area di lavoro.
METASTORE_ID
ID univoco del metastore.
DEFAULT_CATALOG_NAME
Deprecated. Usare l'API "Spazio dei nomi predefinito" per configurare il catalogo predefinito per un'area di lavoro di Databricks. Nome del catalogo predefinito nel metastore.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
Examples
L'esempio seguente assegna un metastore a un'area di lavoro:
databricks metastores assign 123456789 abc123-def456-ghi789 main
creazione di metastore di Databricks
Creare un nuovo metastore in base a un nome specificato e a un percorso radice di archiviazione facoltativo. Per impostazione predefinita (se il campo proprietario non è impostato), il proprietario del nuovo metastore è l'utente che chiama l'API createMetastore. Se il campo proprietario è impostato sulla stringa vuota (""), la proprietà viene assegnata all'utente di sistema.
databricks metastores create NAME [flags]
Arguments
NAME
Nome specificato dall'utente del metastore.
Options
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--region string
Area cloud usata dal metastore (ad esempio, us-west-2, westus).
--storage-root string
L'URL radice di memorizzazione per il metastore.
Examples
L'esempio seguente crea un metastore con un nome e una radice di archiviazione:
databricks metastores create my-metastore --storage-root s3://my-bucket/metastore-root --region us-west-2
databricks metastores corrente
Ottenere l'assegnazione del metastore per l'area di lavoro a cui si accede.
databricks metastores current [flags]
Options
Examples
L'esempio seguente ottiene l'assegnazione del metastore corrente:
databricks metastores current
eliminazione del metastore databricks
Eliminare un metastore. Il chiamante deve essere un amministratore del metastore.
databricks metastores delete ID [flags]
Arguments
ID
ID univoco del metastore.
Options
--force
Forzare l'eliminazione anche se il metastore non è vuoto.
Examples
"Questo esempio mostra come eliminare un metastore:"
databricks metastores delete abc123-def456-ghi789
L'esempio seguente elimina forzatamente un metastore anche se non è vuoto:
databricks metastores delete abc123-def456-ghi789 --force
ottenere i metastore di databricks
Ottieni un metastore che corrisponde all'ID fornito. Il chiamante deve essere un amministratore del metastore per recuperare queste informazioni.
databricks metastores get ID [flags]
Arguments
ID
ID univoco del metastore.
Options
Examples
L'esempio seguente ottiene informazioni su un metastore specifico:
databricks metastores get abc123-def456-ghi789
elenco dei metastore di Databricks
Elencare i metastore disponibili. Il chiamante deve essere un amministratore per recuperare queste informazioni. Non esiste alcuna garanzia di un ordinamento specifico degli elementi nell'elenco.
databricks metastores list [flags]
Options
--max-results int
Numero massimo di metastore da restituire.
--page-token string
Token di paginazione non trasparente per passare alla pagina successiva in base alla query precedente.
Examples
L'esempio seguente elenca tutti i metastore disponibili:
databricks metastores list
L'esempio seguente elenca i metastore con paginazione:
databricks metastores list --max-results 10 --page-token abc123token
Riepilogo dei metastore di Databricks
Ottieni informazioni di riepilogo su un metastore. Questo riepilogo include le credenziali di archiviazione, il fornitore del cloud, l'area cloud e l'ID metastore globale.
databricks metastores summary [flags]
Options
Examples
Si ottiene un riepilogo del metastore nell'esempio seguente.
databricks metastores summary
metastore databricks annulla l'assegnazione
Eliminare un'assegnazione di metastore. Il chiamante deve essere un amministratore account.
databricks metastores unassign WORKSPACE_ID METASTORE_ID [flags]
Arguments
WORKSPACE_ID
ID dell'area di lavoro.
METASTORE_ID
Richiedere l'ID del metastore da eliminare.
Options
Examples
Nell'esempio seguente viene annullata l'assegnazione di un metastore da un'area di lavoro:
databricks metastores unassign 123456789 abc123-def456-ghi789
aggiornamento dei Metastore Databricks
Aggiornare le informazioni per un metastore specifico. Il chiamante deve essere un amministratore del metastore. Se il campo proprietario è impostato sulla stringa vuota (""), la proprietà viene aggiornata all'utente di sistema.
databricks metastores update ID [flags]
Arguments
ID
ID univoco del metastore.
Options
--delta-sharing-organization-name string
Nome dell'organizzazione di un'entità di condivisione delta da usare in Databricks-to-Databricks Delta Sharing come nome ufficiale.
--delta-sharing-recipient-token-lifetime-in-seconds int
Durata del token del destinatario di condivisione differenziale in secondi.
--delta-sharing-scope DeltaSharingScopeEnum
Ambito della condivisione delta abilitata per il metastore. Valori supportati: INTERNAL, INTERNAL_AND_EXTERNAL
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--new-name string
Nuovo nome per il metastore.
--owner string
Proprietario del metastore.
--privilege-model-version string
Versione del modello di privilegi del metastore, nel formato major.minor (ad esempio, 1.0).
--storage-root-credential-id string
UUID delle credenziali di archiviazione per accedere al metastore storage_root.
Examples
L'esempio seguente aggiorna il nome di un metastore:
databricks metastores update abc123-def456-ghi789 --new-name my-updated-metastore
L'esempio seguente aggiorna un metastore con la configurazione di Condivisione Delta:
databricks metastores update abc123-def456-ghi789 --delta-sharing-scope INTERNAL_AND_EXTERNAL --delta-sharing-organization-name my-org
assegnazione di aggiornamenti dei metastore databricks
Aggiornare un'assegnazione del metastore. Questa operazione può essere usata per aggiornare metastore_id o default_catalog_name per un'area di lavoro specificata, se all'area di lavoro è già assegnato un metastore. Il chiamante deve essere un amministratore dell'account da aggiornare metastore_id; in caso contrario, il chiamante può essere un amministratore dell'area di lavoro.
databricks metastores update-assignment WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
ID dell'area di lavoro.
Options
--default-catalog-name string
Nome del catalogo predefinito nel metastore.
--json JSON
Stringa JSON inline o file JSON @path con il corpo della richiesta.
--metastore-id string
ID univoco del metastore.
Examples
L'esempio seguente aggiorna il catalogo predefinito di un'assegnazione metastore:
databricks metastores update-assignment 123456789 --default-catalog-name new-default-catalog
L'esempio seguente aggiorna l'ID metastore assegnato di un metastore:
databricks metastores update-assignment 123456789 --metastore-id new-metastore-id
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