configure grup perintah
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.
configure Grup perintah dalam Databricks CLI memungkinkan Anda mengautentikasi Databricks CLI dengan Azure Databricks dengan menggunakan token akses pribadi Azure Databricks atau token ID Microsoft Entra (sebelumnya Azure Active Directory).
Catatan
Sebagai praktik terbaik keamanan, saat Anda mengautentikasi dengan alat, sistem, skrip, dan aplikasi otomatis, Databricks merekomendasikan agar Anda menggunakan token akses pribadi milik perwakilan layanan, bukan pengguna ruang kerja. Untuk membuat token untuk perwakilan layanan, lihat Mengelola token untuk perwakilan layanan.
Perhatikan bahwa artikel ini hanya mencakup token akses pribadi Azure Databricks dan autentikasi token ID Microsoft Entra untuk mengaktifkan panggilan perintah tingkat ruang kerja. Untuk opsi konfigurasi autentikasi tambahan, lihat Autentikasi untuk Databricks CLI.
Penting
Sebelum Anda menjalankan perintah ini, pastikan untuk menyiapkan Databricks CLI.
Anda menjalankan configure perintah dengan menambahkannya ke databricks configure. Untuk menampilkan bantuan untuk perintah, jalankan configuredatabricks configure -h.
Membuat profil konfigurasi
Profil konfigurasi adalah kumpulan pengaturan yang berisi informasi autentikasi seperti URL ruang kerja Azure Databricks dan nilai token akses. Profil konfigurasi memiliki nama terprogram, seperti DEFAULT, , DEVatau PROD.
Untuk membuat profil konfigurasi, jalankan configure perintah sebagai berikut:
databricks configure --host <workspace-url>
Untuk <workspace-url>, masukkan URL per ruang kerja Anda, dengan format https://adb-<workspace-id>.<random-number>.azuredatabricks.net. Untuk mendapatkan URL per ruang kerja, lihat URL Per ruang kerja.
Perintah ini meminta Anda untuk memasukkan token akses pribadi Azure Databricks atau token ID Microsoft Entra (sebelumnya Azure Active Directory) yang memetakan ke token:
✔ Databricks Token:
Setelah Anda memasukkan token akses, token akses Anda disimpan dalam file ~/.databrickscfg di Linux atau macOS, atau %USERPROFILE%\.databrickscfg di Windows secara default. File berisi entri profil koneksi default bernama DEFAULT:
[DEFAULT]
host = <workspace-url>
token = <access-token>
Untuk menggunakan nama yang berbeda untuk profil koneksi Anda alih-alih DEFAULT, tambahkan --profile opsi ke configure perintah, misalnya:
databricks configure --host <workspace-url> --profile <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.
Setiap informasi host dan token yang ada dalam profil koneksi yang ditentukan ditimpa dengan informasi host dan token baru.
Menambahkan beberapa profil koneksi ke .databrickscfg file memungkinkan Anda menjalankan perintah dengan cepat di berbagai ruang kerja dengan menentukan nama profil koneksi target dalam opsi perintah --profile . Jika Anda tidak menentukan --profile opsi dalam perintah yang mendukung opsi ini, perintah akan menggunakan DEFAULT profil koneksi secara default.
Misalnya, Anda dapat memiliki profil koneksi bernama DEV yang mereferensikan ruang kerja Azure Databricks yang Anda gunakan untuk beban kerja pengembangan dan profil koneksi terpisah bernama PROD profil koneksi yang mereferensikan ruang kerja Azure Databricks berbeda yang Anda gunakan untuk beban kerja produksi.
Anda dapat mengubah jalur default file ini .databrickscfg 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, gunakan grup perintah autentikasi.