Hologres:Dapatkan insight kueri

Prasyarat

Sebelum memulai, pastikan Anda telah:

• Masuk ke instans Hologres. Untuk detailnya, lihat Masuk ke instans.

• Memiliki izin yang diperlukan untuk mengakses log kueri lambat. Untuk detailnya, lihat Penayangan dan analisis log kueri lambat.

Ambang batas pengumpulan data

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

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.

Navigasi ke Query Insight

Navigasi dari SQL Editor:

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

Navigasi dari Historical Slow Queries:

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

Query Metadata

Query metadata 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 mesin eksekusi yang digunakan untuk kueri, sebagaimana dikumpulkan dari log kueri lambat.

Penggunaan 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 klien.

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

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.

Baca/Tulis informasi tabel

Menampilkan daftar tabel yang dibaca atau ditulis oleh kueri. Klik salah satu tautan untuk membuka 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 baru dapat diakses mulai 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 mesin eksekusi 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 ditampilkan di sini. Query Insight di HoloWeb secara otomatis menambahkan penyebab kegagalan dan solusi yang disarankan untuk membantu Anda menyelesaikan error SQL. Untuk referensi mengenai 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.

Buka 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 detik.

Langkah awal: Periksa terlebih dahulu bagian Statistik di Query Metadata. Bagian ini menampilkan jumlah baris dan waktu eksekusi per 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 mesin eksekusi 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.

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.

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.

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, latensi tersebut bukan disebabkan oleh kunci tabel. Lihat Optimalkan performa tulis dan pembaruan untuk investigasi lebih lanjut.

Langkah selanjutnya

• Penayangan dan analisis log kueri lambat

• EXPLAIN dan EXPLAIN ANALYZE

• FAQ untuk pernyataan SQL Hologres

• Optimalkan performa tulis dan pembaruan