Penyiapan autentikasi untuk ekstensi Databricks untuk Visual Studio Code

Artikel ini menjelaskan cara menyiapkan autentikasi antara ekstensi Databricks untuk Visual Studio Code dan ruang kerja Azure Databricks Anda. Lihat Apa itu ekstensi Databricks untuk Visual Studio Code?

Ekstensi Databricks untuk Visual Studio Code menerapkan bagian dari standar autentikasi terpadu klien Databricks, pendekatan arsitektur dan terprogram yang terkonsolidasi dan konsisten untuk autentikasi. Pendekatan ini membantu menyiapkan dan mengotomatiskan autentikasi dengan Azure Databricks lebih terpusat dan dapat diprediksi. Ini memungkinkan Anda mengonfigurasi autentikasi Azure Databricks sekali lalu menggunakan konfigurasi tersebut di beberapa alat dan SDK Azure Databricks tanpa perubahan konfigurasi autentikasi lebih lanjut.

Informasi berikut mengasumsikan bahwa Anda telah menginstal ekstensi Databricks untuk Visual Studio Code. Lihat Menginstal ekstensi Databricks untuk Visual Studio Code.

Catatan

Jika Anda telah menyelesaikan ekstensi VSCode untuk tutorial Databricks: Jalankan Python pada kluster dan sebagai pekerjaan, dan ingin tetap menggunakan autentikasi token akses pribadi Azure Databricks yang Anda siapkan dalam tutorial tersebut, lewati ke depan untuk Memilih kluster untuk ekstensi Databricks untuk Visual Studio Code.

Bergantung pada jenis autentikasi yang ingin Anda gunakan, selesaikan instruksi untuk jenis autentikasi Azure Databricks target Anda.

• Untuk jenis autentikasi berikut, lewati ke depan untuk Menyiapkan autentikasi dengan profil konfigurasi:
  • Autentikasi token akses pribadi Azure Databricks
  • Menggunakan perwakilan layanan untuk mengautentikasi dengan Azure Databricks
  • Autentikasi perwakilan layanan ID Microsoft Entra
• Untuk autentikasi pengguna-ke-mesin (U2M) OAuth, lewati ke depan untuk Menyiapkan autentikasi OAuth U2M.
• Untuk autentikasi Azure CLI, lewati ke menyiapkan autentikasi Azure CLI.

Catatan

Ekstensi Databricks untuk Visual Studio Code belum mendukung autentikasi menggunakan identitas terkelola Azure (sebelumnya Azure Managed Service Identities (MSI)).

Databricks Connect mendukung autentikasi menggunakan identitas terkelola Azure. Namun, Anda tidak dapat menggunakan integrasi Databricks Connect dalam ekstensi Databricks untuk Visual Studio Code untuk melakukan autentikasi identitas terkelola Azure. Untuk menggunakan Databricks Connect dengan Visual Studio Code dengan sendirinya, terpisah dari ekstensi Databricks untuk Visual Studio Code, lihat Menggunakan Visual Studio Code dengan Databricks Connect untuk Python.

Menyiapkan autentikasi dengan profil konfigurasi

Instruksi berikut mengasumsikan bahwa Anda telah menyiapkan profil konfigurasi Azure Databricks dengan bidang yang diperlukan untuk jenis autentikasi Azure Databricks Anda. Lihat Profil konfigurasi Azure Databricks dan tab Profil atau bagian untuk jenis autentikasi Anda di Autentikasi untuk otomatisasi Azure Databricks - gambaran umum.

Misalnya, jika Anda ingin mengautentikasi dengan menggunakan autentikasi token akses pribadi Azure Databricks, buat token akses pribadi Anda dengan melakukan hal berikut:

1. Di ruang kerja Azure Databricks Anda, klik nama pengguna Azure Databricks Anda di bilah atas, lalu pilih Pengaturan dari menu drop-down.
2. Klik Pengembang.
3. Di samping Token akses, klik Kelola.
4. Klik Buat token baru.
5. (Opsional) Masukkan komentar yang membantu Anda mengidentifikasi token ini di masa mendatang, dan mengubah masa pakai default token selama 90 hari. Untuk membuat token tanpa masa pakai (tidak disarankan), biarkan kotak Seumur Hidup (hari) kosong (kosong).
6. Klik Buat.
7. Salin token yang ditampilkan ke lokasi aman, lalu klik Selesai.

