external-locations gruppo di comandi

Il gruppo di comandi external-locations all'interno della CLI di Databricks contiene i comandi per creare e gestire posizioni esterne per Unity Catalog. Consulta Che cosa sono i volumi di Unity Catalog?.

creazione di databricks external-locations

Creare una nuova voce di posizione esterna nel metastore. Il chiamante deve essere un amministratore del metastore o avere il CREATE_EXTERNAL_LOCATION privilegio sia per il metastore che per le credenziali di archiviazione associate.

databricks external-locations create NAME URL CREDENTIAL_NAME [flags]

Arguments

NAME

    Nome della posizione esterna.

URL

    Percorso URL della posizione esterna.

CREDENTIAL_NAME

    Nome della credenziale di archiviazione utilizzata con questo percorso.

Options

--comment string

    Descrizione di testo in formato libero fornita dall'utente.

--enable-file-events

    Se abilitare o meno gli eventi di file in questa posizione esterna.

--fallback

    Indica se la modalità di fallback è abilitata per questo percorso esterno.

--json JSON

    Stringa JSON inline o nel @path file JSON con il corpo della richiesta.

--read-only

    Indica se la posizione esterna è di sola lettura.

--skip-validation

    Ignora la convalida delle credenziali di archiviazione associate alla posizione esterna.

Flag globali

Examples

L'esempio seguente crea una posizione esterna con un commento:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --comment "External location for data lake"

Nell'esempio seguente viene creata una posizione esterna di sola lettura:

databricks external-locations create my-external-location s3://my-bucket/path my-credential --read-only

eliminazione di databricks external-locations

Eliminare la location esterna specificata dal metastore. Il chiamante deve essere il proprietario della posizione esterna.

databricks external-locations delete NAME [flags]

Arguments

NAME

    Nome della posizione esterna.

Options

--force

    Forzare l'eliminazione anche se sono presenti tabelle o montaggi esterni dipendenti.

Flag globali

Examples

Nell'esempio seguente viene eliminata una posizione esterna denominata my-external-location:

databricks external-locations delete my-external-location

Nell'esempio seguente viene eliminata forzatamente una posizione esterna anche se sono presenti dipendenze:

databricks external-locations delete my-external-location --force

databricks external-locations get (comando per ottenere posizioni esterne)

Ottieni una posizione esterna dal metastore. Il chiamante deve essere un amministratore del metastore, il proprietario della posizione esterna o un utente con privilegi per la posizione esterna.

databricks external-locations get NAME [flags]

Arguments

NAME

    Nome della posizione esterna.

Options

--include-browse

    Indica se includere posizioni esterne nella risposta per le quali il principale può accedere solo ai metadati selezionati.

Flag globali

Examples

Nell'esempio seguente vengono recuperate informazioni su una posizione esterna denominata my-external-location:

databricks external-locations get my-external-location

Nell'esempio seguente vengono recuperate informazioni, inclusi i metadati di navigazione.

databricks external-locations get my-external-location --include-browse

elenco delle località esterne di databricks

Elencare i percorsi esterni dal metastore. Il chiamante deve essere un amministratore del metastore, il proprietario della posizione esterna o un utente con privilegi per la posizione esterna. Non esiste alcuna garanzia di un ordinamento specifico degli elementi nella matrice.

databricks external-locations list [flags]

Options

--include-browse

    Indica se includere posizioni esterne nella risposta per le quali il principale può accedere solo ai metadati selezionati.

--include-unbound

    Indica se includere percorsi esterni non associati all'area di lavoro.

--max-results int

    Numero massimo di posizioni esterne da restituire.

--page-token string

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

Flag globali

Examples

L'esempio seguente elenca tutti i percorsi esterni:

databricks external-locations list

L'esempio seguente elenca i percorsi esterni con un massimo di 10 risultati:

databricks external-locations list --max-results 10

aggiornamento delle posizioni esterne di Databricks

Aggiorna un percorso esterno nel metastore. Il chiamante deve essere il proprietario della posizione esterna o essere un amministratore del metastore. Nel secondo caso, l'amministratore può aggiornare solo il nome della posizione esterna.

databricks external-locations update NAME [flags]

Arguments

NAME

    Nome della posizione esterna.

Options

--comment string

    Descrizione di testo in formato libero fornita dall'utente.

--credential-name string

    Nome della credenziale di archiviazione utilizzata con questo percorso.

--enable-file-events

    Se abilitare o meno gli eventi di file in questa posizione esterna.

--fallback

    Indica se la modalità di fallback è abilitata per questo percorso esterno.

--force

    Forzare l'aggiornamento anche se la modifica dell'URL invalida le tabelle esterne dipendenti o i montaggi.

--isolation-mode IsolationMode

    Valori supportati: ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN

--json JSON

    Stringa JSON inline o nel @path file JSON con il corpo della richiesta.

--new-name string

    Nuovo nome per la posizione esterna.

--owner string

    Proprietario dell'ubicazione esterna.

--read-only

    Indica se la posizione esterna è di sola lettura.

--skip-validation

    Ignora la convalida delle credenziali di archiviazione associate alla posizione esterna.

--url string

    Percorso URL della posizione esterna.

Flag globali

Examples

Nell'esempio seguente viene rinominata una posizione esterna:

databricks external-locations update my-external-location --new-name my-renamed-location

Nell'esempio seguente viene modificato il proprietario di una posizione esterna:

databricks external-locations update my-external-location --owner someone@example.com

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 corda

    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 text formato del log o json. Il valore predefinito è text.

--log-level corda

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

tipo

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

-p, --profile corda

    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 corda

    Se applicabile, la destinazione del bundle da usare