Partilhar via


Autenticar com a CLI do Azure

A autenticação no Azure CLI utiliza a CLI do Azure para autenticar o usuário autenticado ou o principal de serviço do Microsoft Entra ID.

Nota

Os principais de serviço geridos do Azure Databricks são administrados diretamente no Azure Databricks. As entidades de serviço principais geridas pelo Microsoft Entra ID são geridas no Microsoft Entra ID, o que requer permissões adicionais. A Databricks recomenda a utilização de autenticação OAuth máquina-a-máquina (M2M) com entidades de serviço geridas do Azure Databricks na maioria dos cenários, em vez da autenticação da CLI do Azure com entidades de serviço do Microsoft Entra ID. No entanto, a Databricks recomenda que se use a autenticação da CLI do Azure com entidades de serviço do Microsoft Entra ID nos casos em que deve-se autenticar com o Azure Databricks e outros recursos do Azure ao mesmo tempo.

Para usar a autenticação OAuth M2M com entidades de serviço gerenciado do Azure Databricks em vez da autenticação da CLI do Azure com entidades de serviço do Microsoft Entra ID, ignore esta página e consulte Autorizar o acesso da entidade de serviço ao Azure Databricks com OAuth.

Para configurar com o Azure Databricks, você deve fazer o seguinte:

  1. Tenha o Authenticate with the Azure CLI instalado localmente.
  2. Use a CLI do Azure para fazer logon no Azure Databricks executando o az login comando. Consulte Entrar com a CLI do Azure.
  3. Defina as seguintes variáveis de ambiente associadas, campos .databrickscfg, campos Terraform ou campos Config:
    • O host do Azure Databricks.
      • Para operações de conta, especifique https://accounts.azuredatabricks.net.
      • Para operações de espaço de trabalho, especifique a URL por espaço de trabalho, por exemplo https://adb-1234567890123456.7.azuredatabricks.net.
    • Para operações de conta, o ID da conta do Azure Databricks.

Para executar a autenticação da CLI do Azure com o Azure Databricks, integre o seguinte em seu código, com base na ferramenta participante ou SDK:

Meio Ambiente

Para usar variáveis de ambiente para um tipo de autenticação específico do Azure Databricks com uma ferramenta ou SDK, consulte Autorizar o acesso aos recursos do Azure Databricks ou a documentação da ferramenta ou do SDK. Consulte também Variáveis e campos de ambiente para autenticação unificada e a prioridade do método de autenticação.

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

  • DATABRICKS_HOST, defina o valor da URL do console da conta do Azure Databricks, https://accounts.azuredatabricks.net.
  • DATABRICKS_ACCOUNT_ID

Para operações ao nível do espaço de trabalho, defina as seguintes variáveis de ambiente:

  • DATABRICKS_HOST, defina o valor do seu Azure Databricks URL por espaço de trabalho, por exemplo, https://adb-1234567890123456.7.azuredatabricks.net.

Perfil

Crie ou identifique um perfil de configuração do Azure Databricks com os seguintes campos em seu .databrickscfg arquivo. Se criar o perfil, substitua os espaços reservados pelos valores apropriados. Para usar o perfil com uma ferramenta ou SDK, consulte Autorizar o acesso aos recursos do Azure Databricks ou a documentação da ferramenta ou do SDK. Consulte também Variáveis e campos de ambiente para autenticação unificada e a prioridade do método de autenticação.

Para operações de nível de conta, defina os seguintes valores no arquivo .databrickscfg. Nesse caso, a URL do console da conta do Azure Databricks é https://accounts.azuredatabricks.net:

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

Para operações ao nível do espaço de trabalho, defina os seguintes valores no arquivo .databrickscfg. Nesse caso, o host é a URL por espaço de trabalho do Azure Databricks, por exemplo:

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

CLI

Para a CLI do Databricks, siga um destes procedimentos:

  • Defina as variáveis de ambiente conforme especificado na guia Ambiente .
  • Defina os valores em seu .databrickscfg arquivo conforme especificado na guia Perfil .

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

