MaxCompute:Eksplorasi data AI

Unduh dan instal

Ikhtisar Konsol

Klien menggunakan tata letak tiga kolom:

• Bilah Samping Kiri: Area Manajemen Resource, yang berisi panel seperti Manajemen File, Penjelajahan Katalog, Koneksi Data, Impor Data, Pencarian Basis Pengetahuan SQL, Riwayat Kueri, dan Riwayat Versi File. Gunakan ikon di sebelah kiri untuk beralih antar panel tersebut.

• Area Tengah: Area Pengeditan SQL dan Tampilan Data, yang mendukung beberapa tab.

• Bilah Samping Kanan: Panel Asisten AI, yang dapat Anda perluas atau ciutkan.

Klien mendukung tema gelap dan terang, yang dapat dikonfigurasi di Settings.

Konfigurasi koneksi data

1. Di bilah samping kiri, klik ikon koneksi untuk membuka panel koneksi data.

2. Klik Add Connection.

3. Masukkan informasi koneksi:

   • Nama Koneksi: Masukkan nama deskriptif untuk koneksi tersebut.

   • Region: Pilih wilayah tempat proyek MaxCompute Anda berada dari daftar drop-down, atau pilih "Custom Endpoint" untuk memasukkannya secara manual.

   • Nama Proyek: Masukkan nama proyek MaxCompute Anda.

   • ID AccessKey dan Secret AccessKey: Masukkan ID AccessKey dan Secret AccessKey untuk akses proyek.

4. Klik Test Connection untuk memverifikasi konfigurasi.

5. Setelah pengujian berhasil, klik Save.

Setelah terhubung, panel Katalog di bilah samping kiri secara otomatis memuat struktur tabel proyek.

Jalankan kueri

1. Tekan Option+N atau klik New di panel file untuk membuat file SQL baru.

2. Di editor, masukkan kueri, misalnya:

   SELECT * FROM your_table_name LIMIT 10;

3. Tekan Cmd+Enter (di macOS) untuk menjalankan kueri.

4. Hasil kueri muncul di Panel Hasil di bawah editor. Untuk menganalisis hasil, Anda dapat beralih antara Tampilan Tabel, Tampilan Grafik, dan Tampilan Tabel Pivot.

Konfigurasi layanan AI

1. Klik ikon roda gigi di pojok kanan atas untuk membuka Settings.

2. Buka tab AI Configuration.

3. Masukkan informasi berikut:

   • URL API: Titik akhir untuk layanan AI. Nilai default adalah titik akhir Alibaba Cloud Model Studio: https://dashscope.aliyuncs.com/compatible-mode/v1/.

   • Kunci API: Buka Konsol Alibaba Cloud Model Studio. Di pojok kanan atas halaman, pilih wilayah China (Beijing). Arahkan ke halaman API Key dan klik Create API Key atau salin yang sudah ada.

   • Nama Model: Nilai default adalah qwen3-max-2026-01-23. Anda juga dapat memasukkan model lain yang kompatibel dengan API OpenAI.

4. Klik Save.

Setelah disimpan, panel Asisten AI di sebelah kanan siap digunakan. Anda dapat mengeksplorasi data dengan mengajukan pertanyaan dalam bahasa alami.

Eksplorasi data AI

Setelah konfigurasi selesai, coba hal berikut di panel Asisten AI:

1. Masukkan "List the tables in the current project." Asisten AI kemudian akan menampilkan daftar tabel.

2. Pilih sebuah tabel dan masukkan "Show the structure and first 10 rows of this table."

3. Setelah meninjau hasilnya, ajukan pertanyaan analitis, seperti "Analyze the data volume distribution across partitions in this table."

Asisten AI menyusun langkah-langkahnya, menghasilkan SQL, menjalankan kueri, dan memberikan analisis. Anda dapat mengamati seluruh proses ini di antarmuka.

Buat koneksi baru

