Pular para o conteúdo principal

service-principals grupo de comando

nota

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

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos service-principals dentro do Databricks CLI permite gerenciar entidade de serviço em seu Databricks workspace. Consulte entidade de serviço para obter informações sobre CI/CD.

databricks entidade de serviço criar

Crie uma nova entidade de serviço em “ Databricks workspace”.

databricks service-principals create [flags]

Opções

--active

Se esse usuário estiver ativo.

--application-id string

UUID relacionado à entidade de serviço.

--display-name string

Strings que representam uma concatenação de nomes próprios e sobrenomes.

--external-id string

ID externo para a entidade de serviço.

--id string

Databricks entidade de serviço ID.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

O exemplo a seguir cria uma entidade de serviço com um nome de exibição:

Bash
databricks service-principals create --display-name "My Service Principal"

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

Bash
databricks service-principals create --json '{"display_name": "My Service Principal", "active": true}'

entidade de serviço databricks excluir

Exclua uma única entidade de serviço no Databricks workspace.

databricks service-principals delete ID [flags]

Argumentos

ID

ID exclusivo para uma entidade de serviço no Databricks workspace.

Opções

Bandeiras globais

Exemplos

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

Bash
databricks service-principals delete 12345

entidade de serviço databricks obter

Obtenha os detalhes de uma única entidade de serviço definida no Databricks workspace.

databricks service-principals get ID [flags]

Argumentos

ID

ID exclusivo para uma entidade de serviço no Databricks workspace.

Opções

Bandeiras globais

Exemplos

O exemplo a seguir obtém detalhes sobre uma entidade de serviço:

Bash
databricks service-principals get 12345

databricks lista de entidades de serviço

Liste o conjunto de entidades de serviço associadas a um Databricks workspace.

databricks service-principals list [flags]

Opções

--attributes string

Lista de atributos separados por vírgula a serem retornados em resposta.

--count int

Número desejado de resultados por página.

--excluded-attributes string

Lista de atributos separados por vírgula a serem excluídos na 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 todas as entidades de serviço:

Bash
databricks service-principals list

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

Bash
databricks service-principals list --filter "displayName eq 'My Service Principal'"

entidade de serviço databricks patch

Atualizar parcialmente os detalhes de uma única entidade de serviço no Databricks workspace.

databricks service-principals patch ID [flags]

Argumentos

ID

ID exclusivo no Databricks workspace.

Opções

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

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

Bash
databricks service-principals patch 12345 --json '{"display_name": "Updated Service Principal"}'

atualização da entidade de serviço databricks

Atualize os detalhes de uma única entidade de serviço. Esta ação substitui a entidade de serviço existente com o mesmo nome.

databricks service-principals update ID [flags]

Argumentos

ID

Databricks entidade de serviço ID.

Opções

--active

Se esse usuário estiver ativo.

--application-id string

UUID relacionado à entidade de serviço.

--display-name string

Strings que representam uma concatenação de nomes próprios e sobrenomes.

--external-id string

ID externo para a entidade de serviço.

--id string

Databricks entidade de serviço ID.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Exemplos

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

Bash
databricks service-principals update 12345 --display-name "Updated Service Principal" --active

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

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

--log-level string

Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.

-o, --output Tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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