Grupo de comandos users-v2

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer provisionamentos de Dados de Uso.

O users-v2 grupo de comandos dentro da CLI do Databricks permite que você gerencie identidades de usuário no workspace do Databricks. O Databricks recomenda usar o provisionamento SCIM para sincronizar usuários e grupos automaticamente do provedor de identidade para o workspace do Databricks.

databricks users-v2 create

Crie um novo usuário no workspace do Databricks. Esse novo usuário também será adicionado à conta do Databricks.

databricks users-v2 create [flags]

Argumentos

None

Opções

--active

    Se esse usuário estiver ativo.

--display-name string

    Cadeia de caracteres que representa uma concatenação de nomes dados e sobrenomes.

--external-id string

    ID externa. Não há suporte atualmente.

--id string

    ID do usuário do Databricks.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--user-name string

    Endereço de email do usuário do Databricks.

Sinalizadores globais

Exemplos

O exemplo a seguir cria um novo usuário:

databricks users-v2 create --user-name "user@example.com" --display-name "Test User"

databricks users-v2 delete

Excluir um usuário. Excluir um usuário de um workspace do Databricks também remove objetos associados ao usuário.

databricks users-v2 delete ID [flags]

Argumentos

ID

    ID exclusiva para um usuário no workspace do Databricks.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir exclui um usuário:

databricks users-v2 delete 12345678

databricks users-v2 get

Obtenha informações para um usuário específico no workspace do Databricks.

databricks users-v2 get ID [flags]

Argumentos

ID

    ID exclusiva para um usuário no workspace do Databricks.

Opções

--attributes string

    Lista separada por vírgulas de atributos a serem retornados em resposta.

--count int

    Número desejado de resultados por página.

--excluded-attributes string

    Lista separada por vírgulas de atributos a serem excluídos em resposta.

--filter string

    Consulta pela qual os resultados precisam ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order GetSortOrder

    A ordem para classificar os resultados. Valores com suporte: ascending, descending

--start-index int

    Especifica o índice do primeiro resultado.

Sinalizadores globais

Exemplos

O exemplo a seguir obtém detalhes do usuário:

databricks users-v2 get 12345678

lista databricks users-v2

Obtenha detalhes para todos os usuários associados a um workspace do Databricks.

databricks users-v2 list [flags]

Argumentos

None

Opções

--attributes string

    Lista separada por vírgulas de atributos a serem retornados em resposta.

--count int

    Número desejado de resultados por página.

--excluded-attributes string

    Lista separada por vírgulas de atributos a serem excluídos em resposta.

--filter string

    Consulta pela qual os resultados precisam ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order ListSortOrder

    A ordem para classificar os resultados. Valores com suporte: ascending, descending

--start-index int

    Especifica o índice do primeiro resultado.

Sinalizadores globais

Exemplos

O exemplo a seguir lista todos os usuários:

databricks users-v2 list

O exemplo a seguir lista os usuários que correspondem a um filtro:

databricks users-v2 list --filter "userName sw \"admin\""

patch databricks users-v2

Atualize parcialmente um recurso de usuário aplicando as operações fornecidas em atributos de usuário específicos.

databricks users-v2 patch ID [flags]

Argumentos

ID

    ID exclusiva no workspace do Databricks.

Opções

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

Sinalizadores globais

Exemplos

O exemplo a seguir corrige um usuário usando um arquivo JSON:

databricks users-v2 patch 12345678 --json @patch.json

databricks users-v2 update

Substitua as informações de um usuário pelos dados fornecidos na solicitação.

databricks users-v2 update ID [flags]

Argumentos

ID

    ID do usuário do Databricks.

Opções

--active

    Se esse usuário estiver ativo.

--display-name string

    Cadeia de caracteres que representa uma concatenação de nomes dados e sobrenomes.

--external-id string

    ID externa. Não há suporte atualmente.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--user-name string

    Endereço de email do usuário do Databricks.

Sinalizadores globais

Exemplos

O exemplo a seguir atualiza um usuário:

databricks users-v2 update 12345678 --display-name "Test User"

databricks users-v2 get-permission-levels

Obtenha níveis de permissão de senha que um usuário pode ter em um objeto.

databricks users-v2 get-permission-levels [flags]

Argumentos

None

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir obtém níveis de permissão de senha:

databricks users-v2 get-permission-levels

permissões de obtenção do databricks users-v2

Obtenha as permissões de todas as senhas. As senhas podem herdar permissões de seu objeto raiz.

databricks users-v2 get-permissions [flags]

Argumentos

None

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir obtém permissões de senha:

databricks users-v2 get-permissions

databricks users-v2 set-permissions

Defina permissões de senha em um objeto, substituindo as permissões existentes se elas existirem. Excluirá todas as permissões diretas se nenhuma for especificada. Os objetos podem herdar permissões de seu objeto raiz.

databricks users-v2 set-permissions [flags]

Argumentos

None

Opções

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

Sinalizadores globais

Exemplos

O exemplo a seguir define permissões de senha usando um arquivo JSON:

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

databricks users-v2 update-permissions

Atualize as permissões em todas as senhas. As senhas podem herdar permissões de seu objeto raiz.

databricks users-v2 update-permissions [flags]

Argumentos

None

Opções

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

Sinalizadores globais

Exemplos

O exemplo a seguir atualiza as permissões de senha usando um arquivo JSON:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo onde serão gravados os logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desabilitado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg, que deverá ser usado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado