Driver Databricks untuk SQLTools untuk Visual Studio Code
Penting
Fitur ini ada di Pratinjau Publik.
Driver Databricks untuk SQLTools memungkinkan Anda menggunakan ekstensi SQLTools untuk Visual Studio Code untuk menelusuri objek SQL dan menjalankan kueri SQL di ruang kerja Azure Databricks jarak jauh.
Sebelum Anda mulai
Sebelum Anda dapat menggunakan Driver Databricks untuk SQLTools, ruang kerja Azure Databricks dan mesin pengembangan lokal Anda harus memenuhi persyaratan berikut.
Persyaratan ruang kerja
Anda harus memiliki setidaknya satu ruang kerja Azure Databricks yang tersedia, dan ruang kerja harus memenuhi persyaratan berikut:
Ruang kerja harus berisi setidaknya satu gudang Databricks SQL.
Untuk ruang kerja yang diaktifkan untuk Katalog Unity, ruang kerja harus berisi setidaknya satu katalog, dengan setidaknya satu skema (secara resmi disebut database) dalam katalog tersebut.
- Menjelajahi objek database.
- Buat katalog.
- Buat skema.
Untuk ruang kerja yang tidak diaktifkan untuk Unity Catalog, ruang kerja harus berisi setidaknya satu skema (sebelumnya disebut database).
- Menjelajahi objek database.
- Buat skema.
Persyaratan komputer pengembangan lokal
Anda harus memiliki hal berikut di komputer pengembangan lokal Anda:
- Visual Studio Code versi 1.70 atau yang lebih tinggi. Untuk melihat versi yang diinstal, klik Kode > Tentang Visual Studio Code dari menu manin di Linux atau macOS dan Bantuan > Tentang di Windows. Untuk mengunduh, menginstal, dan mengonfigurasi Visual Studio Code, lihat Menyiapkan Visual Studio Code.
- Ekstensi SQLTools untuk Visual Studio Code.
- Ekstensi Driver Databricks untuk SQLTools untuk Visual Studio Code.
Untuk menginstal ekstensi SQLTools, buka SQLTools lalu klik Instal, atau:
Di Visual Studio Code, klik Tampilkan > Ekstensi di menu utama.
Dalam kotak Ekstensi Pencarian di Marketplace , masukkan
SQLTools
.Klik entri SQLTools dari Matheus Teixeira.
Catatan
Mungkin ada beberapa entri SQLTools yang tercantum. Pastikan untuk mengklik entri dari Matheus Teixeira.
Klik Pasang.
Untuk menginstal ekstensi Databricks Driver for SQLTools, buka Driver Databricks untuk SQLTools lalu klik Instal, atau:
- Di Visual Studio Code, klik Tampilkan > Ekstensi di menu utama.
- Dalam kotak Ekstensi Pencarian di Marketplace , masukkan
Databricks Driver for SQLTools
. - Klik entri Driver Databricks untuk SQLTools.
- Klik Pasang.
Autentikasi
Anda harus menyiapkan autentikasi untuk Driver Databricks untuk SQLTools sebagai berikut.
Driver Databricks untuk SQLTools mendukung jenis autentikasi Azure Databricks berikut:
- Autentikasi token akses pribadi Azure Databricks
- Autentikasi mesin-ke-mesin (M2M) Azure Databricks OAuth
- Autentikasi pengguna ke komputer (U2M) Azure Databricks OAuth
- Autentikasi Azure CLI
Catatan
Driver Databricks untuk SQLTools tidak mendukung token ID Microsoft Entra.
Autentikasi token akses pribadi Azure Databricks
Untuk menggunakan Driver Databricks untuk SQLTools dengan autentikasi token akses pribadi Azure Databricks, Anda harus memiliki token akses pribadi Azure Databricks. Untuk membuat token akses pribadi, lakukan hal berikut:
- Di ruang kerja Azure Databricks Anda, klik nama pengguna Azure Databricks Anda di bilah atas, lalu pilih Pengaturan dari menu drop-down.
- Klik Pengembang.
- Di samping Token akses, klik Kelola.
- Klik Buat token baru.
- (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).
- Klik Buat.
- 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 topik berikut:
Autentikasi mesin-ke-mesin (M2M) Azure Databricks OAuth
Anda dapat menggunakan autentikasi azure Databricks OAuth machine-to-machine (M2M) untuk mengautentikasi dengan Driver Databricks untuk SQLTools, sebagai berikut:
Catatan
Autentikasi Azure Databricks OAuth M2M tersedia di Driver Databricks untuk SQLTools versi 0.4.2 ke atas.
- Selesaikan langkah-langkah konfigurasi untuk autentikasi M2M OAuth. Lihat Autentikasi mesin-ke-mesin (M2M) OAuth.
- Buat profil konfigurasi Azure Databricks dengan pengaturan konfigurasi autentikasi M2M OAuth Anda. Lihat bagian "Konfigurasi" dari autentikasi mesin-ke-mesin (M2M) OAuth.
- Instal dan buka ekstensi Databricks untuk Visual Studio Code di komputer pengembangan lokal Anda.
- Di ekstensi Databricks untuk Visual Studio Code, klik tombol Konfigurasi di panel Konfigurasi . Jika tombol Konfigurasi tidak ditampilkan, klik ikon gigi (Konfigurasikan ruang kerja) sebagai gantinya.
- Di Palet Perintah, untuk Host Databricks, masukkan URL per ruang kerja Azure Databricks Anda, misalnya
https://adb-1234567890123456.7.azuredatabricks.net
, lalu tekan Enter. - Pilih entri profil konfigurasi yang cocok dengan yang Anda buat di langkah 2.
- Selesaikan instruksi di layar di browser web Anda untuk menyelesaikan autentikasi dengan akun Azure Databricks Anda.
Autentikasi pengguna ke komputer (U2M) Azure Databricks OAuth
Anda dapat menggunakan autentikasi user-to-machine (U2M) Azure Databricks OAuth untuk mengautentikasi dengan Driver Databricks untuk SQLTools, sebagai berikut:
Catatan
Autentikasi Azure Databricks OAuth U2M tersedia di Driver Databricks untuk SQLTools versi 0.4.2 ke atas.
- Instal dan buka ekstensi Databricks untuk Visual Studio Code di komputer pengembangan lokal Anda.
- Di ekstensi Databricks untuk Visual Studio Code, klik tombol Konfigurasi di panel Konfigurasi . Jika tombol Konfigurasi tidak ditampilkan, klik ikon gigi (Konfigurasikan ruang kerja) sebagai gantinya.
- Di Palet Perintah, untuk Host Databricks, masukkan URL Per ruang kerja Azure Databricks Anda, misalnya
https://adb-1234567890123456.7.azuredatabricks.net
. Lalu tekan Enter. - Pilih OAuth (pengguna ke komputer).
- Selesaikan instruksi di layar di browser web Anda untuk menyelesaikan autentikasi dengan akun Azure Databricks Anda. Jika diminta, izinkan
all-apis
akses.
Autentikasi Azure CLI
Anda dapat menggunakan Azure CLI untuk mengautentikasi dengan Driver Databricks untuk SQLTools, sebagai berikut:
Catatan
Mengautentikasi dengan Azure CLI berada dalam status fitur Eksperimental . Fitur ini tersedia di Driver Databricks untuk SQLTools versi 0.4.2 ke atas.
- Instal Azure CLI di komputer pengembangan lokal Anda, jika Anda belum melakukannya.
- Instal dan buka ekstensi Databricks untuk Visual Studio Code di komputer pengembangan lokal Anda.
- Di ekstensi Databricks untuk Visual Studio Code, klik tombol Konfigurasi di panel Konfigurasi . Jika tombol Konfigurasi tidak ditampilkan, klik ikon gigi (Konfigurasikan ruang kerja) sebagai gantinya.
- Di Palet Perintah, untuk Host Databricks, masukkan URL Per ruang kerja Azure Databricks Anda, misalnya
https://adb-1234567890123456.7.azuredatabricks.net
. Lalu tekan Enter. - Pilih Azure CLI.
- Ikuti perintah di layar untuk menyelesaikan autentikasi dengan Azure CLI.
Menyambungkan ke skema
- Di Visual Studio Code, pada bar samping, klik ikon SQLTools .
- Dalam tampilan SQLTools, jika ini pertama kalinya Anda menggunakan ekstensi SQLTools, klik Tambahkan Koneksi Baru di dalam panel Koneksi. Jika tidak, klik ikon Tambahkan Koneksi Baru di bilah judul panel.
- Pada tab Pengaturan SQLTools, untuk langkah Pilih driver database, klik ikon Databricks .
- Untuk langkah Pengaturan Koneksi, masukkan informasi berikut tentang gudang, katalog, dan skema Anda:
Untuk Nama koneksi, masukkan beberapa nama unik untuk koneksi ini.
(Opsional) Untuk Grup koneksi masukkan nama grup koneksi yang sudah ada untuk menambahkan koneksi baru ke grup tersebut. Atau, masukkan nama unik untuk membuat grup koneksi baru dengan koneksi baru. Grup koneksi memudahkan untuk menemukan koneksi di ekstensi.
Untuk Sambungkan menggunakan, pilih salah satu hal berikut ini:
- Untuk menggunakan token akses pribadi Azure Databricks untuk autentikasi, pilih Nama Host dan Token.
- Untuk Driver Databricks untuk SQLTools versi 0.4.2 ke atas, untuk menggunakan otentikasi OAuth U2M atau M2M atau Azure CLI, pilih ekstensi Visual Studio Code (beta).
Jika Anda memilih Nama Host dan Token untuk Sambungkan menggunakan, maka untuk Host, masukkan pengaturan Nama host Server gudang. Untuk mendapatkan pengaturan nama host Server gudang, lihat Mendapatkan detail koneksi untuk sumber daya komputasi Azure Databricks.
Untuk Jalur, masukkan pengaturan jalur HTTP gudang atau kluster. Untuk mendapatkan pengaturan jalur HTTP gudang, lihat Mendapatkan detail koneksi untuk sumber daya komputasi Azure Databricks.
Jika Anda memilih Nama Host dan Token untuk Menyambungkan menggunakan, masukkan nilai token akses pribadi Azure Databricks Anda di Token.
Untuk Katalog, masukkan nama katalog Anda.
Catatan
Untuk ruang kerja yang tidak diaktifkan untuk Katalog Unity, Anda dapat membiarkan Katalog kosong untuk menggunakan nilai
hive_metastore
default .Untuk Skema, masukkan nama skema Anda.
(Opsional) Untuk Tampilkan batas default rekaman, biarkan default
50
ditampilkan hanya hingga 50 baris pertama untuk setiap kueri, atau masukkan batas yang berbeda.
- Klik Uji Koneksi.
- Jika pengujian koneksi berhasil, klik Simpan Koneksi.
Mengubah pengaturan koneksi
Prosedur ini mengasumsikan bahwa Anda telah berhasil terhubung ke setidaknya satu gudang.
- Jika tampilan SQLTools tidak terlihat, maka di Visual Studio Code, di bar samping, klik ikon SQLTools .
- Di panel Koneksi , perluas grup koneksi, jika ada untuk koneksi target Anda.
- Klik kanan koneksi, dan klik Edit Koneksi.
- Ubah pengaturan target.
- Klik Uji Koneksi.
- Jika pengujian koneksi berhasil, klik Simpan Koneksi.
Menelusuri objek skema
- Di panel Koneksi , perluas grup koneksi, jika ada untuk koneksi target Anda.
- Klik dua kali atau perluas koneksi target untuk gudang Anda.
- Perluas database target (skema), jika ada untuk koneksi Anda.
- Perluas Tabel atau Tampilan, jika ada satu atau beberapa tabel atau tampilan untuk database (skema) Anda.
- Perluas tabel atau tampilan target apa pun untuk melihat kolom tabel atau tampilan.
Menampilkan baris atau skema untuk tabel atau tampilan
Dengan Tabel atau Tampilan diperluas di panel Koneksi , lakukan salah satu hal berikut ini:
- Untuk memperlihatkan baris tabel atau tampilan, klik kanan tabel atau tampilan, dan klik Perlihatkan Rekaman Tabel atau Perlihatkan Rekaman Tampilan.
- Untuk memperlihatkan skema tabel atau tampilan, klik kanan tabel atau tampilan, dan klik Jelaskan Tabel atau Jelaskan Tampilan.
Membuat kueri sisipkan untuk tabel
- Tempatkan kursor Anda di editor yang sudah ada di lokasi tempat Anda ingin kueri sisipkan ditambahkan.
- Dengan Tabel diperluas di panel Koneksi , klik kanan tabel, dan klik Buat Sisipkan Kueri. Definisi sisipkan kueri ditambahkan pada titik penyisipan kursor.
Membuat dan menjalankan kueri
Prosedur ini mengasumsikan bahwa Anda telah berhasil terhubung ke setidaknya satu gudang.
- Di panel Koneksi , perluas grup koneksi, jika ada untuk koneksi target Anda.
- Klik dua kali atau perluas koneksi target untuk gudang Anda.
- Dengan koneksi dipilih, klik File SQL Baru di bilah judul panel Koneksi. Tab editor baru muncul.
- Masukkan kueri SQL Anda di editor baru.
- Untuk menjalankan kueri SQL, klik Jalankan pada koneksi aktif di editor. Hasil kueri ditampilkan di tab editor baru.
Menjalankan kueri yang sudah ada
Prosedur ini mengasumsikan bahwa Anda telah berhasil terhubung ke setidaknya satu gudang.
- Di panel Koneksi , perluas grup koneksi, jika ada untuk koneksi target Anda.
- Klik dua kali atau perluas koneksi target untuk gudang Anda.
- Dengan koneksi yang dipilih, buka file apa pun dengan ekstensi
.sql
file , atau pilih grup pernyataan SQL berkelanjutan apa pun di editor apa pun yang sebelumnya dibuka. - Untuk menjalankan kueri SQL dari file yang terbuka
.sql
, dengan konten file Anda.sql
ditampilkan di editor, klik Jalankan pada koneksi aktif di editor. Hasil kueri ditampilkan di tab editor baru. - Untuk menjalankan grup pernyataan SQL berkelanjutan yang dipilih di editor yang sebelumnya dibuka, klik kanan pilihan Anda, lalu klik Jalankan Kueri yang Dipilih. Hasil kueri ditampilkan di tab editor baru.
Mengirim log penggunaan ke Databricks
Jika Anda mengalami masalah saat menggunakan Driver Databricks untuk SQLTools, Anda dapat mengirim log penggunaan dan informasi terkait ke Dukungan Databricks dengan melakukan hal berikut:
- Instal ekstensi Databricks untuk Visual Studio Code di komputer pengembangan lokal Anda.
- Aktifkan pengelogan dengan memeriksa pengaturan Log: Diaktifkan , atau atur
databricks.logs.enabled
ketrue
, seperti yang dijelaskan di Pengaturan untuk ekstensi Databricks untuk Visual Studio Code Pastikan untuk memulai ulang Visual Studio Code setelah Anda mengaktifkan pengelogan. - Cobalah untuk mereprodusi masalah Anda.
- Dari Palet Perintah (Lihat > Palet Perintah dari menu utama), jalankan perintah Databricks: Buka log lengkap.
Databricks Logs.log
Kirim file ,databricks-cli-logs.json
, dansdk-and-extension-logs.json
yang muncul ke Dukungan Databricks.- Salin juga konten Terminal (Lihat > Terminal) dalam konteks masalah, dan kirim konten ini ke Dukungan Databricks.
Tampilan Output (Lihat Output, Log Databricks) menunjukkan informasi terpotong jika Log: Diaktifkan dicentang atau databricks.logs.enabled
diatur ke true
.> Untuk menampilkan informasi selengkapnya, ubah pengaturan berikut, seperti yang dijelaskan di Pengaturan untuk ekstensi Databricks untuk Visual Studio Code:
- Log: Panjang Array Maks atau
databricks.logs.maxArrayLength
- Log: Panjang Bidang Maks atau
databricks.logs.maxFieldLength
- Log: Kedalaman Pemotongan atau
databricks.logs.truncationDepth