Consulte também a autenticação da CLI do Azure.

Conectar

Nota

A autenticação da CLI do Azure é suportada nas seguintes versões do Databricks Connect:

  • Para Python, Databricks Connect para Databricks Runtime 13.1 e versões posteriores.
  • Para Scala, o Databricks Connect para o Databricks Runtime 13.3 LTS ou superior.

Para o Databricks Connect, você pode:

  • Use um perfil de configuração: No seu arquivo .databrickscfg, defina valores ao nível do espaço de trabalho conforme descrito na guia Perfil. Também deve definir o URL da instância do seu cluster_id espaço de trabalho.
  • Use variáveis de ambiente: Estabeleça os mesmos valores mostrados na guia Ambiente. Defina também a URL da instância do para o seu espaço de trabalho.

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

Para inicializar o Databricks Connect com essas configurações, consulte Configuração de computação para o Databricks Connect.

Código VS

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

  1. No painel Configuração, clique em Configurar Databricks.
  2. Na Paleta de comandos, para Databricks Host, insira sua URL por espaço de trabalho, por exemplo https://adb-1234567890123456.7.azuredatabricks.net, e pressione Enter.
  3. Selecione CLI do Azure.

Para obter mais detalhes, consulte Configurar a autenticação da CLI do Azure.

Terraformação

Para operações ao nível de conta, para autenticação padrão:

provider "databricks" {
  alias = "accounts"
}

Para configuração direta (substitua os espaços reservados retrieve pela sua própria implementação para obter os valores a partir do console ou de outro local de configuração, como HashiCorp Vault. Veja também o Provedor Vault). Nesse caso, a URL do console da conta do Azure Databricks é https://accounts.azuredatabricks.net:

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

Para operações no nível do espaço de trabalho, para autenticação padrão:

provider "databricks" {
  alias = "workspace"
}

Para configuração direta (substitua os espaços reservados retrieve pela sua própria implementação para obter os valores a partir do console ou de outro local de configuração, como HashiCorp Vault. Veja também o Provedor Vault). Nesse caso, o host é a URL por espaço de trabalho do Azure Databricks, por exemplo:

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

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

Python

Para operações ao nível de conta, para autenticação padrão:

from databricks.sdk import AccountClient

a = AccountClient()
# ...

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, a URL do console da conta do Azure Databricks é https://accounts.azuredatabricks.net:

from databricks.sdk import AccountClient

a = AccountClient(
  host       = retrieve_account_console_url(),
  account_id = retrieve_account_id()
)
# ...

Para operações no nível do espaço de trabalho, para autenticação padrão:

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()
# ...

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, o host é a URL por espaço de trabalho do Azure Databricks, por exemplo:

from databricks.sdk import WorkspaceClient

w = WorkspaceClient(host = retrieve_workspace_url())
# ...

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

Java

Para operações ao nível de conta, para autenticação padrão:

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

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, a URL do console da conta do Azure Databricks é https://accounts.azuredatabricks.net:

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

Para operações no nível do espaço de trabalho, para autenticação padrão:

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

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, o host é a URL por espaço de trabalho do Azure Databricks, por exemplo:

import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
  .setHost(retrieveWorkspaceUrl())
WorkspaceClient w = new WorkspaceClient(cfg);
// ...

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

Go

Para operações ao nível de conta, para autenticação padrão:

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

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, a URL do console da conta do Azure Databricks é https://accounts.azuredatabricks.net:

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

Para operações no nível do espaço de trabalho, para autenticação padrão:

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

Para configuração direta (substitua os placeholders retrieve por sua própria implementação para recuperar os valores do console ou de algum outro repositório de configuração, como por exemplo, Azure KeyVault). Nesse caso, o host é a URL por espaço de trabalho do Azure Databricks, por exemplo:

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

Para obter mais informações sobre a autenticação com ferramentas e SDKs do Databricks que usam o Go e que implementam a autenticação unificada do cliente Databricks, consulte Autenticar o SDK do Databricks para Go com sua conta ou espaço de trabalho do Azure Databricks.