1. Di bilah samping kiri, klik ikon Connections untuk membuka panel koneksi data.

2. Klik Add Connection.

3. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   Nama Koneksi	Nama kustom untuk mengidentifikasi koneksi.
   Region	Pilih wilayah tempat proyek MaxCompute Anda berada. Klien secara otomatis mengisi titik akhir yang sesuai.
   Nama Proyek	Nama proyek MaxCompute Anda.
   ID AccessKey	ID AccessKey untuk Akun Alibaba Cloud Anda.
   AccessKey Secret	Secret AccessKey untuk Akun Alibaba Cloud Anda.

4. Klik Test Connection untuk memverifikasi koneksi.

5. Klik Save untuk membuat koneksi.

Uji dan atasi masalah koneksi

Saat Anda mengklik Test Connection, klien terhubung ke layanan MaxCompute dan mengambil informasi proyek. Jika pengujian gagal, periksa hal berikut:

• Pastikan titik akhir sesuai dengan wilayah proyek Anda.

• Verifikasi bahwa AccessKey Anda benar dan belum kedaluwarsa.

• Konfirmasi bahwa lingkungan jaringan Anda dapat mengakses layanan MaxCompute di wilayah yang ditentukan.

• Periksa bahwa Akun Alibaba Cloud yang terkait dengan AccessKey Anda memiliki izin untuk mengakses proyek tersebut.

Kelola beberapa koneksi

Panel koneksi data mencantumkan semua koneksi yang telah Anda simpan. Dari sini, Anda dapat:

• Beralih koneksi:

  Klik koneksi untuk menjadikannya aktif. Operasi seperti eksekusi SQL, penjelajahan Katalog, dan impor data menggunakan koneksi aktif.

• Hapus koneksi:

  Klik ikon hapus pada koneksi untuk menghapusnya. Untuk mengubah koneksi, hapus yang lama dan buat yang baru.

Simpan beberapa koneksi untuk wilayah atau proyek berbeda agar dapat beralih dengan cepat antara lingkungan produksi, pengujian, dan lainnya.

Editor SQL

Klien menyertakan editor SQL berbasis Monaco bawaan untuk pengalaman seperti IDE.

• Penyorotan sintaks dan pelengkapan cerdas

  Editor menyoroti sintaks untuk SQL MaxCompute dan menyediakan pelengkapan cerdas berbasis konteks saat Anda mengetik. Saran mencakup kata kunci SQL, fungsi bawaan MaxCompute, serta nama tabel dan kolom dari koneksi saat ini. Daftar pelengkapan secara otomatis difilter berdasarkan posisi kursor. Mengetik nama tabel diikuti dengan. secara otomatis menyarankan nama kolom untuk tabel tersebut.

• Pengeditan kode

  Editor mencakup pelipatan kode, pewarnaan pasangan tanda kurung, pembungkus kata, dan minimap kode. Tekan Shift+Option+F untuk memformat skrip SQL saat ini secara otomatis.

Manajemen skrip SQL

Panel File di bilah samping kiri menampilkan file SQL di sistem file lokal Anda.

• File baru

  Tekan Option+N (macOS) untuk membuat file SQL baru.

• Buka file

  Di Panel File, klik file SQL yang sudah ada untuk membukanya di editor.

• Simpan file

  Tekan Option+S (macOS) untuk menyimpan perubahan Anda saat ini.

• Operasi multi-tab

  Anda dapat membuka beberapa file SQL sekaligus dan beralih di antaranya menggunakan tab.

Manajemen versi file SQL

Klien menyimpan riwayat versi untuk setiap file SQL. Klik ikon Version History di bilah samping kiri untuk melihat daftar versi historis untuk file saat ini.

Setiap catatan versi mencakup nomor versi, waktu simpan, dan jenis versi. Jenis versi terdiri dari penyimpanan manual (dibuat saat Anda secara eksplisit menyimpan file) dan snapshot pra-eksekusi (dibuat secara otomatis sebelum kueri SQL dijalankan).

Operasi yang tersedia pada versi:

• Bandingkan perbedaan: Klik ganda versi untuk membuka tampilan diff yang menunjukkan perubahan antara versi tersebut dan konten saat ini.

• Pulihkan versi: Pulihkan konten file ke versi tertentu.

• Hapus versi: Hapus versi historis yang tidak lagi diperlukan.

Eksekusi SQL

Ada tiga cara untuk mengeksekusi SQL:

• Eksekusi Semua: Tekan Cmd+Enter untuk mengeksekusi semua pernyataan SQL di editor.

• Eksekusi Terpilih: Pilih bagian teks SQL dan tekan Shift+Enter untuk hanya mengeksekusi bagian yang dipilih.

• Eksekusi Satu Pernyataan: Editor menampilkan tombol Run di antara setiap pernyataan SQL. Klik untuk mengeksekusi pernyataan tersebut.

Jika file SQL berisi pernyataan SET, sepertiSET odps.sql.type.system.odps2=true;, klien secara otomatis menggabungkan konfigurasi ini dengan pernyataan SQL berikutnya dan mengeksekusinya bersama-sama.

Selama eksekusi, editor menampilkan bilah kemajuan dan status eksekusi di bawahnya. Setelah selesai, hasil kueri muncul dalam bentuk tabel, sedangkan status eksekusi muncul untuk pernyataan DDL/DML.

Analisis hasil kueri

Setelah kueri mengembalikan hasil, tampilan berikut tersedia untuk analisis.

Riwayat kueri

Klik ikon History di bilah samping kiri untuk menelusuri riwayat kueri Anda. Setiap catatan menunjukkan waktu eksekusi, durasi (dalam milidetik), pratinjau SQL, status (sukses atau gagal), dan jumlah baris. Klik catatan untuk memuat kembali pernyataan SQL tersebut ke editor.

Riwayat kueri mendukung paginasi untuk menelusuri kueri sebelumnya.

Menjelajahi Katalog

Di bilah samping kiri, klik ikon Katalog untuk melihat semua tabel di proyek saat ini, ditampilkan sebagai struktur pohon. Perluas tabel apa pun untuk melihat definisi kolomnya, termasuk nama kolom, tipe data, dan komentar.

Klik kanan nama tabel untuk melakukan tindakan berikut:

• Pratinjau Data: Lihat beberapa baris data pertama di tabel.

• Lihat skema tabel: Menampilkan informasi kolom lengkap, kunci partisi, dan properti tabel.

• Lihat informasi tabel: Menampilkan metadata seperti ukuran tabel, jumlah catatan, waktu modifikasi terakhir, dan izin.

Dengan beberapa koneksi yang disimpan, Katalog menampilkan skema tabel untuk semua proyek yang terhubung.

Pratinjau data

Pilih tabel di Katalog untuk mempratinjau datanya. Klien menjalankan kueri LIMIT dan menampilkan hasilnya di panel tengah.

Manajemen partisi

Anda dapat melihat daftar partisi yang ada di Katalog dan menambahkan partisi baru ke tabel partisi.

Impor data

Klien mendukung impor file lokal ke tabel MaxCompute. Untuk membuka panel impor, klik ikon Data Import di bilah samping kiri.

Ekspor data

Anda dapat mengekspor hasil kueri dalam format berikut:

• CSV: File teks yang dipisahkan koma, kompatibel dengan tools seperti Excel.

• JSON: Data dalam format JSON.

• Parquet: Format penyimpanan kolom yang cocok untuk pemrosesan lebih lanjut dalam skenario data besar.

Di panel hasil kueri, klik tombol Export dan pilih format.

Mode chat dan mode agent

Asisten AI menyediakan dua mode kerja:

Mode chat ideal untuk tanya jawab cepat dan operasi ringan, seperti menjelaskan pernyataan SQL, mengoptimalkan kode SQL, atau memberikan wawasan berdasarkan hasil kueri. AI menjawab secara langsung tanpa proses multi-langkah.

Mode agent menangani tugas analisis data multi-langkah. AI membuat rencana eksekusi, dan setelah Anda menyetujuinya, mengeksekusi setiap langkah secara berurutan. Langkah-langkah tersebut dapat mencakup pengambilan metadata, pembuatan SQL, menjalankan kueri, dan menganalisis hasil.

Mode chat

Masukkan pertanyaan di kotak input panel AI untuk menggunakan mode chat. Kasus penggunaan umum meliputi:

• Pembuatan SQL: Jelaskan kebutuhan kueri Anda, dan AI akan menghasilkan SQL MaxCompute yang sesuai.

• Optimasi SQL: Buka skrip SQL di editor dan minta AI memberikan saran optimasi. Anda kemudian dapat menyisipkan SQL yang dioptimalkan ke editor dengan satu klik.

• Penjelasan SQL: Pilih pernyataan SQL kompleks dan minta AI menjelaskan logikanya bagian demi bagian.

• Wawasan hasil: Setelah menjalankan kueri, minta AI memberikan wawasan tentang hasilnya, seperti analisis tren atau deteksi anomali.

Mode agent

Saat Anda mengajukan pertanyaan analitis yang melibatkan beberapa langkah, AI secara otomatis memasuki mode agent.

Ruang kerja AI

Ruang Kerja AI adalah direktori lokal persisten yang menyimpan output dari mode agent. Hasil antara dan akhir dari setiap tugas analisis disimpan secara otomatis.

Kasus penggunaan

Basis pengetahuan cuplikan SQL

sql snippet knowledge base menyimpan templat SQL yang dapat digunakan kembali untuk pengambilan data periodik. Memelihara SQL bisnis standar di knowledge base memungkinkan Anda menggunakan penulisan ulang tanggal oleh AI untuk dengan cepat mengambil data laporan untuk periode waktu berbeda. Saat Anda mengimpor file SQL yang sering digunakan ke knowledge base, sistem secara otomatis mengekstrak sql snippets individual. Untuk setiap cuplikan, sistem kemudian mengekstrak nama tabel, kata kunci, bidang partisi, dan literal tanggal untuk membangun indeks teks penuh.

Klik ikon pencarian di bilah samping kiri untuk mencari knowledge base guna menemukan sql snippets berdasarkan kata kunci. Setelah menemukan cuplikan, Anda dapat menyisipkannya ke editor untuk dieksekusi. Atau, Anda dapat menggunakan fitur "Execute SQL Snippet" dari asisten AI untuk secara otomatis mencocokkan cuplikan, menulis ulang tanggalnya, dan mengeksekusinya.

Lapisan semantik

semantic layer membedakan client MaxCompute dari tools AI umum dengan memetakan tabel dan kolom database ke istilah, metrik, dan hubungan yang ramah bisnis. Saat menghasilkan SQL, AI berkonsultasi dengan semantic layer untuk menghasilkan kueri yang lebih akurat.

semantic layer terdiri dari komponen berikut:

• Istilah bisnis: Mendefinisikan istilah khusus dalam domain bisnis Anda, seperti 'DAU' untuk 'Daily Active Users'.

• Definisi entitas: Menggambarkan objek bisnis inti dan tabel serta bidang kunci yang sesuai.

• Definisi metrik: Mendefinisikan rumus perhitungan dan cakupan untuk metrik bisnis, seperti Conversion Rate = Number of users who placed an order / Number of visiting users.

• Hubungan tabel: Menggambarkan hubungan JOIN dan kunci gabungan antar tabel.

• Kueri tervalidasi: Templat kueri standar yang telah divalidasi yang dapat digunakan kembali oleh AI untuk pertanyaan serupa.

• Playbook analisis: Templat yang telah ditentukan untuk skenario dan langkah analisis yang memandu AI menyelesaikan analisis mengikuti alur kerja standar.

Paket semantik bawaan

client menyertakan built-in semantic package untuk Information Schema yang mencakup skenario analisis meta-warehouse tingkat tenant MaxCompute umum: diagnosis tekanan penyimpanan, diagnosis tekanan biaya, analisis kinerja pekerjaan, analisis lonjakan kegagalan tugas, audit peran pengguna, audit eksposur izin, pengamatan tabel populer, dan pemantauan kuota sumber daya.

Setelah Anda mengaktifkan semantic package ini, Anda dapat langsung mengajukan pertanyaan analisis meta-warehouse kepada AI, seperti "Analyze the top 10 tables by storage in the current project." AI kemudian menggunakan definisi metrik dan kueri referensi dari semantic package untuk menghasilkan SQL analisis yang akurat.

Paket semantik kustom

Buat custom semantic package untuk skenario bisnis Anda. Di panel Manajemen Lapisan Semantik, pilih domain target dan edit business terms, entity definitions, metric definitions, table relationships, validated queries, dan analysis playbooks. Anda juga dapat menggunakan bantuan AI untuk menghasilkan draf semantic package dari struktur tabel koneksi saat ini, lalu menyempurnakannya secara manual.

Penjelajah file blob

MaxCompute menyimpan data file biner di kolom bertipe blob. Klien menyediakan penjelajah file blob yang berfungsi seperti manajer file untuk menelusuri tabel blob. Untuk menggunakan fitur ini, aktifkan sakelar Beta penjelajah file.

Penjelajah file blob mendukung peralihan antara tampilan kisi dan tampilan daftar, navigasi breadcrumb, pembuatan folder, serta unggah/unduh file.

Impor file blob

Di panel Data Import, beralih ke mode impor blob untuk mengunggah file secara massal ke tabel blob MaxCompute dengan seret-dan-lepas. Klien mengekstrak metadata (jalur file, nama, dan tipe) dan menuliskannya ke kolom tabel yang sesuai.

Jika tabel target belum ada, klien membantu menghasilkan pernyataan pembuatan tabel yang mencakup kolom bertipe blob.

Pratinjau file multimodal

Klien menyediakan pratinjau file multimodal bawaan untuk format berikut:

Klien secara otomatis mencocokkan metode pratinjau berdasarkan tipe MIME file, tetapi Anda juga dapat menggantinya secara manual.

Pemasangan WebDAV

Klien menyertakan layanan WebDAV bawaan untuk memasang tabel blob MaxCompute sebagai folder lokal. Setelah dipasang, pratinjau dan unduh file langsung di Finder tanpa menggunakan antarmuka klien.

Cara memasang di macOS:

Di Finder, tekan Cmd+K dan masukkan http://localhost:8899/dav/ untuk menelusuri file di tabel blob sebagai folder jaringan.

Sub-agen OpenClaw

Klien MaxCompute terintegrasi sebagai sub-agen OpenClaw, menangani tugas analisis data yang didelegasikan oleh OpenClaw.

OpenClaw mengontrol dan mengoordinasikan tugas, sedangkan klien MaxCompute menangani analisis data. Keuntungannya meliputi:

• Isolasi keamanan: Kredensial koneksi MaxCompute dikelola secara lokal di klien. Anda tidak perlu mengonfigurasi AccessKey di OpenClaw.

• Jejak audit lengkap: OpenClaw mempertahankan pengalaman percakapan yang sederhana, sedangkan klien menyimpan proses eksekusi terperinci, termasuk rencana, SQL, hasil antara, dan informasi diagnostik, untuk pelacakan dan tinjauan.

• Analisis diperluas: Anda dapat menganalisis dan mengekspor hasil lebih lanjut dari OpenClaw dalam mode Studio klien.

# Install the MaxCompute plugin
openclaw plugins install @maxcompute/openclaw-maxquery --pin

