All Products
Search

This Product

    Hologres:Dapatkan insight kueri

    Document Center

    Hologres:Dapatkan insight kueri

    Last Updated:Sep 19, 2026

    Query Insight menggabungkan log kueri lambat dengan tabel sistem hg_table_info untuk memberikan gambaran lengkap mengenai perilaku suatu kueri—mulai dari konsumsi resource, metadata tabel, rencana eksekusi, hingga aktivitas kunci. Gunakan fitur ini untuk mendiagnosis kueri lambat, menyelidiki kegagalan, serta menentukan apakah konflik DDL atau kunci tabel menyebabkan kueri gagal.

    Prasyarat

    Sebelum memulai, pastikan Anda telah:

    Ambang batas pengumpulan data

    Query Insight mengambil data dari dua sumber, masing-masing dengan aturan pengumpulan sendiri. Tinjau ambang batas berikut sebelum melakukan kueri agar Anda mengetahui kapan data akan tersedia.

    Data

    Aturan pengumpulan

    Catatan

    Pernyataan DML

    Waktu eksekusi > 100 ms

    Ambang batas default log kueri lambat

    Pernyataan DDL

    Semua pernyataan DDL dikumpulkan

    Hanya pernyataan dengan waktu eksekusi > 1 dtk yang muncul dalam hasil pencarian

    Rencana eksekusi

    Waktu eksekusi > 10 dtk

    Rencana diambil dari bidang Plan dalam log kueri lambat

    Metadata tabel

    Dikumpulkan sekali setiap pagi

    Data tersedia pada T+1 (hari berikutnya); tabel yang dibuat hari ini dapat dikueri besok

    Analisis Konflik DDL

    Memeriksa jendela 1 menit sebelum dan sesudah eksekusi kueri

    —

    Akses Query Insight

    Akses Query Insight Secara Langsung

    Query Insight tersedia dari tiga lokasi di HoloWeb. Di halaman Query Insight, Anda dapat melihat Query Metadata dan Table Metadata, serta melakukan Plan Visualization dan Table Lock Analysis.

    Akses langsung dari Diagnostics and Optimization:

    1. Masuk ke Hologres Management Console.

    2. Di panel navigasi kiri bilah menu atas, pilih wilayah target.

    3. Klik Go to HoloWeb.

    4. Di menu atas, pilih Diagnostics and Optimization. Lalu, di panel navigasi kiri, klik Metadata Warehouse Analysis > Query Insight.

    image

    Navigasi ke Query Insight

    Navigasi dari SQL Editor:

    Di HoloWeb SQL Editor, setiap pernyataan SQL dengan waktu eksekusi lebih dari 1 dtk yang memuat Query ID akan menampilkan tautan ke Query Insight. Klik tautan tersebut untuk membuka kueri secara langsung di Query Insight.

    Navigasi dari Riwayat Kueri Lambat:

    Di daftar kueri pada halaman Historical Slow Queries, klik ikon image di kolom Actions untuk kueri target guna membuka Query Insight.

    Query Metadata

    Metadata kueri bersumber dari log kueri lambat Hologres. Di tab Query Metadata, pilih Instance Name dan Query ID, lalu klik Search.

    Tab ini menampilkan bagian-bagian berikut:

    Informasi dasar

    Menampilkan ID instans, database, dan versi Milvus untuk kueri tersebut.

    Informasi kueri

    Menampilkan pengguna, status eksekusi, dan execution engine yang digunakan untuk kueri, sebagaimana dikumpulkan dari log kueri lambat.

    Konsumsi resource

    Menampilkan penggunaan resource selama eksekusi kueri dari log kueri lambat, termasuk fungsi pemindaian dan konsumsi CPU.

    Informasi lainnya

    Menampilkan metadata tambahan dari log kueri lambat, seperti alamat IP client.

    SQL

    Menampilkan pernyataan SQL lengkap. Gunakan opsi format untuk tampilan yang lebih mudah dibaca, atau salin pernyataan tersebut secara langsung.

    Detail kueri

    Jika kueri dijalankan dengan parameter, bagian ini menampilkan nilai parameter spesifik. Gabungkan parameter ke dalam pernyataan SQL jika diperlukan.

    Rencana eksekusi

    Menampilkan rencana eksekusi dari bidang Plan dalam log kueri lambat.

    Rencana eksekusi hanya dikumpulkan untuk kueri dengan waktu eksekusi lebih dari 10 dtk.

    Gunakan fitur visualisasi rencana untuk melihat representasi grafis dari rencana tersebut. Untuk informasi dasar tentang cara membaca rencana eksekusi, lihat EXPLAIN dan EXPLAIN ANALYZE.

    Statistik

    Menampilkan data konsumsi tingkat operator dari bidang Statistics dalam log kueri lambat, termasuk jumlah baris yang dipindai dan waktu eksekusi untuk setiap operator. Gunakan data ini untuk mengidentifikasi operator mana yang paling banyak mengonsumsi resource.

    Informasi tabel Baca/Tulis

    Menampilkan daftar tabel yang dibaca atau ditulis oleh kueri. Klik salah satu tautan untuk navigasi ke analisis tambahan:

    • Table Metadata: Membuka halaman Table Metadata untuk tabel yang dipilih. Metadata tabel berasal dari tabel hg_table_info dan diperbarui setiap hari (T+1)—tabel yang dibuat hari ini belum dapat dikueri hingga besok.

    • Table Lock Analysis: Membuka halaman Table Lock Analysis untuk memeriksa apakah kueri memegang kunci terkait bahasa manipulasi data (DML). Fitur ini berguna ketika kueri dengan rencana tetap melambat akibat operasi DML konkuren dari execution engine Hologres (HQE).

    Analisis Konflik DDL

    Menampilkan apakah tabel yang terlibat dalam kueri menjalani operasi bahasa definisi data (DDL) dalam rentang satu menit sebelum atau sesudah waktu eksekusi kueri. Jika kueri gagal dengan pesan error Query is canceled, bagian ini membantu Anda memastikan apakah konflik DDL menyebabkan kegagalan tersebut.

    Pesan error

    Jika kueri gagal, detail error akan muncul di sini. Query Insight di HoloWeb secara otomatis menambahkan penyebab kegagalan dan saran perbaikan untuk membantu Anda menyelesaikan error SQL. Untuk referensi kegagalan SQL umum, lihat FAQ untuk pernyataan SQL Hologres.

    Table Metadata

    Metadata tabel berasal dari tabel sistem hg_table_info, yang diperbarui sekali setiap pagi. Data tersedia dengan basis T+1.

    Navigasi ke Table Metadata dengan mengklik tautan Table Metadata di bagian Read/Write Table Information pada Query Metadata, atau masukkan langsung nama instans, database, skema, dan waktu pengumpulan metadata.

    Tab ini menampilkan bagian-bagian berikut:

    • Informasi dasar: Nama tabel, apakah tabel dipartisi, dan detail partisi.

    • Informasi Metadata Tabel: Waktu pembuatan tabel, waktu pengumpulan metadata, dan kapasitas penyimpanan.

    • Informasi Properti Tabel: Indeks yang ditetapkan pada tabel, termasuk primary key (PK) dan distribution key.

    • Table Schema Information: Bidang, tipe bidang, nullability, dan nilai default.

    Visualisasi rencana

    Plan Visualization menampilkan bidang Plan dari log kueri lambat sebagai rencana eksekusi grafis.

    Data rencana hanya dikumpulkan untuk kueri yang berjalan lebih dari 10 dtk.

    Titik awal: Periksa terlebih dahulu bagian Statistics di Query Metadata. Bagian ini menampilkan jumlah baris dan waktu eksekusi tingkat operator, sehingga Anda dapat mengidentifikasi operator yang paling banyak mengonsumsi resource sebelum menjelajahi graf rencana lengkap.

    Untuk referensi mengenai konsep rencana eksekusi, lihat EXPLAIN dan EXPLAIN ANALYZE.

    Analisis kunci tabel

    Table Lock Analysis memeriksa apakah kueri menghasilkan operasi DML (INSERT, UPDATE, atau DELETE) di execution engine Hologres (HQE). Kunci muncul ketika sebuah tabel memiliki kueri baca dari SDK atau HQE dan kueri DML dari HQE yang berjalan secara bersamaan.

    Table Lock Analysis hanya mendeteksi kunci terkait DML, bukan kunci DDL.

    Jika terdeteksi kontensi kunci, hindari menjalankan kueri SDK dan operasi DML HQE terhadap tabel yang sama secara bersamaan.

    Pemecahan masalah

    Error: relation with OID xxx does not exist

    Error ini terjadi ketika tabel yang terlibat dalam kueri mengalami operasi TRUNCATE atau DROP, yang mengubah object identifier (OID) tabel tersebut.

    Untuk menyelidiki: Masukkan Query ID di Query Insight dan periksa bagian DDL Conflict Analysis untuk memastikan apakah kunci DDL ada pada saat eksekusi kueri.

    image

    Error: query is canceled

    Error ini terjadi ketika tabel yang terlibat dalam kueri menjalani operasi DDL—seperti TRUNCATE atau DROP—saat kueri sedang dieksekusi.

    Untuk menyelidiki: Masukkan Query ID di Query Insight. Di tab Query Metadata, buka bagian DDL Conflict Analysis untuk melihat operasi DDL pada tabel yang terpengaruh.

    image

    Latensi tinggi untuk pernyataan SQL SDK

    Jika pernyataan SQL SDK memakan waktu lebih lama dari yang diharapkan, periksa adanya kontensi kunci.

    Untuk menyelidiki: Di bagian Read/Write Table Information, klik Table Lock Analysis.

    image

    Jika analisis menunjukkan adanya pernyataan DML konkuren dari HQE, maka operasi DML HQE tersebut telah mengambil kunci tabel, sehingga kueri SDK harus menunggu. Hindari menjalankan kedua jenis operasi tersebut terhadap tabel yang sama secara bersamaan.

    Jika tidak ditemukan operasi DML HQE, maka latensi tersebut bukan disebabkan oleh kunci tabel. Lihat Optimalkan performa write dan update untuk investigasi lebih lanjut.

    Error: Dispatch query failed: The shards are incomplete

    Error ini menunjukkan bahwa satu atau beberapa shard di instans Hologres berada dalam kondisi tidak konsisten, biasanya akibat coredump. Masalah ini disebabkan oleh cacat perangkat lunak pada versi lama (seperti r4.1.10) dan tidak terkait dengan jumlah koneksi.

    Untuk mengatasi masalah ini, upgrade instans Hologres Anda ke versi 4.1.12 atau lebih baru. Kami merekomendasikan upgrade ke versi 4.1.18 atau lebih baru untuk stabilitas terbaik. Untuk petunjuknya, lihat Upgrade versi instans.

    Langkah selanjutnya