All Products
Search

This Product

    MaxCompute:Hubungkan DBeaver ke MaxCompute

    Document Center

    MaxCompute:Hubungkan DBeaver ke MaxCompute

    Last Updated:Jun 22, 2026

    Gunakan alat manajemen database DBeaver untuk mengakses proyek MaxCompute dan mengelola data. Topik ini menjelaskan cara menghubungkan ke proyek menggunakan driver JDBC MaxCompute.

    Informasi latar belakang

    DBeaver adalah alat database gratis lintas platform untuk pengembang, administrator basis data, analis, dan siapa pun yang bekerja dengan database. Untuk informasi lebih lanjut, lihat DBeaver.

    Prasyarat

    Sebelum memulai, pastikan Anda telah memiliki hal berikut:

    • Anda telah membuat proyek MaxCompute.

      Untuk informasi lebih lanjut, lihat Buat proyek MaxCompute.

    • Pasangan Kunci Akses (ID AccessKey dan Secret AccessKey) dengan izin untuk mengakses proyek MaxCompute Anda.

      Untuk informasi lebih lanjut, lihat Buat pasangan Kunci Akses.

    • Anda telah mengunduh paket JAR jar-with-dependencies, yang berisi semua dependensi.

      Anda dapat mengklik odps-jdbc-3.9.0.jar untuk mengunduhnya, atau memperoleh versi terbaru paket JAR MaxCompute dari GitHub atau Repositori Maven. Contoh dalam topik ini menggunakan driver JDBC MaxCompute v3.9.0.

    • Anda telah mengunduh dan menginstal DBeaver.

      Untuk informasi lebih lanjut tentang instalasi, lihat Install. Contoh dalam topik ini menggunakan DBeaver Community Edition 24.3.1.

    Langkah 1: Hubungkan DBeaver ke MaxCompute

    1. Jalankan DBeaver.

    2. Pilih jenis database yang akan dihubungkan.

      Pada bilah menu atas, klik ikon 新建 koneksi baru. Pada kotak dialog Select your database, pilih SQL > SQLite, lalu klik Next. Kotak dialog Generic JDBC Connection Settings akan terbuka.

    3. Edit pengaturan driver.

      1. Pada tab Main pada kotak dialog Generic JDBC Connection Settings, klik Edit Driver Settings.

      2. Tentukan nama kelas dan templat URL.

        Pada kotak dialog Edit Driver 'SQLite', pada tab Settings, atur Class Name menjadi com.aliyun.odps.jdbc.OdpsDriver dan URL Template menjadi jdbc:odps:{file}.

      3. Tambahkan paket JAR driver JDBC.

        Pada tab Libraries pada kotak dialog Edit Driver 'SQLite', klik Add File untuk menambahkan paket JAR driver JDBC MaxCompute odps-jdbc-3.9.0-jar-with-dependencies.jar ke library driver.

      4. Klik OK.

    4. Masukkan URL JDBC.

      Pada tab Main pada kotak dialog Generic JDBC Connection Settings, konfigurasikan JDBC URL.

      Parameter

      Deskripsi

      Connection Method

      Pilih URL.

      JDBC URL

      URL untuk menghubungkan ke proyek MaxCompute.

      • Contoh: jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xx.

      • Format: jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<accessId>&accessKey=<accessKey>[&interactiveMode={true|false}]. Jangan sertakan tanda kurung sudut (<>) dalam URL.

        • <maxCompute_endpoint>: Wajib diisi. Titik akhir Wilayah tempat proyek MaxCompute Anda berada. Untuk informasi lebih lanjut, lihat Endpoints.

        • <maxCompute_project_name>: Wajib diisi. Nama proyek MaxCompute yang akan dihubungkan.

        • accessId: Wajib diisi. ID AccessKey dengan izin untuk mengakses proyek MaxCompute. Anda dapat memperoleh ID AccessKey Anda dari halaman AccessKey Management.

        • accessKey: Wajib diisi. Secret AccessKey yang sesuai dengan ID AccessKey tersebut.

        • interactiveMode: Opsional. Menentukan apakah fitur Query Acceleration diaktifkan.

          Untuk mengaktifkan Query Acceleration, tambahkan &interactiveMode=true ke URL. Untuk informasi lebih lanjut, lihat Query Acceleration.

    5. Klik Test Connection. Koneksi berhasil ditandai dengan status Connected pada kotak dialog Connection Test. Klik OK untuk menutup dialog ini, lalu klik Finish untuk menyelesaikan pengaturan.

    Langkah 2: Kueri dan analisis data

    Setelah Anda menghubungkan DBeaver ke MaxCompute, koneksi baru akan muncul di panel navigasi sebelah kiri. Anda dapat menggunakan SQL untuk mengelola proyek MaxCompute Anda. Bagian berikut menjelaskan operasi umum. Untuk daftar lengkap fitur, lihat dokumentasi DBeaver.

    • Lihat semua tabel

      Anda dapat melihat informasi semua tabel di bawah koneksi MaxCompute yang telah dibuat.

      Pada panel Database Navigator di sebelah kiri, perluas node koneksi MaxCompute, perluas nama database, perluas default, lalu perluas Tables untuk menampilkan daftar tabel. Anda juga dapat memasukkan kata kunci di kotak pencarian di bagian atas untuk memfilter tabel berdasarkan nama.

    • Lihat skema tabel

      Di bawah koneksi MaxCompute, klik kanan tabel dan pilih View Table.

      Sebagai contoh, tabel sale_detail memiliki lima kolom berikut: shop_name (STRING), customer_id (STRING), total_price (DOUBLE), sale_date (STRING), dan region (STRING).

    • Lihat data tabel

      • Di bawah koneksi MaxCompute, klik SQL Editor > New SQL Editor. Di editor, masukkan dan jalankan kueri SQL untuk tabel target guna melihat datanya.

        Sebagai contoh, masukkan kueri SELECT * FROM pyodps_ml_100k_lens;.

      • Jika switch sintaks skema tidak diaktifkan untuk proyek Anda, Anda juga dapat melihat data dengan mengklik kanan tabel target di bawah koneksi MaxCompute, memilih View Table, lalu mengklik tab Data. Untuk informasi lebih lanjut, lihat Schema Syntax Switch.