Hologres:Query Insight

Prasyarat

Instans telah masuk. Untuk informasi selengkapnya, lihat Masuk ke instans.

Access Query Insight

Anda dapat mengakses Query Insight langsung dari halaman Diagnostics and Optimization di HoloWeb. Alternatifnya, Anda juga dapat menavigasi ke Query Insight dari SQL Editor atau halaman Historical Slow Queries di HoloWeb.

1. Login ke Hologres Management Console.

2. Di panel navigasi sebelah kiri pada bilah menu atas, pilih wilayah yang diinginkan.

3. Klik Go to HoloWeb untuk menuju halaman pengembangan HoloWeb.

4. Akses halaman Query Insight.

   Akses Query Insight Secara Langsung

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

   Navigasi ke Query Insight

   Di HoloWeb, Anda dapat menavigasi ke Query Insight dari SQL Editor atau halaman Historical Slow Queries. Untuk menavigasi, ikuti langkah-langkah berikut:

   • SQL editor: Di SQL editor HoloWeb, Anda dapat menavigasi ke Query Insight dari pernyataan SQL apa pun yang memiliki waktu eksekusi lebih dari 1 detik dan berisi Query ID.

   • Kueri Lambat Historis: Di daftar kueri, klik ikon di kolom Actions pada kueri SQL target untuk membuka Query Insight.

   Di halaman Query Insight, Anda dapat melihat Query Metadata dan Table Metadata, serta melakukan Plan Visualization dan Table Lock Analysis.

Query Metadata

Metadata kueri bersumber dari log kueri lambat Hologres. Secara default, sistem hanya mengumpulkan pernyataan DML dengan waktu eksekusi lebih dari 100 ms dan semua pernyataan DDL. Namun, saat Anda mengkueri data ini, hanya pernyataan DDL dengan waktu eksekusi lebih dari 1 detik yang muncul dalam hasil. Anda harus memiliki izin tertentu untuk mengkueri log kueri lambat. Untuk informasi selengkapnya, lihat Melihat dan Menganalisis Log Kueri Lambat. Pilih tab Query Metadata, lalu pilih Instance Name dan Query ID, kemudian klik Search untuk menampilkan metadata kueri.

• Informasi Dasar

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

• Informasi Kueri

  Menampilkan informasi dasar kueri yang dikumpulkan dari log kueri lambat, seperti pengguna, status eksekusi, dan mesin eksekusi yang digunakan.

• Konsumsi Resource

  Menampilkan konsumsi resource selama eksekusi kueri, yang dikumpulkan dari log kueri lambat. Informasi ini mencakup fungsi pemindaian dan konsumsi CPU.

• Informasi Lainnya

  Menampilkan informasi tambahan ekstensi untuk kueri tersebut, yang dikumpulkan dari log kueri lambat, seperti alamat IP klien.

• SQL

  Menampilkan isi kueri SQL saat ini. Anda dapat memformat kueri untuk tampilan yang lebih intuitif atau menyalin kueri tersebut.

• Detail Kueri

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

• Rencana Eksekusi

  Menampilkan rencana eksekusi kueri, yang berasal dari bidang Plan dalam log kueri lambat. Perlu diperhatikan bahwa sistem hanya mengumpulkan rencana eksekusi untuk kueri dengan waktu eksekusi lebih dari 10 detik. Anda dapat menggunakan fitur visualisasi untuk melihat representasi grafis dari rencana eksekusi guna mengoptimalkan kueri lebih lanjut. Untuk informasi selengkapnya tentang rencana eksekusi, lihat EXPLAIN dan EXPLAIN ANALYZE.

• Statistik

  Menampilkan informasi eksekusi untuk kueri saat ini, yang dikumpulkan dari bidang Statistics dalam log kueri lambat. Bagian ini menunjukkan informasi konsumsi rinci untuk setiap operator, seperti jumlah baris yang dipindai dan waktu eksekusi operator. Anda dapat menganalisis konsumsi operator menggunakan statistik ini untuk mengoptimalkan kueri lebih lanjut.

• Informasi Tabel Baca/Tulis

  Menampilkan tabel yang dibaca atau ditulis oleh kueri saat ini. Anda dapat mengklik tautan berikut:

  • Table Metadata: Menuju halaman Table Metadata tempat Anda dapat melihat metadata tabel saat ini. Perlu diperhatikan bahwa metadata tabel dikumpulkan dari tabel `hg_table_info` dan datanya diperbarui pada hari berikutnya (T+1). Oleh karena itu, jika sebuah tabel dibuat hari ini, Anda tidak dapat mengkueri metadatanya hingga besok.

  • Table Lock Analysis: Menuju halaman Table Lock Analysis tempat Anda dapat memeriksa apakah kueri saat ini memiliki penguncian. Analisis ini hanya mendeteksi penguncian terkait DML. Misalnya, jika kueri SQL dengan rencana tetap menjadi lambat, Anda dapat menggunakan Table Lock Analysis untuk memeriksa apakah tabel tersebut memiliki operasi DML konkuren dari mesin eksekusi Hologres (HQE), yang dapat meningkatkan waktu eksekusi kueri.

