Condividi tramite


storage-credentials 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 storage-credentials gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks contiene i comandi per gestire le credenziali di archiviazione in Unity Catalog. Una credenziale di archiviazione rappresenta un meccanismo di autenticazione e autorizzazione per l'accesso ai dati archiviati nel tenant cloud. Ogni credenziale di archiviazione è soggetta ai criteri di controllo di accesso di Unity Catalog che controllano quali utenti e gruppi possono accedere alle credenziali. Se un utente non ha accesso a credenziali di archiviazione nel catalogo unity, la richiesta ha esito negativo e Il catalogo Unity non tenta di eseguire l'autenticazione nel tenant cloud per conto dell'utente. Vedere Gestire le credenziali di archiviazione.

databricks storage-credentials create

Creare una nuova credenziale di archiviazione.

Il chiamante deve essere un amministratore del metastore o avere il CREATE_STORAGE_CREDENTIAL privilegio sul metastore.

databricks storage-credentials create NAME [flags]

Arguments

NAME

    Nome delle credenziali. Il nome deve essere univoco tra le credenziali di archiviazione e servizio all'interno del metastore.

Options

--comment string

    Commento associato alle credenziali.

--json JSON

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

--read-only

    Indica se la credenziale è utilizzabile solo per le operazioni di lettura.

--skip-validation

    Se si specifica true a questo argomento, la convalida della credenziale creata viene saltata.

Flag globali

Examples

L'esempio seguente crea una nuova credenziale di archiviazione:

databricks storage-credentials create my-storage-credential

L'esempio seguente crea una credenziale di archiviazione con un commento:

databricks storage-credentials create my-storage-credential --comment "S3 credential for analytics data"

L'esempio seguente crea una credenziale di archiviazione di sola lettura:

databricks storage-credentials create my-storage-credential --read-only

databricks elimina credenziali-di-archiviazione

Eliminare una credenziale di archiviazione dal metastore. Il chiamante deve essere proprietario delle credenziali di archiviazione.

databricks storage-credentials delete NAME [flags]

Arguments

NAME

    Nome della credenziale di archiviazione.

Options

--force

    Forzare un aggiornamento anche se sono presenti percorsi esterni dipendenti o tabelle esterne (quando lo scopo è STORAGE) o servizi dipendenti (quando lo scopo è SERVICE).

Flag globali

Examples

L'esempio seguente elimina una credenziale di archiviazione:

databricks storage-credentials delete my-storage-credential

L'esempio seguente forza l'eliminazione di una credenziale di archiviazione:

databricks storage-credentials delete my-storage-credential --force

databricks storage-credentials get

Ottieni le credenziali di archiviazione dal metastore. Il chiamante deve essere un amministratore del metastore, il proprietario delle credenziali di archiviazione o avere alcune autorizzazioni per le credenziali di archiviazione.

databricks storage-credentials get NAME [flags]

Arguments

NAME

    Nome della credenziale di archiviazione.

Options

Flag globali

Examples

L'esempio seguente ottiene informazioni su una credenziale di archiviazione:

databricks storage-credentials get my-storage-credential

elenco di credenziali di archiviazione di databricks

Elencare le credenziali di archiviazione. L'elenco è limitato solo a quelle credenziali di archiviazione a cui il chiamante ha l'autorizzazione per accedere. Se il chiamante è un amministratore del metastore, il recupero delle credenziali non è limitato. Non esiste alcuna garanzia di un ordinamento specifico degli elementi nella matrice.

databricks storage-credentials list [flags]

Options

--max-results int

    Numero massimo di credenziali di archiviazione da restituire.

--page-token string

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

Flag globali

Examples

L'esempio seguente elenca tutte le credenziali di archiviazione:

databricks storage-credentials list

aggiornamento delle credenziali di archiviazione di databricks

Aggiornare le credenziali di archiviazione nel metastore.

Il chiamante deve essere il proprietario delle credenziali di archiviazione o un amministratore del metastore. Se il chiamante è un amministratore del metastore, è possibile modificare solo il owner campo.

databricks storage-credentials update NAME [flags]

Arguments

NAME

    Nome della credenziale di archiviazione.

Options

--comment string

    Commento associato alle credenziali.

--force

    Forzare l'aggiornamento anche se sono presenti percorsi esterni dipendenti o tabelle esterne.

--isolation-mode IsolationMode

    Indica se l'elemento protetto corrente è accessibile da tutte le aree di lavoro o da un set specifico di aree di lavoro. Valori supportati: [ISOLATION_MODE_ISOLATED, ISOLATION_MODE_OPEN]

--json JSON

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

--new-name string

    Nuovo nome per le credenziali di archiviazione.

--owner string

    Nome utente del proprietario corrente delle credenziali.

--read-only

    Indica se la credenziale è utilizzabile solo per le operazioni di lettura.

--skip-validation

    Se si specifica true a questo argomento, viene saltata la convalida della credenziale aggiornata.

Flag globali

Examples

L'esempio seguente aggiorna il commento delle credenziali di archiviazione:

databricks storage-credentials update my-storage-credential --comment "Updated S3 credential"

Nell'esempio seguente viene modificato il proprietario di una credenziale di archiviazione:

databricks storage-credentials update my-storage-credential --owner someone@example.com

L'esempio seguente rinomina una credenziale di archiviazione:

databricks storage-credentials update my-storage-credential --new-name updated-credential

convalidare le credenziali di archiviazione di databricks

Convalidare le credenziali di archiviazione. Almeno uno di external_location_name e url deve essere fornito. Se ne viene fornita una sola, verrà usata per la convalida. Se vengono forniti entrambi, verrà url usato per la convalida e external_location_name verrà ignorato durante il controllo degli URL sovrapposti.

È necessario fornire le credenziali specifiche del cloud o le storage_credential_name.

Il chiamante deve essere un amministratore del metastore o il proprietario delle credenziali di archiviazione o avere il CREATE_EXTERNAL_LOCATION privilegio per il metastore e le credenziali di archiviazione.

databricks storage-credentials validate [flags]

Options

--external-location-name string

    Nome di una posizione esterna esistente da convalidare.

--json JSON

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

--read-only

    Indica se le credenziali di archiviazione sono utilizzabili solo per le operazioni di lettura.

--storage-credential-name string

    Required.

--url string

    URL dell'indirizzo esterno da convalidare.

Flag globali

Examples

Nell'esempio seguente viene convalidata una credenziale di archiviazione in una posizione esterna:

databricks storage-credentials validate --storage-credential-name my-storage-credential --external-location-name my-external-location

Nell'esempio seguente viene convalidata una credenziale di archiviazione rispetto a un URL:

databricks storage-credentials validate --storage-credential-name my-storage-credential --url s3://my-bucket/path

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