Partilhar via


account groups grupo de comando

Observação

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 account groups grupo de comandos dentro da CLI Databricks contém comandos para realizar operações de criar, obter, listar, atualizar e eliminar grupos. Os grupos simplificam a gestão de identidades, facilitando a atribuição de acesso à conta, dados e outros objetos protegidos do Databrick. Consulte Grupos.

Databricks Grupos de Contas criados

Crie um novo grupo na conta Databricks com um nome único.

databricks account groups create [flags]

Opções

--display-name string

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

--external-id string

    ID externo para o grupo.

--id string

    ID do grupo Databricks.

--json JSON

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

Bandeiras globais

Exemplos

O exemplo seguinte cria um grupo usando flags de linha de comando:

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

O exemplo seguinte cria um grupo usando JSON:

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

O exemplo seguinte cria um grupo usando um ficheiro JSON:

databricks account groups create --json @group.json

Databricks Grupos de Conta Eliminar

Apagar um grupo da conta Databricks.

databricks account groups delete ID [flags]

Arguments

ID

    ID único para um grupo na conta Databricks.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui um grupo por ID:

databricks account groups delete 12345

Databricks Grupos de Conta obtêm

Obtenha a informação de um grupo específico na conta Databricks.

databricks account groups get ID [flags]

Arguments

ID

    ID único para um grupo na conta Databricks.

Opções

Bandeiras globais

Exemplos

O exemplo seguinte obtém um grupo por ID:

databricks account groups get 12345

Lista de Grupos de Contas DataBricks

Obtenha todos os detalhes dos grupos associados à conta Databricks.

Importante

A partir de 22/08/2025, este comando não retorna membros. Em vez disso, os membros devem ser recuperados iterando através dos detalhes do grupo Get.

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

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 seguinte lista grupos com um filtro:

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

Patch dos grupos de contas do Databricks

Atualizar parcialmente os detalhes de um grupo.

databricks account groups 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

Exemplos

O exemplo seguinte corrige um grupo usando JSON:

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

O exemplo seguinte corrige um grupo usando um ficheiro JSON:

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

Atualização dos grupos de contas do Databricks

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

databricks account groups update ID [flags]

Arguments

ID

    ID do grupo Databricks.

Opções

--display-name string

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

--external-id string

    ID externo para o grupo.

--id string

    ID do grupo Databricks.

--json JSON

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

Bandeiras globais

Exemplos

O exemplo seguinte atualiza um grupo usando flags 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 seguinte atualiza um grupo usando um ficheiro JSON:

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