`auth` 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 auth grupo de comandos dentro da CLI do Databricks contém comandos relacionados à autenticação, incluindo o seguinte:

Liste todos os perfis de configuração de autenticação disponíveis.
Obtenha informações sobre um perfil de configuração de autenticação individual.
Use a autenticação de usuário para máquina (U2M) OAuth para autenticar a CLI do Databricks com suas contas e espaços de trabalho do Azure Databricks.
Saia de um perfil limpando tokens OAuth em cache e, opcionalmente, removendo a entrada do perfil.
Obtenha informações sobre quaisquer tokens de acesso OAuth que a CLI do Databricks possa ter armazenado em cache.
Obtenha detalhes sobre a configuração que a CLI do Databricks está usando para autenticar.

Tip

Para obter informações sobre o usuário atual da CLI do Databricks, execute databricks current-user me.

databricks auth descrever

Descreve a configuração que a CLI do Databricks está usando para autenticar, incluindo as credenciais e a origem dessas credenciais. Se nenhuma opção for especificada, o comando seguirá auth describe a prioridade do método de autenticação.

databricks auth describe [flags]

Opções

--sensitive

Inclua campos confidenciais como senhas e tokens na saída

Bandeiras globais

Exemplos

O exemplo a seguir descreve a configuração de autenticação atual:

databricks auth describe

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: default
  ✓ auth_type: <authentication-type> (from <path>/<to>/.databrickscfg config file)

Para especificar que as informações sobre um espaço de trabalho específico do Azure Databricks são usadas, especifique a --host opção junto com a URL do espaço de trabalho.

databricks auth describe --host https://<workspace-instance-name>

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from --host flag)
  ✓ profile: default
  ✓ auth_type: <authentication-type>

Para especificar que as informações sobre uma conta específica do Azure Databricks são usadas, especifique a --host opção junto com a URL do console da conta do Azure Databricks, https://accounts.azuredatabricks.net.

databricks auth describe --host <account-console-url>

Host: <account-console-url>
User: <user-name>@<domain>
AccountId: <account-id>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: <account-console-url> (from --host flag)
  ✓ account_id: <account-id>
  ✓ profile: default
  ✓ auth_type: <authentication-type>

Para especificar que as informações sobre um perfil de configuração específico do Azure Databricks sejam usadas, especifique a -p opção ou --profile junto com o nome do perfil:

databricks auth describe -p TEST

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: <authentication-type>
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: ******** (from <path>/<to>/.databrickscfg config file)
  ✓ profile: TEST (from --profile flag)
  ✓ auth_type: <authentication-type>

Para incluir informações confidenciais na saída (como tokens de acesso pessoal e segredos de cliente do Azure Databricks), especifique a --sensitive opção:

databricks auth describe --sensitive

Host: https://<workspace-instance-name>
User: <user-name>@<domain>
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://<workspace-instance-name> (from <path>/<to>/.databrickscfg config file)
  ✓ token: <token-value> (from <path>/<to>/.databrickscfg config file)
  ✓ profile: <profile-name>
  ✓ auth_type: pat

databricks auth env |

Warning

Este comando foi preterido.

Obtenha informações sobre um perfil de configuração existente usando o nome do perfil ou a URL do console da conta do Azure Databricks ou a URL do espaço de trabalho do Azure Databricks.

databricks auth env [flags]

Tip

Você pode pressionar Tab após --profile ou -p para exibir uma lista de perfis de configuração disponíveis existentes para escolher, em vez de inserir o nome do perfil de configuração manualmente.

Para criar um perfil de configuração, consulte o configure comando.

Opções

--host string

Nome do host para obter auth env para

Note

Se mais de um perfil corresponder ao --host valor, será exibido um erro, informando que não é possível encontrar um único perfil correspondente. Por exemplo, você pode ter um perfil que tenha apenas um valor de host e outro perfil que tenha o mesmo valor de host, mas também um valor de token. Nesse caso, a CLI do Databricks não escolhe um perfil e para. Para ajudar a CLI do Databricks a escolher o perfil desejado, tente especificar um valor diferente --host . Para --host valores que são URLs de console de conta, tente especificar um --account-id valor em vez de um --host valor.

--profile string

Perfil para obter auth env para

Bandeiras globais

Exemplos

O exemplo a seguir obtém o ambiente de autenticação padrão:

databricks auth env

O exemplo a seguir obtém o ambiente de autenticação para um host específico:

databricks auth env --host https://my-workspace.cloud.databricks.com

A saída para um perfil configurado com a autenticação de token de acesso do Azure Databricks pode ser:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "TEST",
    "DATABRICKS_HOST": "https://my-workspace.cloud.databricks.com",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

O exemplo a seguir obtém o ambiente de autenticação para um perfil específico:

databricks auth env --profile my-test-environment

Faça login em um espaço de trabalho ou conta do Databricks e salve a configuração de autenticação em um perfil (por ~/.databrickscfg padrão). O perfil pode ser usado para autenticar outros comandos da CLI do Databricks usando o --profile sinalizador. O perfil também pode ser usado para autenticar outras ferramentas Databricks que suportam autenticação unificada Databricks, incluindo os SDKs Databricks Python, Java e Go.

databricks auth login HOST [flags]

Este comando requer uma URL de host Databricks (usando --host ou como um argumento posicional ou implicitamente inferido a partir do nome de perfil especificado) e um nome de perfil (usando --profile) para ser especificado. Se você não especificar esses valores, será solicitado que você forneça valores em tempo de execução.

Embora esse comando sempre faça login no host especificado, o comportamento depende dos perfis existentes que você definiu no arquivo de configuração (por ~/.databrickscfg padrão):

Se existir um perfil com o nome especificado e especificar um host, você será conectado ao host especificado pelo perfil. O perfil será atualizado para usar "databricks-cli" como o tipo de autenticação se esse não era o caso antes.
Se existir um perfil com o nome especificado, mas não especificar um anfitrião, ser-lhe-á pedido que especifique um anfitrião. O perfil será atualizado para usar o host especificado. O tipo de autenticação será atualizado para "databricks-cli" se esse não era o caso antes.
Se existir um perfil com o nome especificado e especificar um host, mas você especificar um host usando --host (ou como o HOST arg posicional), o perfil será atualizado para usar o host recém-especificado. O tipo de autenticação será atualizado para "databricks-cli" se esse não era o caso antes.
Se um perfil com o nome especificado não existir, um novo perfil será criado com o host especificado. O tipo de autenticação será definido como "databricks-cli".

Argumentos

HOST

URL do host Databricks (opcional)

Opções

--configure-cluster

Prompts para configurar o cluster (computação clássica)

--configure-serverless

Prompts para configurar a computação sem servidor

--timeout duration

Tempo limite para completar o desafio de login no navegador (padrão 1h0m0s)

Bandeiras globais

Exemplos

O exemplo a seguir efetua login em um espaço de trabalho Databricks:

databricks auth login

O exemplo a seguir efetua login em um espaço de trabalho específico do Databricks:

databricks auth login https://my-workspace.cloud.databricks.com

O exemplo a seguir efetua login com um perfil específico e define as configurações do cluster:

databricks auth login --profile my-profile --configure-cluster

O exemplo a seguir define um tempo limite personalizado para o processo de login:

databricks auth login --timeout 30m

Logout de autenticação do Databricks

Saia de um perfil Azure Databricks limpando os seus tokens OAuth em cache. Terás de correr databricks auth login para reautenticar. O perfil permanece no ficheiro de configuração (~/.databrickscfg por defeito), a menos que também especifiques --delete.

databricks auth logout [PROFILE] [flags]

Este comportamento aplica-se apenas a perfis criados com databricks auth login (auth_type definido como databricks-cli). Perfis que utilizam outros métodos de autenticação, como tokens de acesso pessoais ou credenciais máquina-a-máquina, não armazenam tokens OAuth em cache, pelo que não há nada a verificar. Se vários perfis partilharem o mesmo token em cache, sair de um não afeta os outros.

Comportamento dos comandos:

Se especificar um perfil (como argumento PROFILE ou com --profile), o comando faz logout desse perfil. Também pode fornecer um URL de host, que o comando resolve para o perfil correspondente. Num terminal interativo, pede confirmação, a menos que também especifique --auto-approve.
Se omitir o perfil num terminal interativo, o comando mostra um seletor de perfil pesquisável. Pode pesquisar por nome de perfil, anfitrião ou ID da conta. Depois de selecionar um perfil, o comando pede confirmação, a menos que também especifique --auto-approve.
Se omitir o perfil num ambiente não interativo, o comando falha e pede-lhe para especificar um perfil.
Num ambiente não interativo, especifique um perfil e --auto-approve para saltar a confirmação.

Argumentos

PROFILE

Nome do perfil ou URL do host para sair (opcional). O argumento é primeiro comparado com nomes de perfil existentes. Se nenhum perfil coincidir e o argumento parecer um URL de host, o comando resolve para o(s) perfil(es) configurado(s) para esse host. Se vários perfis corresponderem a um anfitrião, o prompt de comandos indica para selecionar um (ou erros em modo não interativo).

