Siapkan otorisasi untuk ekstensi Databricks IDE

Artikel ini menjelaskan cara mengatur otorisasi dan autentikasi antara ekstensi Databricks IDE dan workspace Azure Databricks Anda jika Anda belum mengonfigurasi ekstensi melalui pengaturan proyek. Lihat ekstensi Databricks IDE.

Ekstensi Databricks IDE mengimplementasikan sebagian dari standar autentikasi terpadu Databricks, yang memungkinkan Anda mengonfigurasi otorisasi berbasis Azure Databricks OAuth 2.0 sekali dan kemudian menggunakan konfigurasi tersebut di berbagai alat dan SDK Azure Databricks tanpa perubahan konfigurasi otorisasi dan autentikasi lebih lanjut. Ini juga menyediakan pembaruan otomatis untuk token akses aktif, mengurangi kompleksitas proses Anda saat Anda mengembangkan aplikasi.

Databricks merekomendasikan otorisasi pengguna interaktif OAuth, yang mudah dikonfigurasi menggunakan ekstensi IDE Databricks. Lihat Menyiapkan otorisasi dan autentikasi OAuth.

Jika tidak, jika Anda menggunakan Otentikasi dengan token akses pribadi Azure Databricks (lama), Otorisasi akses principal layanan ke Azure Databricks dengan OAuth, atau Otentikasi dengan principal layanan Microsoft Entra, lihat Siapkan autentikasi dengan profil konfigurasi. Untuk Authenticate dengan Azure CLI, lihat Siapkan autentikasi Azure CLI.

Catatan

Ekstensi Databricks IDE tidak mendukung autentikasi menggunakan Azure managed identities (sebelumnya Azure Managed Service Identities (MSI)), tetapi Databricks Connect yang digunakan tanpa ekstensi Databricks IDE mendukung pengaktifan. Untuk menginstal Databricks Connect, lihat Install Databricks Connect untuk Python.

Menyiapkan otorisasi dan autentikasi OAuth

Azure Databricks mendukung otorisasi dan autentikasi berbasis OAuth 2.0, dan menyederhanakan manajemen token akses dengan autentikasi terpadu Databricks. Untuk detail selengkapnya tentang otorisasi pengguna dan perwakilan layanan dengan Azure Databricks, lihat Otorisasi akses ke sumber daya Azure Databricks.

Untuk menyelesaikan pengaturan otorisasi OAuth, buka proyek VSCode Anda dengan ekstensi Databricks IDE diaktifkan:

1. Dalam tampilan Konfigurasi, klik Jenis Autentikasi, lalu klik ikon gigi (Masuk ke ruang kerja Databricks).

   

2. Jika Anda sudah memiliki profil konfigurasi autentikasi dalam daftar ini yang memiliki label Autentikasi menggunakan OAuth (Pengguna ke Mesin) dan yang Anda ketahui sesuai dengan host Databricks target, pilih dari daftar, lalu lakukan hal berikut:

   1. Jika diminta, selesaikan instruksi di layar di browser web Anda untuk menyelesaikan autentikasi dengan Azure Databricks.
   2. Jika juga diminta, izinkan all-apis access.
   3. Langsung ke Pilih komputasi untuk menjalankan kode dan tugas.

3. Palet Perintah, untuk Pilih metode autentikasi, klik OAuth (pengguna ke mesin).

4. Untuk Pilih metode autentikasi, pilih OAuth (pengguna ke komputer).

5. Masukkan beberapa nama untuk profil autentikasi Azure Databricks terkait.

6. Dalam tampilan Konfigurasi, klik Masuk ke Databricks.

   

7. Palet Perintah, untuk Pilih metode autentikasi, pilih nama profil konfigurasi autentikasi yang baru saja Anda buat.

8. Jika diminta, selesaikan instruksi di layar di browser web Anda untuk menyelesaikan autentikasi dengan Azure Databricks. Jika juga diminta, izinkan all-apis access.

9. Setelah Anda berhasil masuk, kembali ke Visual Studio Code.

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. Untuk membuat profil, lihat profil konfigurasi Azure Databricks. Untuk mengonfigurasi pengaturan profil, lihat tab atau bagian Profile untuk jenis autentikasi Anda di Authorize akses ke sumber daya Azure Databricks.

Untuk memilih profil konfigurasi yang Anda inginkan untuk digunakan ekstensi, dengan proyek Anda dan ekstensi terbuka, lakukan hal berikut:

1. Dalam tampilan Konfigurasi, klik Jenis Autentikasi, lalu klik ikon gigi (Masuk ke ruang kerja Databricks).

   

2. Di Palet Perintah, pilih profil konfigurasi Azure Databricks target Anda dalam daftar.

   Petunjuk / Saran

   Host ruang kerja target dapat diubah nanti dengan memodifikasi pengaturan target workspace dalam file konfigurasi databricks.yml yang terkait dengan proyek. Lihat sasaran.

Jika Anda tidak memiliki profil konfigurasi, Anda dapat membuat profil yang mengautentikasi dengan menggunakan token akses pribadi Azure Databricks misalnya, sebagai berikut:

1. Dengan proyek Anda dan ekstensi terbuka, dalam tampilan Konfigurasi, klik Jenis Autentikasi atau Masuk ke Databricks, lalu klik ikon roda gigi (Masuk ke ruang kerja Databricks).

   

2. Di Panel Perintah, pilih Token Akses Pribadi.

3. Selesaikan perintah di layar untuk melakukan hal berikut:

   1. Masukkan beberapa nama untuk profil autentikasi Azure Databricks terkait.
   2. Buat token akses pribadi di ruang kerja Azure Databricks Anda lalu salin nilai token.
   3. Kembali ke ekstensi dan masukkan nilai token yang disalin.

Ekstensi membuat folder di proyek Anda bernama .databricks dengan file bernama databricks.env, jika belum ada. File ini berisi host workspace yang Anda masukkan, bersama dengan detail konfigurasi Azure Databricks lainnya yang digunakan oleh ekstensi IDE Databricks.

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.

Siapkan autentikasi Azure CLI

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

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

1. Dalam tampilan Konfigurasi, klik Konfigurasikan Databricks.

   Catatan

   Jika Konfigurasikan Databricks tidak terlihat, klik ikon roda gigi (Konfigurasikan ruang kerja) yang ada di samping Konfigurasi.

   

2. Dalam Palet Perintah, untuk Tuan Rumah Databricks, masukkan URL per-ruang kerja Anda, contohnya https://adb-1234567890123456.7.azuredatabricks.net. Lalu tekan Enter.

3. Pilih Azure CLI.