Bagikan melalui

Profil konfigurasi untuk Databricks CLI

  • Artikel

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