Catatan

Pastikan untuk menyimpan token yang disalin di lokasi yang aman. Jangan bagikan token yang Anda salin dengan orang lain. Jika Anda kehilangan token yang disalin, Anda tidak dapat meregenerasi token yang sama persis. Sebagai gantinya, Anda harus mengulangi prosedur ini untuk membuat token baru. Jika Anda kehilangan token yang disalin, atau Anda yakin bahwa token telah disusupi, Databricks sangat menyarankan agar Anda segera menghapus token tersebut dari ruang kerja Anda dengan mengklik ikon tempat sampah (Cabut) di samping token di halaman Token akses.

Jika Anda tidak dapat membuat atau menggunakan token di ruang kerja, ini mungkin karena administrator ruang kerja Anda telah menonaktifkan token atau belum memberi Anda izin untuk membuat atau menggunakan token. Lihat administrator ruang kerja Anda atau berikut ini:

• Mengaktifkan atau menonaktifkan autentikasi token akses pribadi untuk ruang kerja
• Izin token akses pribadi

Dan, misalnya, untuk membuat profil konfigurasi bernama DEFAULT untuk token akses pribadi Anda, lakukan hal berikut:

Catatan

Prosedur berikut menggunakan Databricks CLI untuk membuat profil konfigurasi Azure Databricks dengan nama DEFAULT. Jika Anda sudah memiliki DEFAULT profil konfigurasi, prosedur ini akan menimpa profil konfigurasi yang ada DEFAULT .

Untuk memeriksa apakah Anda sudah memiliki DEFAULT profil konfigurasi, dan untuk melihat pengaturan profil ini jika ada, gunakan Databricks CLI untuk menjalankan perintah databricks auth env --profile DEFAULT.

Untuk membuat profil konfigurasi dengan nama selain DEFAULT, ganti DEFAULT bagian --profile DEFAULT dalam perintah berikut databricks configure dengan nama yang berbeda untuk profil konfigurasi.

1. Gunakan Databricks CLI untuk membuat profil konfigurasi Azure Databricks bernama DEFAULT yang menggunakan autentikasi token akses pribadi Azure Databricks. Untuk melakukannya, jalankan perintah berikut:

   databricks configure --profile DEFAULT
   

2. Untuk Permintaan Host Databricks, masukkan URL per ruang kerja Azure Databricks Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net.

3. Untuk perintah Token Akses Pribadi, masukkan token akses pribadi Azure Databricks untuk ruang kerja Anda.

Setelah profil konfigurasi Azure Databricks Anda siap, dengan proyek dan ekstensi Anda dibuka, lakukan hal berikut:

1. Di panel Konfigurasi , klik Konfigurasikan Databricks.

   Catatan

   Jika Konfigurasikan Databricks tidak terlihat, klik ikon gigi (Konfigurasikan ruang kerja) di samping Konfigurasi sebagai gantinya.

   

2. Di Palet Perintah, untuk Host Databricks, masukkan URL per ruang kerja Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net. Lalu tekan Enter.

3. Pilih profil konfigurasi Azure Databricks target Anda dalam daftar untuk URL.

Ekstensi membuat folder tersembunyi di proyek Anda bernama .databricks jika belum ada. Ekstensi juga membuat di folder ini file bernama project.json jika belum ada. File ini berisi URL yang Anda masukkan, bersama dengan beberapa detail autentikasi Azure Databricks yang perlu dioperasikan ekstensi Databricks untuk Visual Studio Code.

Ekstensi ini juga menambahkan file tersembunyi .gitignore ke proyek jika file tidak ada atau jika ada .gitignore tidak dapat ditemukan di folder induk mana pun. Jika file baru .gitignore dibuat, ekstensi menambahkan .databricks/ entri ke file baru ini. Jika ekstensi menemukan file yang ada .gitignore , ekstensi akan menambahkan .databricks/ entri ke file yang ada.

