Partilhar via


users grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-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 disposições de Dados de Uso.

O users grupo de comandos dentro da CLI Databricks permite-lhe gerir identidades de utilizador no seu espaço de trabalho Databricks. As identidades de usuário reconhecidas pelo Databricks são representadas por endereços de e-mail. Consulte Gerenciar usuários.

O Databricks recomenda o uso do provisionamento SCIM para sincronizar usuários e grupos automaticamente do seu provedor de identidade para o espaço de trabalho 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 espaço de trabalho Databricks e dar-lhes o nível adequado de acesso. Quando um usuário sai da sua organização ou não precisa mais acessar o espaço de trabalho 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 espaço de trabalho do Databricks. Isso garante um processo de desembarque consistente e impede que usuários não autorizados acessem dados confidenciais. Veja Sincronizar utilizadores e grupos do Microsoft Entra ID usando SCIM.

Os usuários do Databricks criam

Crie um novo usuário no espaço de trabalho Databricks. Este novo usuário também será adicionado à conta Databricks.

databricks users create [flags]

Opções

--active

    Se este usuário estiver ativo.

--display-name string

    String que representa uma concatenação de nomes próprios e nomes de família.

--external-id string

    A ID externa não é suportada no momento.

--id string

    ID de usuário do Databricks.

--json JSON

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

--user-name string

    Endereço de e-mail do usuário Databricks.

Bandeiras globais

Examples

O exemplo a seguir cria um usuário com um nome para exibição e 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}'

Usuários do Databricks efetuam exclusões

Excluir um usuário. A exclusão de um usuário de um espaço de trabalho do Databricks também remove objetos associados ao usuário.

databricks users delete ID [flags]

Arguments

ID

    ID exclusivo para um usuário no espaço de trabalho Databricks.

Opções

Bandeiras globais

Examples

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

databricks users delete 12345

Os usuários do Databricks obtêm

Obtenha informações para um usuário específico no espaço de trabalho Databricks.

databricks users get ID [flags]

Arguments

ID

    ID exclusivo para um usuário no espaço de trabalho 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 devem ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order GetSortOrder

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

--start-index int

    Especifica o índice do primeiro resultado.

Bandeiras 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 espaço de trabalho 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 devem ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order ListSortOrder

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

--start-index int

    Especifica o índice do primeiro resultado.

Bandeiras globais

Examples

O exemplo a seguir lista todos os usuários:

databricks users list

O exemplo a seguir lista usuários com filtragem:

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

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

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

Atualização de usuários no Databricks

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

databricks users patch ID [flags]

Arguments

ID

    ID exclusivo no espaço de trabalho Databricks.

Opções

--json JSON

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

Bandeiras 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 de 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 de usuário do Databricks.

Opções

--active

    Se este usuário estiver ativo.

--display-name string

    String que representa uma concatenação de nomes próprios e nomes de família.

--external-id string

    A ID externa não é suportada no momento.

--id string

    ID de usuário do Databricks.

--json JSON

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

--user-name string

    Endereço de e-mail do usuário Databricks.

Bandeiras 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}'

utilizadores do Databricks obter níveis de permissão

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

databricks users get-permission-levels [flags]

Opções

Bandeiras globais

Examples

O exemplo a seguir obtém níveis de permissão para 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

Usuários do Databricks Obter-Permissões

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

Bandeiras 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

Databricks utilizadores definir permissões

Defina permissões de senha.

Define permissões em um objeto, substituindo as permissões existentes, se elas existirem. Exclui 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 embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras 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 dos 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 embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Examples

O exemplo a seguir atualiza 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 permissões usando um arquivo JSON:

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

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

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

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo de formato de log, text ou json. O valor predefinido é text.

--log-level string

    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á desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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