Autenticação básica (fim da vida útil)

nota

A autenticação básica usando um nome de usuário e senha da Databricks chegou ao fim da vida útil em 10 de julho de 2024. Consulte End of life para Databricks-gerenciar senhas.

A autenticação básica utiliza um nome de usuário e senha do Databricks para autenticar a conta de usuário desejada do Databricks. A autenticação básica é antiga e não recomendada na produção.

Para configurar a autenticação básica, você deve definir as seguintes variáveis de ambiente associadas, campos do .databrickscfg, campos Terraform ou campos do Config :

O host Databricks.
- Para operações de conta, especifique https://accounts.cloud.databricks.com.
- Para workspace operações, especifique o URLworkspace, por exemplo, https://dbc-a1b2345c-d6e7.cloud.databricks.com.
O nome de usuário da conta de usuário Databricks.
A senha da conta de usuário Databricks.
Para Databricks account operações, o Databricks account ID.

A senha de um usuário Databricks account deve atender aos seguintes requisitos de complexidade:

Deve ter mais de 8 caracteres e menos de 50 caracteres
Deve conter pelo menos um caractere de cada uma das seguintes categorias:
- Base de 10 dígitos (0 a 9).
- Letras minúsculas
- Letras maiúsculas
- Caracteres não alfanuméricos (caracteres especiais):
```
'-!"#$%&()*,./:;?@[]^_`{|}~+<=>
```

Os requisitos de complexidade são impostos quando as senhas são alteradas ou criadas.

Para realizar a autenticação básica, integre o seguinte ao seu código, com base na ferramenta participante ou SDK:

Para usar a variável de ambiente para um tipo específico de autenticação Databricks com uma ferramenta ou SDK, consulte Autorização de acesso a Databricks recurso ou a documentação da ferramenta ou SDK. Consulte também variável de ambiente e campos para autenticação unificada de cliente e os métodos padrão para autenticação unificada de cliente.

Para operações de nível account, defina as seguintes variáveis de ambiente:

DATABRICKS_HOST, defina para a URL do console da conta do Databricks, https://accounts.cloud.databricks.com.
DATABRICKS_ACCOUNT_ID
DATABRICKS_USERNAME
DATABRICKS_PASSWORD

Para operações em nível workspace, defina as seguintes variáveis de ambiente:

DATABRICKS_HOST, definido Databricks workspace https://dbc-a1b2345c-d6e7.cloud.databricks.comcomo o URL, por exemplo,.
DATABRICKS_USERNAME
DATABRICKS_PASSWORD

Crie ou identifique um perfil de configuração do Databricks com os seguintes campos em seu arquivo .databrickscfg. Se você criar o perfil, substitua os espaços reservados pelos valores apropriados. Para usar o perfil com uma ferramenta ou SDK, consulte Autorização de acesso ao recurso Databricks ou a documentação da ferramenta ou SDK. Consulte também variável de ambiente e campos para autenticação unificada de cliente e os métodos padrão para autenticação unificada de cliente.

accountPara operações .databrickscfg de nível, defina os seguintes valores em seu arquivo. Nesse caso, o URL do console Databricks account é https://accounts.cloud.databricks.com:

[<some-unique-configuration-profile-name>]
host       = <account-console-url>
account_id = <account-id>
username   = <username>
password   = <password>

workspacePara operações .databrickscfg de nível, defina os seguintes valores em seu arquivo. Nesse caso, o host é o Databricks workspace URL, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,:

[<some-unique-configuration-profile-name>]
host     = <workspace-url>
username = <username>
password = <password>

Para a CLI do Databricks, faça um das coisas a seguir:

Defina a variável de ambiente conforme especificado na seção "Ambiente" deste artigo.
Defina os valores em seu arquivo .databrickscfg conforme especificado na seção "Profile" (Perfil) deste artigo.

As variáveis de ambiente sempre têm precedência sobre os valores em seu arquivo .databrickscfg.

nota

A autenticação básica é compatível com as seguintes versões do Databricks Connect:

Para o Python, Databricks Connect para Databricks Runtime 13.1 e superior.
Para o Scala, Databricks Connect para Databricks Runtime 13.3 LTS e superior.

Para o Databricks Connect, você pode fazer um das coisas a seguir:

Defina os valores no seu .databrickscfg arquivo para Databricks workspace-level operações conforme especificado na seção "Profile" deste artigo. Defina também o cluster_id variável de ambiente em seu perfil para o URL da instânciaworkspace, por exemplo, https://dbc-a1b2345c-d6e7.cloud.databricks.com.
Defina a variável de ambiente para Databricks workspace-level operações conforme especificado na seção "Environment" deste artigo. Defina também o DATABRICKS_CLUSTER_ID variável de ambiente para o URL da instânciaworkspace, por exemplo, https://dbc-a1b2345c-d6e7.cloud.databricks.com.

Os valores em seu arquivo .databrickscfg sempre têm precedência sobre as variáveis de ambiente.

Para inicializar o cliente Databricks Connect com essas variáveis de ambiente ou valores em seu arquivo .databrickscfg, consulte a configuração de computação para Databricks Connect.

Para a extensão do Databricks para Visual Studio Code, faça o seguinte:

Defina os valores no seu .databrickscfg arquivo para Databricks workspace-level operações conforme especificado na seção "Profile" deste artigo.
No painel Configuração da extensão do Databricks para Visual Studio Code, clique em Configurar Databricks .
Na paleta de comandos , em Databricks Host , digite o URLworkspace, por exemplo, https://dbc-a1b2345c-d6e7.cloud.databricks.com, e pressione Enter.
Na paleta de comandos , selecione o nome do perfil de destino na lista para o URL.

Para obter mais detalhes, consulte Configurar autorização para a extensão Databricks para Visual Studio Code.

Para account-level operações, para defaultauthentication:

provider "databricks" {
  alias = "accounts"
}

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o HashiCorp Vault. Consulte também Vault Provider). Nesse caso, o URL do console Databricks account é https://accounts.cloud.databricks.com:

provider "databricks" {
  alias      = "accounts"
  host       = <retrieve-account-console-url>
  account_id = <retrieve-account-id>
  username   = <retrieve-username>
  password   = <retrieve-password>
}

Para workspace-level operações, para defaultauthentication:

provider "databricks" {
  alias = "workspace"
}

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o HashiCorp Vault. Consulte também Vault Provider). Nesse caso, o host é o Databricks workspace URL, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,:

provider "databricks" {
  alias    = "workspace"
  host     = <retrieve-workspace-url>
  username = <retrieve-username>
  password = <retrieve-password>
}

Para obter mais informações sobre autenticação com o provedor Databricks Terraform, consulte Autenticação.

Para account-level operações, para defaultauthentication:

nota

A chamada para Databricks account-level REST APIs com o Databricks SDK para Python não é compatível com Databricks on Google Cloud.

Python
from databricks.sdk import AccountClient

a = AccountClient()
# ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o URL do console Databricks account é https://accounts.cloud.databricks.com:

Python
from databricks.sdk import AccountClient

a = AccountClient(
  host       = retrieve_account_console_url(),
  account_id = retrieve_account_id(),
  username   = retrieve_username(),
  password   = retrieve_password()
)
# ...

Para workspace-level operações, para defaultauthentication:

Python
from databricks.sdk import WorkspaceClient

w = WorkspaceClient()
# ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o host é o Databricks workspace URL, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,:

Python
from databricks.sdk import WorkspaceClient

w = WorkspaceClient(
  host     = retrieve_workspace_url(),
  username = retrieve_username(),
  password = retrieve_password()
)
# ...

Para obter mais informações sobre a autenticação com ferramentas Databricks e SDKs que usam Python e que implementam a autenticação unificada de clienteDatabricks, consulte:

Para account-level operações operações, para defaultautenticação:

Java
import com.databricks.sdk.AccountClient;
// ...
AccountClient a = new AccountClient();
// ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o URL do console Databricks account é https://accounts.cloud.databricks.com:

Java
import com.databricks.sdk.AccountClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveAccountConsoleUrl())
  .setAccountId(retrieveAccountId())
  .setUsername(retrieveUsername())
  .setPassword(retrievePassword());
AccountClient a = new AccountClient(cfg);
// ...

Para workspace-level operações: para default authentication:

Java
import com.databricks.sdk.WorkspaceClient;
// ...
WorkspaceClient w = new WorkspaceClient();
// ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o host é o Databricks workspace URL, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,:

Java
import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveWorkspaceUrl())
  .setUsername(retrieveUsername())
  .setPassword(retrievePassword());
WorkspaceClient w = new WorkspaceClient(cfg);
// ...

Para obter mais informações sobre a autenticação com ferramentas Databricks e SDKs que usam Java e que implementam a autenticação unificada de clienteDatabricks, consulte:

Configure o cliente Databricks Connect para Scala (o cliente Databricks Connect para Scala usa o Databricks SDK para Java incluído para autenticação)
Autentique o SDK do Databricks para Java com sua account ou workspace do Databricks

Para account-level operações, para defaultauthentication:

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient())
// ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o URL do console Databricks account é https://accounts.cloud.databricks.com:

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient(&databricks.Config{
  Host:      retrieveAccountConsoleUrl(),
  AccountId: retrieveAccountId(),
  UserName:  retrieveUsername(),
  Password:  retrievePassword(),
}))
// ...

Para workspace-level operações, para defaultauthentication:

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient())
// ...

Para configuração direta (substitua os espaços reservados retrieve por sua própria implementação para recuperar os valores do console ou de algum outro armazenamento de configuração, como o AWS Systems Manager Parameter Store). Nesse caso, o host é o Databricks workspace URL, por https://dbc-a1b2345c-d6e7.cloud.databricks.com exemplo,:

Go
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
w := databricks.Must(databricks.NewWorkspaceClient(&databricks.Config{
  Host:     retrieveWorkspaceUrl(),
  UserName: retrieveUsername(),
  Password: retrievePassword(),
}))
// ...

Para obter mais informações sobre a autenticação com Databricks ferramentas e SDKs que usam Go e que implementam a autenticação unificada de clienteDatabricks, consulte Autenticar o Databricks SDK para Go com seu Databricks account ou workspace.