All Products
Search

This Product

    MaxCompute:Hubungkan DataGrip ke MaxCompute

    Document Center

    MaxCompute:Hubungkan DataGrip ke MaxCompute

    Last Updated:Jun 21, 2026

    Topik ini menjelaskan cara menghubungkan DataGrip ke proyek MaxCompute menggunakan driver JDBC MaxCompute.

    Latar Belakang

    DataGrip, lingkungan manajemen database untuk pengembang, menyederhanakan kueri, pembuatan, dan pengelolaan database. DataGrip mendukung database lokal, berbasis server, maupun cloud. Untuk informasi lebih lanjut, lihat DataGrip.

    Prasyarat

    Pastikan Anda memenuhi persyaratan berikut:

    • Anda telah membuat proyek MaxCompute.

      Untuk informasi lebih lanjut, lihat Buat proyek MaxCompute.

    • Anda memiliki ID AccessKey dan AccessKey Secret dengan izin untuk mengakses proyek MaxCompute.

      Buka halaman AccessKey Management untuk mendapatkan ID AccessKey dan AccessKey Secret.

    • Anda telah mengunduh paket JAR driver JDBC MaxCompute beserta semua dependensinya (jar-with-dependencies).

      Unduh driver dengan mengklik odps-jdbc-3.9.0.jar, atau dapatkan versi terbaru dari GitHub atau Repositori Maven. Topik ini menggunakan driver JDBC MaxCompute v3.9.0 sebagai contoh.

    • Anda telah mengunduh dan menginstal DataGrip.

      Untuk informasi lebih lanjut, lihat Instal DataGrip.

      Topik ini menggunakan DataGrip 2024.3.3 sebagai contoh.

    Prosedur

    Untuk menghubungkan DataGrip ke MaxCompute, ikuti langkah-langkah berikut:

    1. Langkah 1: Tambahkan driver dan konfigurasikan sumber data

      Tambahkan driver JDBC MaxCompute ke DataGrip dan konfigurasikan parameter koneksi untuk proyek MaxCompute Anda.

    2. Langkah 2: Gunakan DataGrip untuk mengelola proyek MaxCompute

      Gunakan koneksi yang telah dibuat di DataGrip untuk mengelola proyek MaxCompute Anda.

    Langkah 1: Konfigurasikan driver dan sumber data

    1. Jalankan DataGrip.

    2. Dari main menuimage, pilih File > Create > Project.

    3. Pada kotak dialog New Project, masukkan nama proyek, misalnya MaxCompute_test.

    4. Pada jendela proyek baru, klik Createimage > Driver di pojok kiri atas.

    5. Pada kotak dialog Data Sources and Drivers, buka tab Drivers. Klik ikon image dan pilih User Driver. Beri nama driver tersebut, misalnya MaxCompute.

    6. Pada bagian Driver Files, klik ikon image dan pilih Custom JARs. Dari mesin lokal Anda, pilih file JAR driver JDBC MaxCompute yang telah diunduh, misalnya odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar.

      Parameter

      Description

      Name

      Nama untuk driver baru, misalnya MaxCompute.

      Class

      Setelah mengunggah file JAR driver JDBC MaxCompute, pilih com.aliyun.odps.jdbc.OdpsDriver dari daftar drop-down.

    7. Buka tab Data Source. Klik ikon image dan pilih driver yang telah Anda buat, misalnya MaxCompute.

    8. Pada tab General, konfigurasikan parameter berikut.

      Parameter

      Description

      Name

      Secara default menggunakan nama driver. Anda dapat menentukan nama kustom.

      Authentication

      Pilih User & Password.

      User

      ID AccessKey dengan izin untuk mengakses proyek MaxCompute.

      Anda dapat membuka halaman AccessKey Management untuk mendapatkan ID AccessKey.

      Password

      AccessKey Secret yang sesuai dengan ID AccessKey tersebut.

      URL

      URL koneksi untuk proyek MaxCompute. Formatnya adalah jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]. Jangan sertakan tanda kurung sudut (<>) dalam URL. Tabel berikut menjelaskan parameter-parameter tersebut.

      • <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 tujuan.

        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 pada 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.

      • useProjectTimeZone: Opsional. Parameter ini menyinkronkan zona waktu antara DataGrip dan instans server MaxCompute. Untuk menggunakan zona waktu yang sama, tambahkan &useProjectTimeZone=true ke URL.

    9. Klik Test Connection untuk memverifikasi konfigurasi.

    10. Klik OK untuk menyimpan konfigurasi.

    Langkah 2: Kelola proyek

    Setelah koneksi dibuat, koneksi MaxCompute baru akan muncul di panel kiri. Anda dapat menulis dan menjalankan skrip SQL untuk mengelola proyek MaxCompute Anda. Untuk informasi lebih lanjut, lihat DataGrip Help.

    • Lihat semua tabel

      Anda dapat melihat informasi semua tabel di bawah koneksi MaxCompute Anda.

      Pada panel Database Explorer di sebelah kiri, buka koneksi MaxCompute > nama proyek > default > tables untuk melihat semua tabel dalam skema tersebut.

    • Lihat skema tabel

      Klik kanan tabel tujuan, pilih Create > Query Console, lalu tulis dan jalankan skrip SQL di editor SQL di sebelah kanan untuk melihat skema tabel.

      Sebagai contoh, jalankan perintah DESC sale_detail. Output-nya mencantumkan Native Columns, yang mencakup shop_name(STRING), customer_id(STRING), dan total_price(DOUBLE), serta Partition Columns, yang mencakup sale_date(STRING) dan region(STRING).

    • Lihat data tabel

      Klik kanan tabel tujuan, pilih Create > Query Console, lalu tulis dan jalankan skrip SQL di editor SQL di sebelah kanan untuk melihat data tabel.

      Sebagai contoh, untuk mengkueri tabel pyodps_iris, jalankan perintah SELECT * FROM pyodps_iris;. Klik ikon segitiga hijau Run di bilah alat untuk melihat data tabel di panel Result di bagian bawah.