Compartilhar via


Grupo de comandos account groups

Observação

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 account groups grupo de comandos dentro da CLI do Databricks contém comandos para executar operações de criação, obtenção, lista, atualização e exclusão em grupos. Os grupos simplificam o gerenciamento de identidade, facilitando a atribuição de acesso à conta, aos dados e a outros objetos protegíveis do Databricks. Consulte Grupos.

criar grupos de contas do databricks

Crie um novo grupo na conta do Databricks com um nome exclusivo.

databricks account groups create [flags]

Opções

--display-name string

    Cadeia de caracteres que representa um nome de grupo legível por humanos.

--external-id string

    ID externa do grupo.

--id string

    ID do grupo databricks.

--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 cria um grupo usando sinalizadores de linha de comando:

databricks account groups create --display-name "Data Scientists"

O exemplo a seguir cria um grupo usando JSON:

databricks account groups create --json '{"displayName": "Data Scientists", "externalId": "ds-group-001"}'

O exemplo a seguir cria um grupo usando um arquivo JSON:

databricks account groups create --json @group.json

excluir grupos de contas do databricks

Exclua um grupo da conta do Databricks.

databricks account groups delete ID [flags]

Argumentos

ID

    ID exclusiva para um grupo na conta do Databricks.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir exclui um grupo por ID:

databricks account groups delete 12345

obter grupos de contas do databricks

Obtenha as informações de um grupo específico na conta do Databricks.

databricks account groups get ID [flags]

Argumentos

ID

    ID exclusiva para um grupo na conta do Databricks.

Opções

Sinalizadores globais

Exemplos

O exemplo a seguir obtém um grupo por ID:

databricks account groups get 12345

lista de grupos de contas do databricks

Obtenha todos os detalhes dos grupos associados à conta do Databricks.

Importante

A partir de 22/08/2025, esse comando não retorna membros. Em vez disso, os membros devem ser recuperados iterando por meio de Obter detalhes do grupo.

databricks account groups 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 e descending.

--start-index int

    Especifica o índice do primeiro resultado.

Sinalizadores globais

Exemplos

O exemplo a seguir lista todos os grupos:

databricks account groups list

O exemplo a seguir lista grupos com paginação:

databricks account groups list --count 10 --start-index 0

O exemplo a seguir lista grupos com um filtro:

databricks account groups list --filter "displayName eq \"Data Scientists\""

patch de grupos de contas do databricks

Atualize parcialmente os detalhes de um grupo.

databricks account groups 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 grupo usando JSON:

databricks account groups patch 12345 --json '{"displayName": "Updated Group Name"}'

O exemplo a seguir corrige um grupo usando um arquivo JSON:

databricks account groups patch 12345 --json @patch-group.json

atualização de grupos de contas do databricks

Atualize os detalhes de um grupo substituindo a entidade do grupo inteira.

databricks account groups update ID [flags]

Argumentos

ID

    ID do grupo databricks.

Opções

--display-name string

    Cadeia de caracteres que representa um nome de grupo legível por humanos.

--external-id string

    ID externa do grupo.

--id string

    ID do grupo databricks.

--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 um grupo usando sinalizadores de linha de comando:

databricks account groups update 12345 --display-name "Updated Data Scientists"

O exemplo a seguir atualiza um grupo usando JSON:

databricks account groups update 12345 --json '{"displayName": "Updated Data Scientists", "externalId": "ds-group-002"}'

O exemplo a seguir atualiza um grupo usando um arquivo JSON:

databricks account groups update 12345 --json @update-group.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