Partilhar via

Variáveis de ambiente e campos para autenticação unificada

Esta referência lista variáveis de ambiente e campos de configuração para autenticação unificada do Databricks. Eles funcionam consistentemente em toda a CLI do Databricks, provedor Terraform e SDKs para Python, Java e Go.

Use esta referência para configurar a autenticação ou solucionar problemas de autenticação. Cada entrada inclui:

  • Variável de ambiente: Defina isso em seu ambiente de shell.
  • .databrickscfg field: Use isso em perfis de configuração.
  • Campo Terraform: Configure isso no seu bloco de provedor Terraform. Consulte Autenticação na documentação do provedor Databricks Terraform.
  • Config field: Use isso ao configurar SDKs programaticamente com o Config API.

Campos de configuração geral

Essas variáveis configuram configurações básicas de conexão e computação para Databricks.

Nome comum Description Variável de ambiente .databrickscfg campo, campo do Terraform Config campo
Azure Databricks anfitrião (String) O URL do servidor Azure Databricks para o ponto de extremidade do espaço de trabalho Azure Databricks ou para o ponto de extremidade das contas Azure Databricks. DATABRICKS_HOST host host (Python)
setHost (Java)
Host (Vai)
Token do Azure Databricks (String) O token de acesso pessoal do Azure Databricks ou token de ID do Microsoft Entra. DATABRICKS_TOKEN token token (Python)
setToken (Java)
Token (Vai)
ID da conta do Azure Databricks (String) A ID da conta do Azure Databricks para o ponto de extremidade da conta do Azure Databricks. Só tem efeito quando o host do Azure Databricks também está definido como https://accounts.azuredatabricks.net. DATABRICKS_ACCOUNT_ID account_id account_id (Python)
setAccountID (Java)
AccountID (Vai)
Cluster ID (String) O ID do cluster a ser usado DATABRICKS_CLUSTER_ID cluster_id cluster_id
Computação sem servidor (String) A configuração de ativação automática de computação sem servidor. Os valores válidos são auto. DATABRICKS_SERVERLESS_COMPUTE_ID serverless_compute_id serverless_compute_id
Nome comum Description Variável de ambiente .databrickscfg campo, campo do Terraform Config campo
ID do cliente do Azure (String) A ID do aplicativo da entidade de serviço Microsoft Entra ID. Use com a autenticação de identidades gerenciadas do Azure e a autenticação principal do serviço Microsoft Entra ID. ARM_CLIENT_ID azure_client_id azure_client_id (Python)
setAzureClientID (Java)
AzureClientID (Vai)
Segredo do cliente do Azure (String) O segredo do cliente da entidade de serviço Microsoft Entra ID. Use uma autenticação de principal de serviço do Microsoft Entra ID. ARM_CLIENT_SECRET azure_client_secret azure_client_secret (Python)
setAzureClientSecret (Java)
AzureClientSecret (Vai)
ID do Cliente (String) O ID do cliente da entidade de serviço gerido do Azure Databricks ou da entidade de serviço gerido do Microsoft Entra ID. Use com autenticação OAuth M2M. DATABRICKS_CLIENT_ID client_id client_id (Python)
setClientId (Java)
ClientId (Vai)
Segredo do cliente (String) O segredo de cliente do principal de serviço gerenciado do Azure Databricks ou do principal de serviço gerenciado do Microsoft Entra ID. Use com autenticação OAuth M2M. DATABRICKS_CLIENT_SECRET client_secret client_secret (Python)
setClientSecret (Java)
ClientSecret (Vai)
Ambiente do Azure (String) O tipo de ambiente do Azure. O padrão é PUBLIC. ARM_ENVIRONMENT azure_environment azure_environment (Python)
setAzureEnvironment (Java)
AzureEnvironment (Vai)
ID do inquilino do Azure (String) A ID do locatário da entidade de serviço Microsoft Entra ID. ARM_TENANT_ID azure_tenant_id azure_tenant_id (Python)
setAzureTenantID (Java)
AzureTenantID (Vai)
Azure usa MSI (Booleano) True para usar o fluxo de autenticação sem senha da Identidade do Serviço Gerenciado do Azure para entidades de serviço. Requer que a ID de recurso do Azure também seja definida. ARM_USE_MSI azure_use_msi AzureUseMSI (Vai)
ID de recurso do Azure (String) A ID do Azure Resource Manager para o espaço de trabalho do Azure Databricks. DATABRICKS_AZURE_RESOURCE_ID azure_workspace_resource_id azure_workspace_resource_id (Python)
setAzureResourceID (Java)
AzureResourceID (Vai)

Campos específicos .databrickscfg

Use essas variáveis de ambiente ou campos para especificar configurações não padrão para .databrickscfg. Consulte também Perfis de configuração do Azure Databricks.

Nome comum Description Variável de ambiente Campo Terraform Config campo
.databrickscfg caminho do arquivo (String) Um caminho não padrão para o .databrickscfg arquivo. DATABRICKS_CONFIG_FILE config_file config_file (Python)
setConfigFile (Java)
ConfigFile (Vai)
.databrickscfg perfil padrão (String) O perfil nomeado padrão a ser usado, diferente de DEFAULT. DATABRICKS_CONFIG_PROFILE profile profile (Python)
setProfile (Java)
Profile (Vai)

Campos de autenticação

Use essas variáveis de ambiente ou campos para impor um tipo específico de autenticação Databricks.

Nome comum Description Variável de ambiente Campo Terraform Config campo
Tipo de autenticação "Databricks" (String) Quando vários atributos de autenticação estiverem disponíveis no ambiente, use o tipo de autenticação especificado por esse argumento. Consulte Tipos de autenticação suportados. DATABRICKS_AUTH_TYPE auth_type auth_type (Python)
setAuthType (Java)
AuthType (Vai)
Variável de ambiente de token OIDC (String) O nome da variável de ambiente que contém o token OIDC emitido pelo IdP. Usado com env-oidc o tipo de autenticação. O padrão é DATABRICKS_OIDC_TOKEN. DATABRICKS_OIDC_TOKEN_ENV oidc_token_env oidc_token_env (Python)
setOIDCTokenEnv (Java)
OIDCTokenEnv (Vai)
Caminho do arquivo de token OIDC (String) O caminho para um arquivo local que contém seu token OIDC emitido pelo IdP. Usado com file-oidc o tipo de autenticação. DATABRICKS_OIDC_TOKEN_FILEPATH oidc_token_filepath oidc_token_filepath (Python)
setOIDCTokenFilepath (Java)
OIDCTokenFilepath (Vai)

Tipos de autenticação suportados

Os valores de campo suportados para o tipo de autenticação do Databricks incluem:

  • Last updated on