# Enable the plugin and configure the connection address
openclaw plugins enable maxquery
openclaw config set plugins.entries.maxquery.enabled true
openclaw config set plugins.entries.maxquery.config.baseUrl http://127.0.0.1:8899

Pengaturan editor

Pengaturan AI

Pengaturan AI lanjutan

Pengaturan tema

Beralih antara tema Gelap dan Terang.

Pembaruan versi

Aplikasi secara otomatis memeriksa pembaruan dan meminta Anda menginstal versi baru saat tersedia.

Error verifikasi instalasi macOS

Fitur keamanan Gatekeeper macOS menyebabkan error ini. Untuk mengatasinya, buka Terminal, jalankan perintah berikut, lalu mulai ulang aplikasi:

sudo xattr -rd com.apple.quarantine "/Applications/MaxCompute.app"

Masalah koneksi

• Pengujian koneksi gagal

  Periksa item berikut secara berurutan:

  1. Pastikan endpoint sesuai dengan region project MaxCompute Anda. Anda dapat memverifikasi region yang benar di halaman detail project di console MaxCompute.

  2. Verifikasi bahwa AccessKey ID dan AccessKey Secret benar dan belum dinonaktifkan atau kedaluwarsa.

  3. Konfirmasi bahwa jaringan Anda dapat mengakses public endpoint MaxCompute untuk region yang ditentukan. Jika Anda berada di belakang VPN atau proxy, pastikan kebijakan jaringan Anda mengizinkan koneksi outbound.

  4. Pastikan akun yang terkait dengan AccessKey ID memiliki otorisasi untuk mengakses project target.

• Koneksi timeout

  Masalah jaringan biasanya menyebabkan timeout ini. Latensi tinggi, terutama saat menghubungkan ke region lintas batas, seperti mengakses region luar negeri dari Tiongkok daratan, dapat menyebabkan timeout. Periksa konektivitas jaringan Anda atau hubungi administrator jaringan Anda.

Masalah eksekusi SQL

• Eksekusi SQL mengembalikan error sintaks

  SQL MaxCompute berbeda dari SQL standar. Klien secara otomatis menulis ulang beberapa sintaks sebelum eksekusi (misalnya, mengonversi NOW() menjadi GETDATE()), tetapi tidak semua kasus tercakup. Rujuk dokumentasi resmi SQL MaxCompute untuk sintaks yang benar.

• Kueri mengembalikan volume data besar

  Klien membatasi jumlah baris yang dikembalikan secara default untuk memastikan responsivitas. Untuk mengambil lebih banyak data, tambahkan klausa LIMIT ke pernyataan SQL Anda atau gunakan fitur ekspor data untuk set hasil lengkap.

Masalah konfigurasi AI

• Asisten AI tidak berfungsi

  Pastikan URL API, API key, dan Nama Model dikonfigurasi dengan benar di pengaturan. Konfigurasi default menggunakan Model Studio (DashScope); untuk menggunakannya, pertama-tama buat API key di konsol Model Studio.

• Respons AI lambat

  Beban layanan model dan kondisi jaringan memengaruhi kecepatan respons. Untuk respons lebih cepat, ubah inference service tier menjadi fast di pengaturan AI lanjutan atau pilih model yang lebih responsif.

Masalah impor dan ekspor

• Tipe kolom salah setelah mengimpor file Excel

  Klien secara otomatis menginferensi tipe kolom saat mengurai file Excel. Jika tipe yang diinferensi salah, ubah secara manual definisi tipe kolom di DDL dalam mode Create New Table, atau gunakan fitur AI Generate DDL untuk inferensi tipe yang lebih akurat.

• Tidak dapat membuka file Parquet yang diekspor

  File Parquet yang diekspor mengikuti format Apache Parquet dan dapat dibaca oleh tools yang mendukung Parquet, seperti Python (pandas/pyarrow) dan Spark.