Condividi tramite


users 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 users gruppo di comandi all'interno dell'interfaccia della riga di comando di Databricks consente di gestire le identità utente nell'area di lavoro di Databricks. Le identità utente riconosciute da Databricks sono rappresentate dagli indirizzi di posta elettronica. Vedere Gestire gli utenti.

Databricks consiglia di usare il provisioning SCIM per sincronizzare automaticamente utenti e gruppi dal provider di identità all'area di lavoro di Databricks. SCIM semplifica l'onboarding di un nuovo dipendente o team usando il provider di identità per creare utenti e gruppi nell'area di lavoro di Databricks e concedere loro il livello di accesso appropriato. Quando un utente lascia l'organizzazione o non ha più bisogno dell'accesso all'area di lavoro di Databricks, gli amministratori possono terminare l'utente nel provider di identità e l'account dell'utente verrà rimosso anche dall'area di lavoro di Databricks. In questo modo, si garantisce un processo di offboarding coerente e impedisce agli utenti non autorizzati di accedere ai dati sensibili. Consulta Sincronizzare utenti e gruppi da Microsoft Entra ID utilizzando SCIM.

Utenti di Databricks creano

Creare un nuovo utente nell'area di lavoro di Databricks. Questo nuovo utente verrà aggiunto anche all'account Databricks.

databricks users create [flags]

Options

--active

    Se l'utente è attivo.

--display-name string

    Stringa che rappresenta una concatenazione di nomi propri e cognomi.

--external-id string

    L'ID esterno non è attualmente supportato.

--id string

    ID utente di Databricks.

--json JSON

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

--user-name string

    Indirizzo di posta elettronica dell'utente di Databricks.

Flag globali

Examples

L'esempio seguente crea un utente con un nome visualizzato e un messaggio di posta elettronica:

databricks users create --display-name "John Doe" --user-name "someone@example.com"

L'esempio seguente crea un utente usando JSON:

databricks users create --json '{"display_name": "John Doe", "user_name": "someone@example.com", "active": true}'

Gli utenti di Databricks eliminano

Eliminare un utente. L'eliminazione di un utente da un'area di lavoro di Databricks rimuove anche gli oggetti associati all'utente.

databricks users delete ID [flags]

Arguments

ID

    ID univoco per un utente nell'area di lavoro Databricks.

Options

Flag globali

Examples

Nell'esempio seguente viene eliminato un utente in base all'ID:

databricks users delete 12345

Gli utenti di Databricks ottengono

Ottenere informazioni per un utente specifico nell'area di lavoro databricks.

databricks users get ID [flags]

Arguments

ID

    ID univoco per un utente nell'area di lavoro Databricks.

Options

--attributes string

    Elenco delimitato da virgole di attributi da restituire in risposta.

--count int

    Numero desiderato di risultati per pagina.

--excluded-attributes string

    Elenco delimitato da virgole di attributi da escludere in risposta.

--filter string

    Query in base alla quale devono essere filtrati i risultati.

--sort-by string

    Attributo per ordinare i risultati.

--sort-order GetSortOrder

    Ordinamento dei risultati. Valori supportati: ascending, descending

--start-index int

    Specifica l'indice del primo risultato.

Flag globali

Examples

L'esempio seguente ottiene i dettagli di un utente.

databricks users get 12345

L'esempio seguente ottiene i dettagli dell'utente in formato JSON:

databricks users get 12345 --output json

elenco di utenti di databricks

Elencare i dettagli per tutti gli utenti associati a un'area di lavoro di Databricks.

databricks users list [flags]

Options

--attributes string

    Elenco delimitato da virgole di attributi da restituire in risposta.

--count int

    Numero desiderato di risultati per pagina.

--excluded-attributes string

    Elenco delimitato da virgole di attributi da escludere in risposta.

--filter string

    Query in base alla quale devono essere filtrati i risultati.

--sort-by string

    Attributo per ordinare i risultati.