Lanjutkan dengan Pilih kluster untuk ekstensi Databricks untuk Visual Studio Code.

Menyiapkan autentikasi OAuth U2M

Azure Databricks mendukung autentikasi pengguna OAuth ke komputer (U2M). Ini memungkinkan Anda menghasilkan token akses OAuth berumur pendek (satu jam), yang menghilangkan risiko secara tidak sengaja mengekspos token berumur panjang seperti token akses pribadi Azure Databricks melalui pemeriksaan kontrol versi atau cara lain. Ini juga memungkinkan pembatalan dan cakupan sesi sisi server yang lebih baik.

Untuk menyelesaikan penyiapan autentikasi OAuth U2M, dengan proyek Anda dan ekstensi dibuka, lakukan hal berikut:

1. Di panel Konfigurasi , klik Konfigurasikan Databricks.

   Catatan

   Jika Konfigurasikan Databricks tidak terlihat, klik ikon gigi (Konfigurasikan ruang kerja) di samping Konfigurasi sebagai gantinya.

   

2. Di Palet Perintah, untuk Host Databricks, masukkan URL per ruang kerja Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net. Lalu tekan Enter.

3. Pilih OAuth (pengguna ke komputer).

4. Selesaikan instruksi di layar di browser web Anda untuk menyelesaikan autentikasi dengan akun Azure Databricks Anda. Jika diminta, izinkan akses semua api .

Ekstensi membuat folder tersembunyi di proyek Anda bernama .databricks jika belum ada. Ekstensi juga membuat di folder ini file bernama project.json jika belum ada. File ini berisi URL yang Anda masukkan, bersama dengan beberapa detail autentikasi Azure Databricks yang perlu dioperasikan ekstensi Databricks untuk Visual Studio Code.

Ekstensi ini juga menambahkan file tersembunyi .gitignore ke proyek jika file tidak ada atau jika ada .gitignore tidak dapat ditemukan di folder induk mana pun. Jika file baru .gitignore dibuat, ekstensi menambahkan .databricks/ entri ke file baru ini. Jika ekstensi menemukan file yang ada .gitignore , ekstensi akan menambahkan .databricks/ entri ke file yang ada.

Lanjutkan dengan Pilih kluster untuk ekstensi Databricks untuk Visual Studio Code.

Menyiapkan autentikasi Azure CLI

Azure Databricks mendukung autentikasi dengan Azure CLI yang diinstal secara lokal. Ini memungkinkan Anda menghasilkan token ID Microsoft Entra berumur pendek (satu jam) (sebelumnya Azure Active Directory), yang menghilangkan risiko secara tidak sengaja mengekspos token berumur panjang seperti token akses pribadi Azure Databricks melalui pemeriksaan kontrol versi atau cara lain.

Dengan proyek Anda dan ekstensi dibuka, dan Azure CLI diinstal secara lokal, lakukan hal berikut:

1. Di panel Konfigurasi , klik Konfigurasikan Databricks.

   Catatan

   Jika Konfigurasikan Databricks tidak terlihat, klik ikon gigi (Konfigurasikan ruang kerja) di samping Konfigurasi sebagai gantinya.

   

2. Di Palet Perintah, untuk Host Databricks, masukkan URL per ruang kerja Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net. Lalu tekan Enter.

3. Pilih Azure CLI.

Ekstensi membuat folder tersembunyi di proyek Anda bernama .databricks jika belum ada. Ekstensi juga membuat di folder ini file bernama project.json jika belum ada. File ini berisi URL yang Anda masukkan, bersama dengan beberapa detail autentikasi Azure Databricks yang perlu dioperasikan ekstensi Databricks untuk Visual Studio Code.

Ekstensi ini juga menambahkan file tersembunyi .gitignore ke proyek jika file tidak ada atau jika ada .gitignore tidak dapat ditemukan di folder induk mana pun. Jika file baru .gitignore dibuat, ekstensi menambahkan .databricks/ entri ke file baru ini. Jika ekstensi menemukan file yang ada .gitignore , ekstensi akan menambahkan .databricks/ entri ke file yang ada.

Lanjutkan dengan Pilih kluster untuk ekstensi Databricks untuk Visual Studio Code.