• Analisis Konflik DDL

  Menampilkan apakah tabel yang terlibat dalam kueri saat ini menjalani operasi DDL dalam rentang satu menit sebelum atau sesudah eksekusi kueri. Hal ini membantu Anda menentukan apakah konflik DDL menyebabkan kueri gagal dengan pesan error Query is canceled.

• Pesan Error

  Jika kueri gagal, detail error akan ditampilkan. Selain itu, fitur diagnosis SQL cerdas di Query Insight pada HoloWeb secara otomatis menambahkan penyebab kegagalan dan solusi baru ke bagian Error Message untuk membantu Anda menyelesaikan error SQL dengan lebih mudah. Untuk informasi selengkapnya tentang kegagalan umum pernyataan SQL dan solusinya, lihat FAQ untuk pernyataan SQL Hologres.

Table Metadata

Metadata tabel bersumber dari tabel sistem Hologres `hg_table_info`, yang berisi statistik tabel. Sistem mengumpulkan dan melaporkan data ini sekali setiap pagi. Data diperbarui dengan basis T+1. Oleh karena itu, Anda dapat mengkueri metadata tabel untuk hari ini pada hari berikutnya.

Anda dapat menuju halaman Table Metadata dari informasi tabel di Query Metadata untuk melihat metadata tabel yang sesuai. Anda juga dapat memasukkan informasi tabel secara manual, seperti nama instans, database, dan skema, serta waktu pengumpulan metadata untuk melihat metadata tabel tersebut.

• Informasi Dasar

  Mencakup nama tabel dan menunjukkan apakah tabel tersebut dipartisi. Juga menyediakan informasi terkait partisi.

• Informasi Metadata Tabel

  Mencakup waktu pembuatan tabel, waktu pengumpulan metadata, dan kapasitas penyimpanan.

• Informasi Properti Tabel

  Menampilkan indeks yang ditetapkan untuk tabel saat ini, seperti primary key (PK) dan distribution key.

• Informasi Skema Tabel

  Menampilkan skema tabel, termasuk bidang, tipe bidang, nullability, dan nilai default.

Plan Visualization

Fitur visualisasi rencana menampilkan bidang `plan` dari log kueri lambat. Perlu diperhatikan bahwa informasi rencana hanya dikumpulkan untuk kueri yang berjalan lebih dari 10 detik. Untuk informasi selengkapnya tentang rencana eksekusi, lihat EXPLAIN dan EXPLAIN ANALYZE.

Table Lock Analysis

Table Lock Analysis memeriksa apakah pernyataan SQL saat ini menghasilkan operasi DML (INSERT, UPDATE, atau DELETE) di mesin eksekusi Hologres (HQE). Hal ini membantu Anda mendiagnosis masalah eksekusi lambat pada pernyataan SQL SDK yang disebabkan oleh penguncian. Penguncian terjadi jika sebuah tabel memiliki kueri SDK atau HQE dan kueri DML HQE yang berjalan secara konkuren. Anda sebaiknya menghindari menjalankan kedua jenis operasi tersebut secara bersamaan.

Atasi Masalah Umum Menggunakan Query Insight

• Error: relation with OID xxx does not exist

  Metode troubleshooting: Error ini biasanya terjadi karena tabel yang terlibat dalam kueri mengalami operasi TRUNCATE atau DROP, yang mengubah OID tabel tersebut. Anda dapat menggunakan Query Insight untuk melihat Query ID yang melaporkan error dan memastikan apakah terdapat penguncian DDL pada waktu yang sama.

• Error: query is canceled

  Troubleshooting: Error ini terjadi karena tabel yang terlibat dalam kueri menjalani operasi DDL, seperti TRUNCATE atau DROP, saat kueri sedang dieksekusi. Anda dapat memasukkan Query ID dari kueri yang gagal ke Query Insight. Di tab Query Metadata, pada area DDL Conflict Analysis, Anda dapat melihat operasi DDL pada tabel tersebut.

• Latensi Tinggi pada Pernyataan SQL SDK

  Jika pernyataan SQL SDK mengalami latensi tinggi, gunakan Query Insight untuk memeriksa kontensi penguncian. Misalnya, jika suatu pernyataan membutuhkan waktu 18 detik untuk dieksekusi, klik Lock Analysis di area Information of Table for Data Read and Write. Sebuah pernyataan DML dari HQE dieksekusi secara bersamaan. Pernyataan DML yang dieksekusi menggunakan HQE mengambil penguncian tabel. Akibatnya, pernyataan SQL SDK dalam kueri menunggu penguncian dilepas, yang meningkatkan durasi eksekusi. Jika tidak ditemukan pernyataan DML dari HQE, berarti tidak ada penguncian tabel yang diambil. Dalam kasus ini, lihat Optimalkan performa write dan update untuk menyelidiki penyebab lebih lanjut.