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 credentials gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire le credenziali per l'accesso ai servizi nel tenant cloud. Ogni credenziale è soggetta ai criteri di controllo di accesso del catalogo Unity che controllano quali utenti e gruppi possono accedere alle credenziali.

Una credenziale rappresenta un meccanismo di autenticazione e autorizzazione per l'accesso ai servizi nel tenant cloud. Per creare le credenziali, è necessario essere un amministratore dell'account Databricks o avere il CREATE SERVICE CREDENTIAL privilegio . L'utente che crea le credenziali può delegare la proprietà a un altro utente o gruppo per gestire le autorizzazioni.

credenziali di databricks create-credential

Creare una nuova credenziale. Il tipo di credenziale da creare è determinato dal purpose campo , che deve essere SERVICE o STORAGE.

Il chiamante deve essere un amministratore del metastore o avere il privilegio CREATE_STORAGE_CREDENTIAL del metastore per le credenziali di archiviazione o CREATE_SERVICE_CREDENTIAL per le credenziali del servizio.

databricks credentials create-credential 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 oppure @path nel file JSON contenente il corpo della richiesta

--purpose CredentialPurpose

    Indica lo scopo della credenziale. Valori supportati: SERVICE, STORAGE

--read-only

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

--skip-validation

    Optional

Flag globali

Examples

L'esempio seguente crea una credenziale del servizio denominata my-service-cred:

databricks credentials create-credential my-service-cred --purpose SERVICE

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

databricks credentials create-credential readonly-storage --purpose STORAGE --read-only

databricks credenziali elimina-credenziale

Eliminare un servizio o credenziali di archiviazione dal metastore. Il chiamante deve essere un proprietario della credenziale.

databricks credentials delete-credential NAME_ARG [flags]

Arguments

NAME_ARG

    Nome della credenziale

Options

--force

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

Flag globali

Examples

Nell'esempio seguente viene eliminata una credenziale denominata my-service-cred:

databricks credentials delete-credential my-service-cred

Nell'esempio seguente viene forzata l'eliminazione di una credenziale con dipendenze:

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

credenziali di databricks generate-temporary-service-credential

Generare credenziali temporanee del servizio usando le credenziali del servizio specificate. Il chiamante deve essere un amministratore del metastore o avere il privilegio ACCESS del metastore per le credenziali del servizio.

databricks credentials generate-temporary-service-credential CREDENTIAL_NAME [flags]

Arguments

CREDENTIAL_NAME

    Nome delle credenziali del servizio usate per generare credenziali temporanee

Options

--json JSON

    Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta

Flag globali

Examples

L'esempio seguente genera credenziali temporanee per una credenziale del servizio:

databricks credentials generate-temporary-service-credential my-service-cred

databricks get-credential per le credenziali

Ottenere una credenziale di servizio o di archiviazione dal metastore. Il chiamante deve essere un amministratore del metastore, il proprietario della credenziale o disporre di qualsiasi autorizzazione sulla credenziale.

databricks credentials get-credential NAME_ARG [flags]

Arguments

NAME_ARG

    Nome della credenziale

Options

Flag globali

Examples

L'esempio seguente ottiene informazioni su una credenziale denominata my-service-cred:

databricks credentials get-credential my-service-cred

elenco-credenziali-databricks

Elencare le credenziali. L'elenco è limitato solo alle credenziali 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 credentials list-credentials [flags]

Options

--max-results int

    Numero massimo di credenziali da restituire

--page-token string

    Token opaco per recuperare la pagina successiva dei risultati

--purpose CredentialPurpose

    Restituisce solo le credenziali per lo scopo specificato. Valori supportati: SERVICE, STORAGE

Flag globali

Examples

L'esempio seguente elenca tutte le credenziali:

databricks credentials list-credentials

L'esempio seguente elenca solo le credenziali del servizio:

databricks credentials list-credentials --purpose SERVICE

L'esempio seguente elenca le credenziali con un massimo di 10 risultati:

databricks credentials list-credentials --max-results 10

aggiorna credenziali di databricks

Aggiornare un servizio o una credenziale di archiviazione nel metastore.

Il chiamante deve essere il proprietario delle credenziali o un amministratore del metastore o disporre dell'autorizzazione MANAGE . Se il chiamante è un amministratore del metastore, è possibile modificare solo il owner campo.

databricks credentials update-credential NAME_ARG [flags]

Arguments

NAME_ARG

    Nome della credenziale

Options

--comment string

    Commento associato alle credenziali

--force

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

--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 oppure @path nel file JSON contenente il corpo della richiesta

--new-name string

    Nuovo nome delle credenziali

--owner string

    Nome utente del proprietario corrente delle credenziali

--read-only

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

--skip-validation

    Fornire true a questo argomento per ignorare la convalida delle credenziali aggiornate

Flag globali

Examples

L'esempio seguente aggiorna il commento di una credenziale:

databricks credentials update-credential my-service-cred --comment "Updated service credential"

L'esempio seguente rinomina una credenziale:

databricks credentials update-credential my-service-cred --new-name my-renamed-cred

L'esempio seguente modifica il proprietario di una credenziale:

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

L'esempio seguente rende di sola lettura le credenziali:

databricks credentials update-credential my-storage-cred --read-only

credenziali validate-credential di databricks

Convalidare una credenziale.

Per le credenziali del servizio, il cui scopo è SERVICE, è necessario fornire o le credenziali del credential_name o quelle specifiche del cloud.

Per le credenziali di archiviazione (scopo è STORAGE), è necessario specificare almeno uno di external_location_name e url . 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 credential_name.

Il chiamante deve essere un amministratore del metastore o il proprietario delle credenziali o avere l'autorizzazione necessaria per il metastore e le credenziali (ad esempio, CREATE_EXTERNAL_LOCATION quando lo scopo è STORAGE).

databricks credentials validate-credential [flags]

Options

--credential-name string

    Required

--external-location-name string

    Nome di una posizione esterna esistente da convalidare

--json JSON

    Stringa JSON inline oppure @path nel file JSON contenente il corpo della richiesta

--purpose CredentialPurpose

    Scopo della credenziale. Valori supportati: SERVICE, STORAGE

--read-only

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

--url string

    URL della posizione esterna da convalidare

Flag globali

Examples

Nell'esempio seguente viene convalidata una credenziale del servizio:

databricks credentials validate-credential --credential-name my-service-cred --purpose SERVICE

L'esempio seguente convalida una credenziale di archiviazione con un percorso esterno:

databricks credentials validate-credential --credential-name my-storage-cred --purpose STORAGE --external-location-name my-external-location

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