Menggunakan JDBC untuk terhubung ke MaxCompute - MaxCompute

Driver Java Database Connectivity (JDBC) MaxCompute menyediakan API JDBC standar. Anda dapat melakukan komputasi terdistribusi dan menjalankan kueri terhadap data dalam jumlah besar di MaxCompute melalui API JDBC tersebut. Selain itu, driver ini memungkinkan Anda menghubungkan berbagai alat yang mendukung JDBC ke MaxCompute.

Catatan penggunaan

Gunakan driver JDBC MaxCompute untuk terhubung ke MaxCompute. Untuk informasi selengkapnya, lihat Catatan penggunaan.
Gunakan driver JDBC MaxCompute untuk menghubungkan alat analisis Business Intelligence (BI) ke MaxCompute, sehingga Anda dapat menganalisis data di MaxCompute secara visual. Referensi:
Gunakan driver JDBC MaxCompute untuk menghubungkan alat manajemen database ke MaxCompute, sehingga Anda dapat mengelola Proyek MaxCompute melalui alat tersebut. Referensi:

Catatan penggunaan

Untuk mengeksekusi pernyataan SQL dan memperoleh hasil eksekusinya menggunakan driver JDBC MaxCompute, Anda harus memenuhi persyaratan berikut:
- Anda adalah anggota suatu Proyek.
- Anda memiliki izin CreateInstance pada Proyek tersebut.
- Anda memiliki izin Select dan Download pada tabel yang ingin Anda gunakan.
  Catatan
  - Saat menggunakan MaxCompute JDBC V1.9 atau versi sebelumnya, sebuah tabel sementara dibuat secara otomatis untuk setiap kueri. Hasil kueri dapat diambil dari tabel sementara tersebut menggunakan perintah Tunnel. Untuk menggunakan versi ini, Anda harus memiliki izin CreateTable.
  - Saat menggunakan MaxCompute JDBC V2.2 atau versi yang lebih baru, tidak ada tabel sementara yang dibuat secara otomatis untuk setiap kueri. Anda dapat memanggil antarmuka Instance Tunnel untuk mengambil hasil kueri, terlepas dari apakah Anda memiliki izin CreateTable atau tidak.
  Untuk informasi lebih lanjut tentang izin MaxCompute, lihat Izin MaxCompute.
MaxCompute menyediakan fitur perlindungan data. Jika fitur ini diaktifkan untuk suatu Proyek, data tidak dapat dipindahkan keluar dari Proyek tersebut. Apabila Anda menggunakan MaxCompute JDBC versi sebelum V2.4, tidak ada set hasil yang dapat diperoleh. Namun, jika Anda menggunakan MaxCompute JDBC V2.4 atau versi yang lebih baru, jumlah baris hasil yang diambil tidak boleh melebihi nilai parameter READ_TABLE_MAX_ROW. Untuk informasi selengkapnya tentang parameter ini, lihat Operasi Proyek. Informasi lebih lanjut mengenai fitur perlindungan data tersedia di Mekanisme perlindungan data.
Edisi tipe data MaxCompute 2.0 mendukung lebih banyak tipe data, seperti TINYINT, SMALLINT, DATETIME, TIMESTAMP, ARRAY, MAP, dan STRUCT. Untuk menggunakan tipe data baru ini, Anda harus menjalankan perintah berikut guna mengaktifkan edisi tipe data MaxCompute 2.0. Untuk informasi selengkapnya, lihat Edisi tipe data.
```
set odps.sql.type.system.odps2=true
```
Untuk JDBC V3.4.1 dan versi yang lebih baru, jika Anda memiliki pernyataan SQL panjang (lebih dari 1 KB), Anda perlu mengontrol konkurensi dengan hati-hati. Sebagai contoh, saat menggunakan Instance ECS dengan 8 vCPU dan memori 16,0 GiB, kami menyarankan agar tingkat konkurensi tidak melebihi 100. Jika Anda tidak dapat mengontrol konkurensi permintaan secara efektif, pertimbangkan untuk meningkatkan ke JDBC V3.8.8 atau V3.9.3, lalu atur skipCheckIfSelect=true untuk melewati fitur penguraian SQL. Untuk informasi selengkapnya tentang fitur ini, lihat Riwayat pembaruan versi.

FAQ

Bagaimana cara melihat file log driver JDBC MaxCompute?
- Secara default, file log driver JDBC MaxCompute disimpan di direktori yang sama dengan paket JAR driver JDBC MaxCompute, dengan nama file jdbc.log.
- Jika kode dan driver JDBC MaxCompute berada dalam paket uber JAR yang sama, file log disimpan di direktori yang sama dengan paket uber JAR tersebut.
Log driver JDBC MaxCompute mencatat detail panggilan API JDBC, seperti nama kelas, nama metode, parameter, nilai kembali, dan jumlah baris, yang dapat digunakan untuk debugging.
Bagaimana cara memperoleh URL Logview MaxCompute?
Driver JDBC MaxCompute dienkapsulasi berdasarkan MaxCompute SDK untuk Java. URL Logview dihasilkan saat Anda mengeksekusi pernyataan SQL di klien MaxCompute, MaxCompute Studio, dan DataWorks, serta saat menggunakan driver JDBC MaxCompute untuk mengeksekusi pernyataan SQL. URL ini memungkinkan Anda melihat status pekerjaan, melacak progres, dan memperoleh hasil eksekusi. URL Logview dikonfigurasi melalui parameter properties.log4j. Secara default, log ditampilkan sebagai log kesalahan standar.
Apakah MaxCompute mendukung kolam koneksi dan mode auto-commit?
MaxCompute menyediakan layanan REST yang berbeda dari koneksi panjang di database tradisional. Dianggap sebagai tugas ringan bagi driver MaxCompute JDBC untuk membuat koneksi. Meskipun driver mendukung skenario di mana kumpulan koneksi digunakan, kumpulan koneksi tidak diperlukan untuk driver MaxCompute JDBC.
MaxCompute tidak mendukung transaksi. Setiap kueri langsung dieksekusi di server, sehingga mode auto-commit diaktifkan secara otomatis pada driver JDBC MaxCompute dan tidak dapat dinonaktifkan.
Bagaimana cara memperoleh bidang partisi dan tipe data?
Anda dapat menggunakan metode Connection.getMetadata() untuk memperoleh objek DatabaseMetaData, lalu menggunakan metode getColumns() guna mendapatkan metadata semua kolom.