Profil konfigurasi untuk Databricks CLI
Catatan
Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas, yang ada di Pratinjau Umum. Untuk menemukan versi Databricks CLI Anda, jalankan databricks -v
.
Artikel ini menjelaskan cara menyiapkan autentikasi antara Databricks CLI dan akun dan ruang kerja Azure Databricks Anda. Lihat Apa itu Databricks CLI?.
Artikel ini mengasumsikan bahwa Anda telah menginstal Databricks CLI dan menyiapkan CLI untuk autentikasi. Lihat:
Mendapatkan informasi tentang profil konfigurasi
Menambahkan beberapa profil konfigurasi ke .databrickscfg
file memungkinkan Anda menjalankan perintah dengan cepat di berbagai ruang kerja dengan menentukan nama profil konfigurasi target dalam --profile
perintah atau -p
opsi, untuk perintah yang mendukung opsi ini. Jika Anda tidak menentukan --profile
opsi atau -p
dalam perintah yang mendukung opsi ini, perintah akan menggunakan DEFAULT
profil konfigurasi secara default.
Tip
Anda dapat menekan Tab
setelah --profile
atau -p
untuk menampilkan daftar profil konfigurasi yang tersedia untuk dipilih, alih-alih memasukkan nama profil konfigurasi secara manual.
Misalnya, Anda dapat memiliki profil konfigurasi bernama DEV
yang mereferensikan ruang kerja Azure Databricks yang Anda gunakan untuk beban kerja pengembangan dan profil konfigurasi terpisah bernama PROD
yang mereferensikan ruang kerja Azure Databricks berbeda yang Anda gunakan untuk beban kerja produksi.
Secara default, Databricks CLI mencari .databrickscfg
file di folder (beranda pengguna) Anda ~
di Unix, Linux, atau macOS, atau %USERPROFILE%
folder (beranda pengguna Anda) di Windows. Anda dapat mengubah jalur .databrickscfg
default file dengan mengatur variabel DATABRICKS_CONFIG_FILE
lingkungan . Untuk mempelajari cara mengatur variabel lingkungan, lihat dokumentasi sistem operasi Anda.
Untuk mendapatkan informasi tentang profil konfigurasi yang ada, jalankan auth env
perintah :
databricks auth env --profile <configuration-profile-name>
# Or:
databricks auth env --host <account-console-url>
# Or:
databricks auth env --host <workspace-url>
Misalnya, berikut adalah output untuk profil yang dikonfigurasi dengan autentikasi token akses pribadi Azure Databricks:
{
"env": {
"DATABRICKS_AUTH_TYPE": "pat",
"DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
"DATABRICKS_HOST": "<workspace-url>",
"DATABRICKS_TOKEN": "<token-value>"
}
}
Untuk mendapatkan informasi tentang semua profil yang tersedia, jalankan auth profiles
perintah :
databricks auth profiles
Output (elipsis mewakili konten yang dihilangkan, untuk brevity):
{
"profiles": [
{
"name": "<configuration-profile-name>",
"host": "<workspace-url>",
"cloud": "<cloud-id>",
"auth_type": "<auth-type>",
"valid": true
},
{
"...": "..."
}
]
}
Output perintah auth profiles
tidak menampilkan token akses apa pun. Untuk menampilkan token akses, jalankan perintah sebelumnya auth env
.
Penting
Databricks CLI tidak berfungsi dengan file .netrc. Anda dapat memiliki .netrc
file di lingkungan Anda untuk tujuan lain, tetapi Databricks CLI tidak akan menggunakan file tersebut .netrc
.
Menguji penyiapan profil konfigurasi DEFAULT Anda
Untuk memeriksa apakah Anda menyiapkan autentikasi dengan benar, Anda dapat menjalankan perintah seperti berikut ini, yang mencantumkan versi Databricks Runtime yang tersedia untuk ruang kerja Azure Databricks yang terkait dengan profil Anda DEFAULT
.
Panggilan berikut mengasumsikan bahwa Anda tidak memiliki variabel lingkungan khusus yang ditetapkan, yang lebih diutamakan daripada pengaturan di profil Anda DEFAULT
. Untuk informasi selengkapnya, lihat Urutan evaluasi autentikasi.
databricks clusters spark-versions
Menguji profil konfigurasi Anda
Untuk memeriksa apakah Anda menyiapkan profil konfigurasi dengan benar, Anda dapat menjalankan perintah seperti berikut ini dengan salah satu nama profil konfigurasi tingkat ruang kerja Anda. Perintah ini mencantumkan versi Databricks Runtime yang tersedia untuk ruang kerja Azure Databricks yang terkait dengan profil konfigurasi yang ditentukan, yang diwakili di sini oleh tempat penampung <configuration-profile-name>
:
databricks clusters spark-versions -p <configuration-profile-name>
Tip
Anda dapat menekan Tab
setelah --profile
atau -p
untuk menampilkan daftar profil konfigurasi yang tersedia untuk dipilih, alih-alih memasukkan nama profil konfigurasi secara manual.
Untuk mencantumkan detail profil tertentu, jalankan perintah berikut:
databricks auth env --profile <configuration-profile-name>
Untuk mencantumkan detail untuk semua profil yang tersedia, jalankan perintah berikut:
databricks auth profiles