All Products
Search

This Product

    MaxCompute:Hubungkan SQL Workbench/J ke MaxCompute

    Document Center

    MaxCompute:Hubungkan SQL Workbench/J ke MaxCompute

    Last Updated:Jun 22, 2026

    MaxCompute memungkinkan Anda menggunakan alat manajemen database SQL Workbench/J untuk mengakses proyek MaxCompute dan melakukan operasi manajemen data. Topik ini menjelaskan cara menghubungkan SQL Workbench/J ke proyek MaxCompute menggunakan driver JDBC MaxCompute serta mengelola data.

    Informasi latar belakang

    SQL Workbench/J adalah alat kueri SQL gratis yang lintas platform dan beroperasi secara independen dari sistem manajemen basis data (DBMS) mana pun. Ditulis dalam Java, SQL Workbench/J dapat dijalankan di sistem operasi apa pun yang menyediakan lingkungan runtime Java.

    Prasyarat

    Sebelum melanjutkan, pastikan Anda telah memenuhi persyaratan berikut:

    • Anda telah membuat proyek MaxCompute.

      Untuk informasi lebih lanjut tentang pembuatan proyek MaxCompute, lihat Create a MaxCompute project.

    • Anda telah memperoleh ID AccessKey dan Rahasia AccessKey dengan izin akses ke proyek MaxCompute.

      Anda dapat memperoleh ID AccessKey dan Rahasia AccessKey Anda dari halaman AccessKey Management.

    • Anda telah mengunduh driver JDBC MaxCompute (versi 3.0.1 atau yang lebih baru) yang mencakup paket JAR dependensi lengkap jar-with-dependencies.

      Contoh dalam topik ini menggunakan driver JDBC MaxCompute versi 3.2.9.

    • Anda telah mengunduh dan menginstal SQL Workbench/J.

      Contoh dalam topik ini menggunakan SQL Workbench/J Build 127, yang dirilis pada 22 Agustus 2020.

    • Anda telah menginstal Java 8 atau versi yang lebih baru.

    Prosedur

    Ikuti langkah-langkah berikut untuk menghubungkan SQL Workbench/J ke MaxCompute:

    1. Langkah 1: Buat driver

      Unggah file JAR driver JDBC MaxCompute ke SQL Workbench/J agar SQL Workbench/J dapat mengakses proyek MaxCompute Anda melalui driver ini.

    2. Langkah 2: Hubungkan SQL Workbench/J ke MaxCompute

      Konfigurasikan parameter koneksi untuk menghubungkan SQL Workbench/J dengan proyek MaxCompute Anda.

    3. Langkah 3: Kelola proyek MaxCompute Anda menggunakan SQL Workbench/J

      Gunakan koneksi data yang telah dibuat di SQL Workbench/J untuk mengelola proyek MaxCompute Anda.

    Langkah 1: Buat driver

    1. Jalankan SQL Workbench dan buka antarmuka SQL Workbench.

      Saat antarmuka SQL Workbench terbuka, kotak dialog Select Connection Profile muncul secara otomatis.

    2. Di pojok kiri bawah kotak dialog Select Connection Profile, klik Manage Drivers. Buat driver baru, masukkan nama driver kustom, unggah file JAR driver JDBC MaxCompute, lalu klik OK untuk menyelesaikan konfigurasi driver.

      Setelah mengunggah driver JDBC MaxCompute, bidang Classname secara otomatis diisi dengan com.aliyun.odps.jdbc.OdpsDriver.

    Langkah 2: Hubungkan SQL Workbench/J ke MaxCompute

    1. Di panel konfigurasi Profile di sisi kanan kotak dialog Select Connection Profile, masukkan nama koneksi (misalnya, MCtoSQL) dan konfigurasikan parameter yang tercantum dalam tabel berikut.

      Parameter

      Deskripsi

      Driver

      Driver yang digunakan untuk menghubungkan ke proyek MaxCompute Anda—yaitu driver MaxCompute (com.aliyun.odps.jdbc.OdpsDriver) yang telah Anda buat di Langkah 1.

      URL

      URL untuk menghubungkan ke proyek MaxCompute Anda. Gunakan format jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]. Hapus simbol <> saat mengonfigurasi. Parameter tersebut dijelaskan sebagai berikut:

      • <MaxCompute_endpoint>: Wajib diisi. Titik akhir wilayah tempat proyek MaxCompute Anda berada.

        Untuk daftar titik akhir, lihat Endpoints.

      • <MaxCompute_project_name>: Wajib diisi. Nama proyek MaxCompute yang dituju.

        Nama ini adalah nama proyek MaxCompute Anda, bukan ruang kerja. Anda dapat masuk ke Konsol MaxCompute, ganti wilayah di pojok kiri atas, lalu temukan nama proyek di halaman Projects.

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

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

      Username

      ID AccessKey yang memiliki hak istimewa akses ke proyek MaxCompute yang dituju.

      Anda dapat memperoleh ID AccessKey Anda dari halaman AccessKey Management.

      Password

      Rahasia AccessKey yang sesuai dengan ID AccessKey tersebut.

      Anda dapat memperoleh Rahasia AccessKey Anda dari halaman AccessKey Management.

    2. Klik Test. Setelah koneksi berhasil, klik OK untuk membuat koneksi data antara SQL Workbench/J dan MaxCompute.

    Langkah 3: Kelola proyek MaxCompute Anda menggunakan SQL Workbench/J

    Di antarmuka SQL Workbench/J, gunakan koneksi data yang baru dibuat untuk mengelola proyek MaxCompute Anda dengan menjalankan perintah MaxCompute SQL.

    • Lihat semua tabel

      Setelah koneksi data dibuat, SQL Workbench/J secara otomatis beralih ke antarmuka eksekusi SQL. Jalankan perintah show tables; untuk menampilkan semua tabel.

      Masukkan pernyataan SQL Anda di area Statement dan klik tombol Run (▶) pada bilah alat untuk mengeksekusinya. Hasil akan muncul di tab Result di bawahnya.

    • Lihat skema tabel

      Setelah koneksi data dibuat, SQL Workbench/J secara otomatis beralih ke antarmuka eksekusi SQL. Jalankan perintah desc <table_name>; untuk melihat skema tabel.

    • Lihat data tabel

      Setelah koneksi data dibuat, SQL Workbench/J secara otomatis beralih ke antarmuka eksekusi SQL. Jalankan kueri SELECT untuk melihat data tabel.

      Masukkan pernyataan SQL di area Statement—misalnya, select * from bank_data_pt where age=35;—lalu klik tombol Execute pada bilah alat. Hasil kueri akan muncul dalam bentuk tabel di tab Result di bawahnya.