Compartilhar via


Grupo de comandos users

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 grupo de comandos dentro da CLI do Databricks permite que você gerencie identidades de usuário em seu workspace do Databricks. As identidades de usuário reconhecidas pelo Databricks são representadas por endereços de email. Consulte Gerenciar usuários.

O Databricks recomenda usar o provisionamento SCIM para sincronizar usuários e grupos automaticamente do provedor de identidade para o workspace do Databricks. O SCIM simplifica a integração de um novo funcionário ou equipe usando seu provedor de identidade para criar usuários e grupos no workspace do Databricks e dar a eles o nível adequado de acesso. Quando um usuário sai da sua organização ou não precisa mais de acesso ao workspace do Databricks, os administradores podem encerrar o usuário em seu provedor de identidade e a conta desse usuário também será removida do workspace do Databricks. Isso garante um processo de desligamento consistente e impede que usuários não autorizados acessem dados confidenciais. Consulte Sincronizar usuários e grupos do Microsoft Entra ID usando SCIM.

criação de usuários do databricks

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

databricks users create [flags]

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

    No momento, não há suporte para ID externa.

--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

Examples

O exemplo a seguir cria um usuário com um nome de exibição e um email:

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

O exemplo a seguir cria um usuário usando JSON:

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

exclusão de usuários do databricks

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

databricks users delete ID [flags]

Arguments

ID

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

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um usuário por ID:

databricks users delete 12345

obter usuários do databricks

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

databricks users get ID [flags]

Arguments

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

Examples

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

databricks users get 12345

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

databricks users get 12345 --output json

lista de usuários do databricks

Liste os detalhes de todos os usuários associados a um workspace do Databricks.

databricks users list [flags]

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

Examples

O exemplo a seguir lista todos os usuários:

databricks users list

O exemplo a seguir lista os usuários com filtragem:

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

O exemplo a seguir apresenta a lista de usuários com paginação:

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

patch de usuários do Databricks

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

databricks users patch ID [flags]

Arguments

ID

    ID exclusivo 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

Examples

O exemplo a seguir corrige um usuário:

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

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

databricks users patch 12345 --json @update.json

Atualização dos usuários do Databricks

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

databricks users update ID [flags]

Arguments

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

    No momento, não há suporte para ID externa.

--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

Examples

O exemplo a seguir atualiza um usuário:

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

O exemplo a seguir atualiza um usuário usando JSON:

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

obter níveis de permissão de usuários do Databricks

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

databricks users get-permission-levels [flags]

Opções

Sinalizadores globais

Examples

O exemplo a seguir obtém níveis de permissão para os usuários:

databricks users get-permission-levels

O exemplo a seguir obtém níveis de permissão no formato JSON:

databricks users get-permission-levels --output json

permissões de usuários do databricks

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

databricks users get-permissions [flags]

Opções

Sinalizadores globais

Examples

O exemplo a seguir obtém permissões para usuários:

databricks users get-permissions

O exemplo a seguir obtém permissões no formato JSON:

databricks users get-permissions --output json

definir permissões para usuários do Databricks

Defina permissões de senha.

Define permissões 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 set-permissions [flags]

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

Examples

O exemplo a seguir define permissões usando JSON:

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

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

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

permissões de atualização para usuários do Databricks

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

databricks users update-permissions [flags]

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

Examples

O exemplo a seguir atualiza as permissões usando JSON:

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

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

databricks users 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 para o qual gravar 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 de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg para usar ao 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