Menyiapkan otorisasi untuk ekstensi Databricks untuk Visual Studio Code

Artikel ini menjelaskan cara menyiapkan otorisasi dan autentikasi antara ekstensi Databricks untuk Visual Studio Code dan ruang kerja Azure Databricks Jika Anda belum mengonfigurasi ekstensi melalui penyiapan proyek. Lihat Apa itu ekstensi Databricks untuk Visual Studio Code?.

Ekstensi Databricks untuk Visual Studio Code menerapkan bagian dari standar autentikasi terpadu Databricks , yang memungkinkan Anda mengonfigurasi otorisasi berbasis Azure Databricks OAuth 2.0 sekali dan kemudian menggunakan konfigurasi tersebut di beberapa 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 Databricks untuk Visual Studio Code. Lihat Menyiapkan otorisasi dan autentikasi OAuth.

Jika tidak, jika Anda menggunakan Autentikasi dengan token akses pribadi Azure Databricks (warisan), Otorisasi akses perwakilan layanan ke Azure Databricks dengan OAuth, atau Autentikasi dengan perwakilan layanan Microsoft Entra, lihat Menyiapkan autentikasi dengan profil konfigurasi. Untuk Mengautentikasi dengan Azure CLI, lihat Menyiapkan autentikasi Azure CLI.

Catatan

Ekstensi Databricks untuk Visual Studio Code tidak mendukung autentikasi menggunakan identitas terkelola Azure (sebelumnya Azure Managed Service Identities (MSI)), tetapi Databricks Connect digunakan tanpa ekstensi Databricks untuk Visual Studio Code. Untuk menginstal Databricks Connect, lihat Instal 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 Mengotorisasi akses ke sumber daya Azure Databricks.

Untuk menyelesaikan penyiapan otorisasi OAuth, buka proyek VSCode Anda dengan ekstensi Databricks untuk Visual Studio Code 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 Profil atau bagian untuk jenis autentikasi Anda di Mengotorisasi 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. Pilih profil konfigurasi Azure Databricks target Anda dalam daftar di Palet Perintah.

   Petunjuk / Saran

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

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 ruang kerja yang Anda masukkan, bersama dengan detail konfigurasi Azure Databricks lainnya yang digunakan oleh 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.

Menyiapkan autentikasi Azure CLI

Azure Databricks mendukung autentikasi dengan Azure CLI yang diinstal secara lokal. Hal ini memungkinkan Anda membuat token ID Microsoft Entra berumur pendek (satu jam), sehingga mengurangi risiko paparan yang tidak disengaja terhadap token berumur panjang seperti token akses pribadi Azure Databricks melalui pengecekan ke dalam sistem kontrol versi atau metode lain.

Dengan proyek Anda dan ekstensi 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.