Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Referensi ini mencantumkan variabel lingkungan dan bidang konfigurasi untuk autentikasi terpadu Databricks. Mereka bekerja secara konsisten di seluruh Databricks CLI, penyedia Terraform, dan SDK untuk Python, Java, dan Go.
Gunakan referensi ini untuk menyiapkan autentikasi atau memecahkan masalah autentikasi. Setiap entri meliputi:
- Variabel lingkungan: Atur ini di lingkungan shell Anda.
-
.databrickscfgbidang: Gunakan ini di profil konfigurasi. - Bidang terraform: Konfigurasikan ini di blok penyedia Terraform Anda. Lihat Autentikasi dalam dokumentasi penyedia Databricks Terraform.
-
Configbidang: Gunakan ini saat mengonfigurasi SDK secara terprogram denganConfigAPI.
Bidang konfigurasi umum
Variabel ini mengonfigurasi koneksi dasar dan pengaturan komputasi untuk Databricks.
| Nama umum | Description | Variabel lingkungan |
.databrickscfg bidang, bidang Terraform |
Config bidang |
|---|---|---|---|---|
| Host Azure Databricks | (String) URL host Azure Databricks untuk titik akhir ruang kerja Azure Databricks atau titik akhir akun Azure Databricks. | DATABRICKS_HOST |
host |
host (Python)setHost (Java)Host (Pergi) |
| Token Azure Databricks | (String) Token akses pribadi Azure Databricks atau token ID Microsoft Entra. | DATABRICKS_TOKEN |
token |
token (Python)setToken (Java)Token (Pergi) |
| ID akun Azure Databricks | (String) ID akun Azure Databricks untuk titik akhir akun Azure Databricks. Hanya berpengaruh ketika host Azure Databricks juga diatur ke https://accounts.azuredatabricks.net. |
DATABRICKS_ACCOUNT_ID |
account_id |
account_id (Python)setAccountID (Java)AccountID (Pergi) |
| ID Kluster | (String) ID kluster yang akan digunakan | DATABRICKS_CLUSTER_ID |
cluster_id |
cluster_id |
| Komputasi tanpa server | (String) Pengaturan pengaktifan otomatis komputasi tanpa server. Nilai yang valid adalah auto. |
DATABRICKS_SERVERLESS_COMPUTE_ID |
serverless_compute_id |
serverless_compute_id |
| Nama umum | Description | Variabel lingkungan |
.databrickscfg bidang, bidang Terraform |
Config bidang |
|---|---|---|---|---|
| ID klien Azure | (String) ID aplikasi prinsipal layanan Microsoft Entra ID. Gunakan dengan autentikasi identitas terkelola Azure dan autentikasi prinsip layanan Microsoft Entra ID. | ARM_CLIENT_ID |
azure_client_id |
azure_client_id (Python)setAzureClientID (Java)AzureClientID (Pergi) |
| Rahasia klien Azure | (String) Rahasia klien principal layanan Microsoft Entra ID. Gunakan dengan autentikasi prinsipal layanan ID Microsoft Entra. | ARM_CLIENT_SECRET |
azure_client_secret |
azure_client_secret (Python)setAzureClientSecret (Java)AzureClientSecret (Pergi) |
| ID Pelanggan | (String) ID klien perwakilan layanan terkelola Azure Databricks atau perwakilan layanan terkelola ID Microsoft Entra. Gunakan dengan autentikasi M2M OAuth. | DATABRICKS_CLIENT_ID |
client_id |
client_id (Python)setClientId (Java)ClientId (Pergi) |
| Rahasia klien | (String) Rahasia klien dari perwakilan layanan terkelola Azure Databricks atau perwakilan layanan terkelola ID Microsoft Entra. Gunakan dengan autentikasi M2M OAuth. | DATABRICKS_CLIENT_SECRET |
client_secret |
client_secret (Python)setClientSecret (Java)ClientSecret (Pergi) |
| Lingkungan Azure | (String) Jenis lingkungan Azure. Secara default menjadi PUBLIC. |
ARM_ENVIRONMENT |
azure_environment |
azure_environment (Python)setAzureEnvironment (Java)AzureEnvironment (Pergi) |
| ID penyewa Azure | (String) ID penyewa perwakilan layanan MICROSOFT Entra ID. | ARM_TENANT_ID |
azure_tenant_id |
azure_tenant_id (Python)setAzureTenantID (Java)AzureTenantID (Pergi) |
| Azure menggunakan MSI | (Boolean) True untuk menggunakan alur autentikasi tanpa kata sandi Azure Managed Service Identity untuk prinsipal layanan. Mengharuskan ID sumber daya Azure untuk juga diatur. | ARM_USE_MSI |
azure_use_msi |
AzureUseMSI (Pergi) |
| ID sumber daya Azure | (String) ID Azure Resource Manager untuk ruang kerja Azure Databricks. | DATABRICKS_AZURE_RESOURCE_ID |
azure_workspace_resource_id |
azure_workspace_resource_id (Python)setAzureResourceID (Java)AzureResourceID (Pergi) |
Bidang khusus .databrickscfg
Gunakan variabel atau bidang lingkungan ini untuk menentukan pengaturan non-default untuk .databrickscfg. Lihat juga profil konfigurasi Azure Databricks.
| Nama umum | Description | Variabel lingkungan | Bidang Terraform |
Config bidang |
|---|---|---|---|---|
.databrickscfg jalur file |
(String) Jalur non-default ke .databrickscfg file. |
DATABRICKS_CONFIG_FILE |
config_file |
config_file (Python)setConfigFile (Java)ConfigFile (Pergi) |
.databrickscfg profil bawaan |
(String) Profil bernama default untuk digunakan, selain DEFAULT. |
DATABRICKS_CONFIG_PROFILE |
profile |
profile (Python)setProfile (Java)Profile (Pergi) |
Bidang autentikasi
Gunakan variabel atau bidang lingkungan ini untuk menerapkan jenis autentikasi Databricks tertentu.
| Nama umum | Description | Variabel lingkungan | Bidang Terraform |
Config bidang |
|---|---|---|---|---|
| Jenis autentikasi Databricks | (String) Saat beberapa atribut autentikasi tersedia di lingkungan, gunakan jenis autentikasi yang ditentukan oleh argumen ini. Lihat Jenis autentikasi yang didukung. | DATABRICKS_AUTH_TYPE |
auth_type |
auth_type (Python)setAuthType (Java)AuthType (Pergi) |
| Variabel lingkungan token OIDC | (String) Nama variabel lingkungan yang berisi token OIDC yang dikeluarkan IdP Anda. Digunakan dengan env-oidc jenis autentikasi. Secara default menjadi DATABRICKS_OIDC_TOKEN. |
DATABRICKS_OIDC_TOKEN_ENV |
oidc_token_env |
oidc_token_env (Python)setOIDCTokenEnv (Java)OIDCTokenEnv (Pergi) |
| Jalur file token OIDC | (String) Jalur ke file lokal yang berisi token OIDC yang dikeluarkan IdP Anda. Digunakan dengan file-oidc jenis autentikasi. |
DATABRICKS_OIDC_TOKEN_FILEPATH |
oidc_token_filepath |
oidc_token_filepath (Python)setOIDCTokenFilepath (Java)OIDCTokenFilepath (Pergi) |
Jenis autentikasi yang didukung
Nilai bidang jenis autentikasi Databricks yang didukung meliputi:
-
oauth-m2m: Untuk autentikasi mesin-ke-mesin (M2M) dengan perwakilan layanan Databricks melalui OAuth 2.0. Lihat Mengotorisasi akses perwakilan layanan ke Azure Databricks dengan OAuth. -
pat: Untuk autentikasi menggunakan token akses pribadi Databricks. Lihat Mengautentikasi dengan token akses pribadi Azure Databricks (warisan). -
databricks-cli: Untuk masuk interaktif dengan Databricks CLI menggunakan OAuth 2.0. Lihat Mengotorisasi akses pengguna ke Azure Databricks dengan OAuth. -
oidc-token: Untuk federasi token dengan Penyedia Identitas (IdP), di mana Databricks bertukar token OIDC yang dikeluarkan IdP dengan token OAuth Databricks. Lihat Mengautentikasi dengan token penyedia identitas. -
env-oidc: Untuk federasi saat token IdP Anda disimpan dalam variabel lingkungan (DATABRICKS_OIDC_TOKEN). Lihat Mengautentikasi dengan token penyedia identitas. -
file-oidc: Untuk federasi saat token IdP Anda disimpan dalam file lokal (DATABRICKS_OIDC_TOKEN_FILEPATH). Lihat Mengautentikasi dengan token penyedia identitas. -
github-oidc: Untuk autentikasi gabungan GitHub Actions melalui token OIDC. Lihat Mengaktifkan federasi identitas beban kerja untuk GitHub Actions. -
azure-devops-oidc: Untuk autentikasi gabungan Azure DevOps melalui token OIDC. Lihat Mengaktifkan federasi identitas beban kerja untuk Alur Azure DevOps.
-
azure-msi: Untuk autentikasi menggunakan Azure Managed Service Identity (MSI). Lihat Mengautentikasi dengan identitas terkelola Azure. -
azure-client-secret: Untuk autentikasi menggunakan perwakilan layanan Azure dengan rahasia klien. Lihat Mengautentikasi dengan perwakilan layanan Microsoft Entra.