Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Nota
Artikel ini membahas Databricks Connect untuk Databricks Runtime 13.3 LTS ke atas.
Artikel ini menyediakan persyaratan penggunaan untuk Databricks Connect. Untuk informasi tentang Databricks Connect, lihat Databricks Connect.
Persyaratan ruang kerja
Untuk menggunakan Databricks Connect untuk menyambungkan ke ruang kerja Anda:
Akun Azure Databricks dan ruang kerja Anda harus mengaktifkan Katalog Unity. Lihat Mulai menggunakan Katalog Unity dan Mengaktifkan ruang kerja untuk Katalog Unity.
Versi Databricks Runtime komputasi Anda harus lebih besar dari atau sama dengan versi paket Databricks Connect. Databricks merekomendasikan agar Anda menggunakan paket Databricks Connect terbaru yang cocok dengan versi Databricks Runtime Anda.
Untuk menggunakan fitur yang tersedia di versi Databricks Runtime yang lebih baru, Anda harus meningkatkan paket Databricks Connect. Lihat catatan rilis Databricks Connect untuk daftar rilis Databricks Connect yang tersedia. Untuk catatan rilis versi Databricks Runtime, lihat Versi dan kompatibilitas catatan rilis Databricks Runtime.
Jika Anda tersambung ke komputasi tanpa server, ruang kerja Anda harus memenuhi persyaratan untuk komputasi tanpa server.
Nota
Komputasi tanpa server didukung dimulai dengan Databricks Connect versi 15.1. Versi Databricks Connect yang lebih rendah atau sama dengan versi Databricks Runtime pada layanan tanpa server sepenuhnya kompatibel. Lihat Catatan rilis. Untuk memverifikasi apakah versi Databricks Connect kompatibel dengan komputasi tanpa server, lihat Memvalidasi koneksi ke Databricks.
Jika Anda menyambungkan ke kluster, mode akses milik kluster target Anda harus berupa Ditetapkan atau Dibagikan. Lihat Mode akses.
Persyaratan lingkungan lokal
Untuk menginstal Databricks Connect, lingkungan pengembangan lokal Anda harus memenuhi persyaratan berikut:
Python
Proses autentikasi ke Databricks telah dikonfigurasi. Bergantung pada jenis autentikasi Databricks mungkin ada persyaratan:
Untuk autentikasi pengguna-ke-mesin (U2M) OAuth, Anda harus menggunakan Databricks CLI untuk mengautentikasi sebelum menjalankan kode Anda. Lihat tutorial Databricks Connect for Python.
autentikasi OAuth user-to-machine (U2M) dan autentikasi OAuth machine-to-machine (M2M) didukung pada Databricks SDK untuk Python 0.19.0 ke atas. Untuk memperbarui versi yang terinstal dari SDK Databricks untuk Python di proyek Anda, lihat Memulai dengan SDK Databricks untuk Python.
Python 3 diinstal, dan versi minor Python yang diinstal memenuhi persyaratan versi dalam tabel kompatibilitas versi di bawah ini.
Jika Anda menggunakan fungsi yang didefinisikan pengguna (UDF), versi minor lokal Python akan cocok dengan versi minor Python dari Databricks Runtime yang digunakan pada kluster atau komputasi serverless. Untuk menemukan versi Python kecil dari versi Databricks Runtime kluster Anda, lihat bagian lingkungan System dari catatan rilis Databricks Runtime untuk versi tersebut. Lihat Versi dan kompatibilitas catatan rilis Databricks Runtime serta Catatan rilis komputasi tanpa server.
Scala
Proses autentikasi ke Databricks telah dikonfigurasi. Bergantung pada jenis autentikasi Databricks mungkin ada persyaratan:
Untuk autentikasi pengguna-ke-mesin (U2M) OAuth, Anda harus menggunakan Databricks CLI untuk mengautentikasi sebelum menjalankan kode Anda. Lihat tutorial Databricks Connect for Scala.
autentikasi OAuth user-to-machine (U2M) dan autentikasi OAuth machine-to-machine (M2M) didukung pada Databricks SDK untuk Java 0.18.0 ke atas. Untuk memperbarui versi SDK Databricks yang diinstal pada proyek Anda untuk Java, lihat Memulai dengan SDK Databricks untuk Java.
Untuk Databricks Connect untuk Databricks Runtime 13.3 LTS ke atas, untuk Scala, Databricks Connect menyertakan Databricks SDK untuk Java. SDK ini menerapkan standar autentikasi terpadu Databricks .
Kit Pengembangan Java (JDK) diinstal. Databricks merekomendasikan agar versi penginstalan JDK Anda cocok dengan versi JDK pada kluster Azure Databricks Anda. Untuk menemukan versi JDK dari Databricks Runtime pada kluster Anda, lihat bagian Lingkungan sistem dari catatan rilis Databricks Runtime atau tabel kompatibilitas versi.
Nota
Menggunakan versi JDK yang tidak cocok dengan versi JDK kluster Anda dapat menyebabkan perilaku tak terduga atau mencegah kode Anda berjalan.
Scala sudah diinstal. Databricks merekomendasikan agar versi penginstalan Scala Anda cocok dengan versi Scala pada kluster Azure Databricks Anda. Untuk menemukan versi Scala dari versi Databricks Runtime kluster Anda, lihat bagian Lingkungan sistem dari catatan rilis Databricks Runtime atau tabel kompatibilitas versi.
Jika Anda menggunakan fungsi yang ditentukan pengguna (UDF), versi Scala dan Java lokal cocok dengan versi Scala dan Java dari versi Databricks Runtime kluster. Untuk menemukan versi Scala dan Java dari versi Databricks Runtime kluster Anda, lihat bagian System environment dari catatan rilis Runtime Databricks atau tabel kompatibilitas versi di bawah ini.
Alat build untuk Scala, seperti sbt, telah diinstal.
Versi Databricks Connect
Tabel berikut ini memperlihatkan Databricks Connect yang didukung dan versi bahasa yang kompatibel. Nomor versi Databricks Connect sesuai dengan nomor versi Databricks Runtime. Lihat catatan rilis Databricks Connect untuk daftar rilis Databricks Connect yang tersedia. Untuk catatan rilis versi Databricks Runtime, lihat Versi dan kompatibilitas catatan rilis Databricks Runtime.
Python
Untuk dukungan UDF, lihat lingkungan dasar Python.
| Versi Databricks Connect | Jenis komputasi | Versi Python yang kompatibel |
|---|---|---|
| 18.0 hingga 18.1 | Kelompok | 3.12 |
| 18,0 | Tanpa server, versi 5 | 3.12 |
| 17.2 hingga 17.3 | Tanpa server, versi 4 | 3.12 |
| 17.2 hingga 17.3 | Kelompok | 3.12 |
| 16.4.1 hingga di bawah 17 | Tanpa server, versi 3 | 3.12 |
| 16.4 | Kelompok | 3.12 |
| 15.4.10 hingga di bawah 16 | Tanpa server, versi 2 | 3.11 |
| 15.4 | Kelompok | 3.11 |
| 14.3 | Kelompok | 3.10 |
| 13.3 | Kelompok | 3.10 |
Scala
| Versi Databricks Connect | Jenis komputasi | Versi JDK | Versi Scala |
|---|---|---|---|
| 18.0 hingga 18.1 | Kelompok | JDK 21 | 2.13.16 |
| 17.2 hingga 17.3 | Tanpa server, versi 4 | JDK 17 | 2.13.16 |
| 17.2 hingga 17.3 | Kelompok | JDK 17 | 2.13.16 |
| 16.4 | Kelompok | JDK 17 | 2.12.18 |
| 15.4 | Kelompok | JDK 8 | 2.12.18 |
| 14.3 | Kelompok | JDK 8 | 2.12.15 |
| 13.3 | Kelompok | JDK 8 | 2.12.15 |
Versi yang tidak lagi didukung
Databricks Connect mengikuti siklus hidup dukungan Databricks Runtime. Versi berikut telah mencapai akhir dukungan teknis. Jika Anda menggunakan versi Databricks Connect yang telah mencapai akhir dukungan, tingkatkan ke versi yang didukung.
Python
| Versi Databricks Connect | Jenis komputasi | Versi Python yang kompatibel |
|---|---|---|
| 17.0 hingga 17.1 | Tanpa server, versi 4 | 3.12 |
| 16.0 hingga 16.4.0 | Serverless | Tidak ada versi Python yang kompatibel. Tingkatkan ke Databricks Connect 16.4.1 atau yang lebih tinggi. |
| 16.0 hingga 16.3 | Kelompok | 3.12 |
| 15.1 hingga 15.4.9 | Serverless | Tidak ada versi Python yang kompatibel. Tingkatkan ke Databricks Connect 15.4.10 atau lebih tinggi. |
| 15.1 hingga 15.3 | Kelompok | 3.11 |
| 14.0 hingga 14.2 | Kelompok | 3.10 |
| 13.0 hingga 13.2 | Kelompok | 3.10 |
Scala
| Versi Databricks Connect | Jenis komputasi | Versi JDK | Versi Scala |
|---|---|---|---|
| 16.0 hingga 16.3 | Kelompok | JDK 17 | 2.12.18 |
| 15.1 hingga 15.3 | Kelompok | JDK 8 | 2.12.18 |
| 14.0 hingga 14.2 | Kelompok | JDK 8 | 2.12.15 |