perintah configure

Note

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

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

configure Perintah dalam Databricks CLI memungkinkan Anda mengautentikasi Databricks CLI dengan Azure Databricks menggunakan token akses pribadi Azure Databricks atau token ID Microsoft Entra (sebelumnya Azure Active Directory).

Note

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 menggunakan token ID Microsoft Entra untuk memungkinkan pemanggilan perintah tingkat ruang kerja. Untuk opsi konfigurasi autentikasi tambahan, lihat Autentikasi untuk Databricks CLI.

konfigurasikan databricks

Konfigurasikan profil di file Anda ~/.databrickscfg. 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. Menambahkan beberapa profil 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.

Untuk mendapatkan informasi tentang profil konfigurasi yang ada, gunakan auth grup perintah.

Anda dapat mengubah jalur bawaan .databrickscfg file dengan mengatur variabel lingkungan DATABRICKS_CONFIG_FILE.

Jika perintah ini dipanggil dalam mode non-interaktif, perintah ini akan membaca token dari stdin. Host harus ditentukan dengan flag --host atau variabel lingkungan DATABRICKS_HOST.

databricks configure [flags]

Opsi

--configure-cluster

    Perintah untuk mengonfigurasi kluster

--host string

    URL host ruang kerja Databricks

URL host ruang kerja adalah 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.

--profile string

    Nama untuk profil koneksi yang akan dikonfigurasi. (default "DEFAULT")

Bendera global

Examples

Contoh berikut mengonfigurasi autentikasi untuk profil default:

databricks configure

Contoh berikut mengonfigurasi autentikasi untuk profil tertentu:

databricks configure --profile my-profile

Contoh berikut mengonfigurasi autentikasi dengan host tertentu:

databricks configure --host https://my-workspace.cloud.databricks.com

Contoh berikut mengonfigurasi autentikasi dengan konfigurasi kluster:

databricks configure --configure-cluster

Bendera dunia

--debug

  Apakah debug logging ingin diaktifkan?

-h atau --help

    Tampilkan bantuan untuk Databricks CLI atau grup perintah terkait atau perintah terkait.

--log-file tali

    String yang mewakili file yang akan digunakan untuk menulis log output. Jika bendera ini tidak ditentukan, maka defaultnya adalah menulis log output ke stderr.

--log-format format

    Jenis format log, text atau json. Nilai defaultnya adalah text.

--log-level tali

    Untaian yang menggambarkan tingkat format log. Jika tidak ditentukan, maka tingkat format log akan dinonaktifkan.

-o, --output jenis

    Jenis output perintah, text atau json. Nilai defaultnya adalah text.

-p, --profile tali

    Nama profil dalam file ~/.databrickscfg yang digunakan untuk menjalankan perintah. Jika bendera ini tidak ditentukan maka jika ada, profil bernama DEFAULT digunakan.

--progress-format format

    Format untuk menampilkan log kemajuan: default, , append, inplaceatau json

-t, --target tali

    Jika berlaku, target bundel yang akan digunakan

Membuat profil konfigurasi

Untuk membuat profil konfigurasi, jalankan configure perintah :

databricks configure --host <workspace-url>

Perintah ini meminta Anda untuk memasukkan token akses pribadi Azure Databricks atau token ID Microsoft Entra (sebelumnya Azure Active Directory) yang dipetakan ke yang ditentukan <workspace-url>:

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