Autenticação básica (fim da vida útil)
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
.
- Para operações de conta, especifique
-
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:
- Environment
- Profile
- CLI
- Connect
- VS Code
- Terraform
- Python
- Java
- Go
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 workspacehttps://dbc-a1b2345c-d6e7.cloud.databricks.com
como 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 as variáveis de ambiente conforme especificado na seção "Ambiente" deste artigo.
- Defina os valores em seu arquivo
.databrickscfg
conforme especificado na seção “Perfil” deste artigo.
As variáveis de ambiente sempre têm precedência sobre os valores em seu arquivo .databrickscfg
.
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 ocluster_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 arquivo
.databrickscfg
para operações no nível workspace do Databricks, conforme especificado na seção “Perfil” 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 pressioneEnter
. - Na Paleta de comandos , selecione o nome de seu perfil de destino na lista para sua 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:
A chamada para Databricks account-level REST APIs com o Databricks SDK para Python não é compatível com Databricks on Google Cloud.
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
:
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:
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,:
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:
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
:
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:
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,:
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:
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
:
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:
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,:
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.