Pular para o conteúdo principal

account service-principals grupo de comandos

nota

Esta informação aplica-se às versões 0.205 e acima Databricks CLI . A CLI do Databricks está em versão prévia pública.

O uso CLI Databricks está sujeito à LicençaDatabricks e ao Aviso de PrivacidadeDatabricks, incluindo qualquer fornecimento de Dados de Uso.

O grupo de comandos account service-principals na CLIdoDatabricks contém comandos para executar criar, obter, listar, atualizar e excluir operações na entidade de serviço. Entidade de serviço são identidades para uso com Jobs, ferramentas automatizadas e sistemas como scripts, aplicativos e plataformas CI/CD . Databricks recomenda a criação de entidade de serviço para executar o trabalho de produção ou modificar os dados de produção. Veja entidade de serviço.

criação de account databricks entidade de serviço

Crie uma nova entidade de serviço na account do Databricks .

databricks account service-principals create [flags]

Opções

--active

Se esta entidade de serviço estiver ativa.

--application-id string

UUID relativo à entidade de serviço.

--display-name string

sequências de caracteres que representam a concatenação de nomes e sobrenomes.

--external-id string

Identificação externa da entidade de serviço.

--id string

ID da entidade de serviço Databricks .

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma entidade de serviço usando parâmetros de linha de comando:

Bash
databricks account service-principals create --application-id "12345678-1234-1234-1234-123456789abc" --display-name "CI/CD Pipeline"

O exemplo a seguir cria uma entidade de serviço usando JSON:

Bash
databricks account service-principals create --json '{"applicationId": "12345678-1234-1234-1234-123456789abc", "displayName": "CI/CD Pipeline", "active": true}'

O exemplo a seguir cria uma entidade de serviço usando um arquivo JSON:

Bash
databricks account service-principals create --json @service-principal.json

databricks account entidade de serviço excluir

Exclua uma única entidade de serviço na account Databricks .

databricks account service-principals delete ID [flags]

Argumentos

ID

ID exclusivo para uma entidade de serviço na account do Databricks .

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui uma entidade de serviço por ID:

Bash
databricks account service-principals delete 12345

account databricks entidade de serviço get

Obtenha os detalhes de uma única entidade de serviço definida na account Databricks .

databricks account service-principals get ID [flags]

Argumentos

ID

ID exclusivo para uma entidade de serviço na account do Databricks .

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém uma entidade de serviço por ID:

Bash
databricks account service-principals get 12345

lista de entidade de serviço account databricks

Obtenha o conjunto de entidades de serviço associadas a uma account Databricks .

databricks account service-principals list [flags]

Opções

--attributes string

Lista de atributos a serem retornados na resposta, separados por vírgulas.

--count int

Número desejado de resultados por página.

--excluded-attributes string

Lista de atributos a serem excluídos na resposta, separados por vírgulas.

--filter string

Consulta pela qual os resultados devem ser filtrados.

--sort-by string

Atributo para ordenar os resultados.

--sort-order ListSortOrder

A ordem em que os resultados devem ser classificados. Valores suportados: ascending, descending.

--start-index int

Especifica o índice do primeiro resultado.

Bandeiras globais

Exemplos

O exemplo a seguir lista todas as entidades de serviço:

Bash
databricks account service-principals list

O exemplo a seguir lista entidade de serviço com paginação:

Bash
databricks account service-principals list --count 10 --start-index 0

O exemplo a seguir lista entidade de serviço com um filtro:

Bash
databricks account service-principals list --filter "displayName eq \"CI/CD Pipeline\""

databricks account entidade de serviço patch

Atualizar parcialmente os detalhes de uma única entidade de serviço na account Databricks .

databricks account service-principals patch ID [flags]

Argumentos

ID

ID único no workspace Databricks .

Opções

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir corrige uma entidade de serviço usando JSON:

Bash
databricks account service-principals patch 12345 --json '{"displayName": "Updated CI/CD Pipeline"}'

O exemplo a seguir modifica uma entidade de serviço usando um arquivo JSON:

Bash
databricks account service-principals patch 12345 --json @patch-service-principal.json

atualização account databricks entidade de serviço

Atualize os detalhes de uma única entidade de serviço substituindo toda a entidade entidade de serviço.

databricks account service-principals update ID [flags]

Argumentos

ID

ID da entidade de serviço Databricks .

Opções

--active

Se esta entidade de serviço estiver ativa.

--application-id string

UUID relativo à entidade de serviço.

--display-name string

sequências de caracteres que representam a concatenação de nomes e sobrenomes.

--external-id string

Identificação externa da entidade de serviço.

--id string

ID da entidade de serviço Databricks .

--json JSON

As strings JSON embutidas ou o @caminho para o arquivo JSON com o corpo da requisição.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza uma entidade de serviço usando parâmetros de linha de comando:

Bash
databricks account service-principals update 12345 --display-name "Updated CI/CD Pipeline" --active

O exemplo a seguir atualiza uma entidade de serviço usando JSON:

Bash
databricks account service-principals update 12345 --json '{"displayName": "Updated CI/CD Pipeline", "active": true}'

O exemplo a seguir atualiza uma entidade de serviço usando um arquivo JSON:

Bash
databricks account service-principals update 12345 --json @update-service-principal.json

Bandeiras globais

--debug

Ativar ou não o registro de depuração.

-h ou --help

Exibir ajuda para a CLI Databricks , o grupo de comandos relacionado ou o comando específico.

--log-file string

Uma sequência de caracteres representando o arquivo no qual logs de saída serão gravados. Se essa opção não for especificada, o default é gravar logs de saída em stderr.

--log-format Formato

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

--log-level string

Uma sequência de caracteres representando o nível de formato log . Caso não seja especificado, o nível de formato log será desativado.

-o, --output Tipo

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

-p, --profile string

O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se este sinalizador não for especificado, então, se existir, o perfil denominado 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 pacote de destino a ser usado.