Opções

--delete

Também remova o perfil do ficheiro de configuração (~/.databrickscfg por defeito)

--auto-approve

Ignora o prompt de confirmação

Bandeiras globais

Exemplos

O exemplo seguinte faz logout de um perfil específico:

databricks auth logout my-profile

O exemplo seguinte faz logout do perfil associado a uma URL de host:

databricks auth logout https://my-workspace.cloud.databricks.com

O exemplo seguinte faz logout e remove o perfil do ficheiro de configuração:

databricks auth logout --profile my-profile --delete

O exemplo seguinte faz logout sem um pedido de confirmação, adequado para CI/CD:

databricks auth logout my-profile --auto-approve

perfis de autenticação databricks

Liste todos os perfis de configuração disponíveis (por ~/.databrickscfg padrão) e verifique se eles são perfis válidos.

databricks auth profiles [flags]

Este comando gera perfis no seguinte formato:

Name            Host                Valid
DEFAULT         https://<host-url>  YES
<profile-name>  https://<host-url>  NO

Para determinar se cada perfil é válido, a CLI do Databricks lista espaços de trabalho para cada perfil no nível da conta e executa um comando get current user para cada perfil no nível do espaço de trabalho. Se o comando for bem-sucedido, um será exibido, caso YES contrário, um NO será exibido.

A saída do comando não exibe nenhum token de auth profiles acesso. Para exibir um token de acesso, consulte databricks auth env.

Por padrão, os perfis de configuração são armazenados no arquivo ~/.databrickscfg no Linux ou macOS, ou %USERPROFILE%\.databrickscfg no Windows. Você pode alterar o caminho padrão desse arquivo definindo a variável DATABRICKS_CONFIG_FILEde ambiente .

Para criar perfis de configuração, consulte o configure comando.

Opções

--skip-validate

Se deve ignorar a validação dos perfis

Bandeiras globais

Exemplos

O exemplo a seguir lista todos os perfis de autenticação:

databricks auth profiles

O exemplo a seguir lista perfis sem validá-los:

databricks auth profiles --skip-validate

Interruptor de autenticação Databricks

Defina um perfil nomeado como padrão em ~/.databrickscfg. O nome do perfil selecionado é armazenado numa [__settings__] secção do ficheiro de configuração sob a default_profile chave. Usa databricks auth profiles para ver qual perfil é atualmente o predefinido.

databricks auth switch [flags]

Opções

Bandeiras globais

Exemplos

O exemplo seguinte seleciona interativamente um perfil a definir como padrão:

databricks auth switch

O exemplo seguinte define um perfil específico como padrão:

databricks auth switch --profile my-profile

Token de autenticação Databricks

Obtenha o token de autenticação do cache local em ~/.databricks/token-cache.json. Atualize o token de acesso se estiver expirado ou perto de expirar. Este comando só funciona com autenticação U2M (usando o databricks auth login comando). A autenticação M2M usando um ID de cliente e segredo não é suportada.

databricks auth token [HOST_OR_PROFILE] [flags]

Para configurar e configurar a autenticação U2M do OAuth, consulte Autenticação de usuário para máquina (U2M) do OAuth.

Argumentos

HOST_OR_PROFILE

URL ou nome de perfil do anfitrião Databricks (opcional)

Opções

--account-id string

ID da conta Databricks

--force-refresh

Forçar a atualização do token mesmo que o token em cache continue válido.

--timeout duration

Tempo limite para adquirir um token. (padrão 1h0m0s)

Bandeiras globais

Exemplos

O exemplo a seguir obtém o token de autenticação:

databricks auth token

O exemplo a seguir obtém o token de autenticação para um host específico:

databricks auth token https://my-workspace.cloud.databricks.com

A saída pode ser:

{
  "access_token": "<token-value>",
  "token_type": "Bearer",
  "expiry": "<token-expiration-date-time>"
}

O exemplo a seguir define um tempo limite personalizado para aquisição de token:

databricks auth token --timeout 30m

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

Comentários

Esta página foi útil?

Last updated on 2026-04-25

auth grupo de comando

databricks auth descrever

Opções

Exemplos

databricks auth env |

Opções

Exemplos

Databricks Auth Login

Argumentos

Opções

Exemplos

Logout de autenticação do Databricks

Argumentos

Opções

Exemplos

perfis de autenticação databricks

Opções

Exemplos

Interruptor de autenticação Databricks

Opções

Exemplos

Token de autenticação Databricks

Argumentos

Opções

Exemplos

Bandeiras globais

Comentários

Recursos adicionais

`auth` grupo de comando