Profil konfigurasi untuk Databricks CLI

Catatan

Penggunaan Databricks CLI tunduk pada Lisensi Databricks dan Pemberitahuan Privasi Databricks, termasuk ketentuan Data Penggunaan apa pun.

Artikel ini menjelaskan cara menggunakan Databricks CLI dengan profil konfigurasi. Ini mengasumsikan bahwa Anda telah menginstal Databricks CLI dan membuat file profil konfigurasi Databricks. Lihat Menginstal atau memperbarui Databricks CLI dan profil konfigurasi Azure Databricks.

Dapatkan 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 perintah --profile atau -p bendera. Jika Anda tidak menentukan profil, CLI memilih profil dalam urutan berikut:

  1. Variabel lingkungan DATABRICKS_CONFIG_PROFILE, jika ditetapkan.
  2. Pengaturan default_profile di bagian [__settings__] dari .databrickscfg, jika ada. Anda dapat mengatur ini dengan databricks auth switch. Lihat databricks auth switch.
  3. Profil DEFAULT.

Petunjuk / Saran

Anda dapat menekan Tab setelah --profile atau -p untuk menampilkan daftar profil konfigurasi yang tersedia untuk dipilih.

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. Untuk mengubah jalur default file .databrickscfg, atur variabel lingkungan DATABRICKS_CONFIG_FILE ke jalur yang berbeda. Lihat kolom khusus .databrickscfg.

Untuk mendapatkan informasi tentang profil konfigurasi yang ada, jalankan perintah auth describe:

databricks auth describe --profile <configuration-profile-name>

Misalnya, berikut adalah output untuk profil yang dikonfigurasi dengan autentikasi token akses pribadi Azure Databricks:

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Catatan

Perintah auth env tidak digunakan lagi. Gunakan databricks auth describe untuk memeriksa konfigurasi profil, atau databricks auth token untuk mengambil token akses OAuth yang di-cache.

Untuk mendapatkan informasi tentang semua profil yang tersedia, jalankan perintah auth profiles:

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

Output dari perintah auth profiles tidak menampilkan token akses apa pun. Untuk menampilkan detail token untuk profil tertentu, jalankan databricks auth describe --profile <profile-name> atau databricks auth token --profile <profile-name>.

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 profil konfigurasi Anda

Untuk menguji profil konfigurasi dan memverifikasi bahwa Anda telah menyiapkan autentikasi dengan benar, jalankan perintah yang tersambung ke ruang kerja.

Jika Anda tidak menentukan profil, profil default akan digunakan. Misalnya, perintah berikut mencantumkan versi Databricks Runtime yang tersedia untuk ruang kerja Azure Databricks yang terkait dengan profil DEFAULT Anda.

Catatan

Perintah ini mengasumsikan bahwa Anda tidak memiliki variabel lingkungan apa pun yang diutamakan daripada pengaturan di profil DEFAULT Anda. Untuk informasi selengkapnya, lihat Urutan evaluasi autentikasi.

databricks clusters spark-versions

Untuk memverifikasi profil konfigurasi tertentu, berikan nama profil menggunakan bendera -p.

databricks clusters spark-versions -p PROD
  • Last updated on