Bagikan melalui

Profil konfigurasi untuk Databricks CLI

  • Artikel

Catatan

Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas. Databricks CLI ada di Pratinjau Umum.

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 file .databrickscfg memungkinkan Anda menjalankan perintah dengan cepat di berbagai ruang kerja dengan menentukan nama profil konfigurasi target dalam bendera --profile atau -p perintah. Jika tidak ditentukan, profil konfigurasi DEFAULT digunakan.

Tip

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 variabel lingkungan khusus dan bidang .databrickscfg .

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

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": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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 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 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