--sort-order ListSortOrder

    Ordinamento dei risultati. Valori supportati: ascending, descending

--start-index int

    Specifica l'indice del primo risultato.

Flag globali

Examples

L'esempio seguente elenca tutti gli utenti:

databricks users list

L'esempio seguente elenca gli utenti con filtro:

databricks users list --filter "userName eq 'someone@example.com'"

L'esempio seguente elenca gli utenti con paginazione:

databricks users list --count 10 --start-index 0

Patch per gli utenti di databricks

Aggiornare parzialmente una risorsa utente applicando le operazioni fornite su attributi utente specifici.

databricks users patch ID [flags]

Arguments

ID

    ID univoco dell'area di lavoro Databricks.

Options

--json JSON

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

Flag globali

Examples

L'esempio seguente applica patch a un utente:

databricks users patch 12345 --json '{"display_name": "Jane Doe"}'

L'esempio seguente applica patch a un utente usando un file JSON:

databricks users patch 12345 --json @update.json

Aggiornamento degli utenti di databricks

Sostituire le informazioni di un utente con i dati forniti nella richiesta.

databricks users update ID [flags]

Arguments

ID

    ID utente di Databricks.

Options

--active

    Se l'utente è attivo.

--display-name string

    Stringa che rappresenta una concatenazione di nomi propri e cognomi.

--external-id string

    L'ID esterno non è attualmente supportato.

--id string

    ID utente di Databricks.

--json JSON

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

--user-name string

    Indirizzo di posta elettronica dell'utente di Databricks.

Flag globali

Examples

L'esempio seguente aggiorna un utente:

databricks users update 12345 --display-name "Jane Doe" --user-name "new-someone@example.com" --active

L'esempio seguente aggiorna un utente usando JSON:

databricks users update 12345 --json '{"display_name": "Jane Doe", "user_name": "new-someone@example.com", "active": true}'

utenti databricks ottieni-livelli-di-permesso

Ottenere i livelli di autorizzazione che un utente può avere su un oggetto .

databricks users get-permission-levels [flags]

Options

Flag globali

Examples

L'esempio seguente ottiene i livelli di autorizzazione per gli utenti:

databricks users get-permission-levels

L'esempio seguente ottiene i livelli di autorizzazione in formato JSON:

databricks users get-permission-levels --output json

Gli utenti di databricks ottengono le autorizzazioni

Ottenere le autorizzazioni di tutte le password. Le password possono ereditare le autorizzazioni dal relativo oggetto radice.

databricks users get-permissions [flags]

Options

Flag globali

Examples

L'esempio seguente ottiene le autorizzazioni per gli utenti:

databricks users get-permissions

L'esempio seguente ottiene le autorizzazioni in formato JSON:

databricks users get-permissions --output json

impostazione delle autorizzazioni per gli utenti di Databricks

Impostare le autorizzazioni per la password.

Imposta le autorizzazioni per un oggetto, sostituendo le autorizzazioni esistenti, se esistenti. Elimina tutte le autorizzazioni dirette se non è specificato alcuno. Gli oggetti possono ereditare le autorizzazioni dal relativo oggetto radice.

databricks users set-permissions [flags]

Options

--json JSON

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

Flag globali

Examples

L'esempio seguente imposta le autorizzazioni usando JSON:

databricks users set-permissions --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'

L'esempio seguente imposta le autorizzazioni usando un file JSON:

databricks users set-permissions --json @permissions.json

Permessi di aggiornamento degli utenti di Databricks

Aggiornare le autorizzazioni per tutte le password. Le password possono ereditare le autorizzazioni dal relativo oggetto radice.

databricks users update-permissions [flags]

Options

--json JSON

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

Flag globali

Examples

L'esempio seguente aggiorna le autorizzazioni usando JSON:

databricks users update-permissions --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'

L'esempio seguente aggiorna le autorizzazioni usando un file JSON:

databricks users update-permissions --json @permissions.json

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