Hologres:Kelola kueri

Hologres kompatibel dengan PostgreSQL. Anda dapat menggunakan tampilan hg_stat_activity (pg_stat_activity) untuk memantau informasi waktu proses kueri dalam suatu instans guna analisis dan diagnostik. Topik ini mencakup operasi berikut:

• Tampilan hg_stat_activity (pg_stat_activity): Lihat informasi waktu proses SQL untuk mengelola pernyataan SQL secara lebih baik.

• Kelola kueri aktif di HoloWeb: Gunakan Konsol HoloWeb untuk melihat dan mengelola kueri aktif.

• Troubleshooting lock: Gunakan kueri aktif untuk mengidentifikasi apakah suatu pernyataan SQL sedang memegang lock atau diblokir olehnya.

• Hentikan kueri: Gunakan perintah untuk menghentikan kueri yang tidak berjalan sesuai harapan.

• Ubah timeout untuk kueri aktif: Ubah timeout eksekusi untuk kueri aktif guna mencegah deadlock.

• Ubah timeout untuk kueri idle: Ubah timeout untuk kueri idle guna mencegah deadlock.

• Kueri log kueri lambat: Gunakan log kueri lambat untuk mendiagnosis, menganalisis, dan mengoptimalkan kueri yang lambat atau gagal.

• FAQ: Penyebab dan solusi untuk error ERROR: canceling statement due to statement timeout.

Jika Anda lebih suka melihat kueri aktif menggunakan SQL, Anda dapat menggunakan pernyataan berikut:

1. Lihat kueri aktif, tahap eksekusinya, dan konsumsi resource.

   Catatan

   Superuser dapat melihat informasi waktu proses untuk semua pengguna, sedangkan pengguna lain hanya dapat melihat milik mereka sendiri.

   -- Untuk Hologres V2.0 dan versi lebih baru
   SELECT query,state,query_id,transaction_id,running_info, extend_info 
   FROM hg_stat_activity 
   WHERE state = 'active' 
   AND     backend_type = 'client backend'
   AND     application_name != 'hologres'
   
   -- Untuk Hologres V1.3 dan versi lebih lama
   SELECT query,state,pid
   FROM pg_stat_activity 
   WHERE state = 'active' 
   AND     backend_type = 'client backend'
   AND     application_name != 'hologres'

   Contoh hasil:

   -------------------------------------------------------------------------------
   query          | insert into test_hg_stat_activity select i, (i % 7) :: text, (i % 1007) from generate_series(1, 10000000)i;
   state          | active
   query_id       | 100713xxxx
   transaction_id | 100713xxxx
   running_info   | {"current_stage" : {"stage_duration_ms" :5994,
                                         "stage_name" :"EXECUTE" },
                      "engine_type" :"{HQE,PQE}",
                      "fe_id" :1,
                      "warehouse_id" :0 }
   extend_info    | {"affected_rows" :9510912,
                     "scanned_rows" :9527296 }

2. Urutkan kueri yang sedang berjalan berdasarkan konsumsi CPU.

   -- Untuk Hologres V2.0 dan versi lebih baru
   SELECT query,((extend_info::json)->'total_cpu_max_time_ms')::text::bigint AS cpu_cost,state,query_id,transaction_id 
   FROM hg_stat_activity WHERE state = 'active' ORDER BY 2 DESC;

   Contoh hasil:

   ---------------------------------------------------------------------------------
   query          | select xxxxx
   cpu_cost       | 523461
   state          | active
   query_id       | 10053xxxx
   transaction_id | 10053xxxx
   ---------------------------------------------------------------------------------
   query          | insert xxxx
   cpu_cost       | 4817
   state          | active
   query_id       | 1008305xxx
   transaction_id | 1008305xxx

3. Urutkan kueri yang sedang berjalan berdasarkan konsumsi memori.

   -- Untuk Hologres V2.0 dan versi lebih baru
   SELECT query,((extend_info::json)->'total_mem_max_bytes')::text::bigint AS mem_max_cost,state,query_id,transaction_id 
   FROM hg_stat_activity WHERE state = 'active' ORDER BY 2 DESC;

   Contoh hasil:

   ---------------------------------------------------------------------------------
   query          | update xxxx;
   mem_max_cost   | 5727634542
   state          | active
   query_id       | 10053302784827629
   transaction_id | 10053302784827629
   ---------------------------------------------------------------------------------
   query          | select xxxx;
   mem_max_cost   | 19535640
   state          | active
   query_id       | 10083259096119559
   transaction_id | 10083259096119559

4. Lihat kueri berdurasi panjang dalam instans saat ini.

   -- Untuk Hologres V2.0 dan versi lebih baru
   SELECT current_timestamp - query_start AS runtime, datname::text, usename, query, query_id
       FROM hg_stat_activity
       WHERE state != 'idle'
       AND backend_type = 'client backend'
       AND application_name != 'hologres'
       ORDER BY 1 DESC;
   
   -- Untuk Hologres V1.3 dan versi lebih lama
   SELECT current_timestamp - query_start AS runtime, datname::text, usename, query, pid
       FROM pg_stat_activity
       WHERE state != 'idle'
       AND backend_type = 'client backend'
       AND application_name != 'hologres'
       ORDER BY 1 DESC;

   Contoh hasil:

   runtime          |  datname  | usename  | query_id    |      current_query
   -----------------+----------------+----------+------------------------------------
    00:00:24.258388 | holotest  | 123xxx   | 1267xx | UPDATE xxx;
    00:00:1.186394  | testdb    | 156xx    | 1783xx | select xxxx;

   Hasil tersebut menunjukkan bahwa pernyataan UPDATE telah berjalan selama 24 detik tanpa selesai.

Anda dapat melihat dan mengelola kueri aktif di Konsol HoloWeb.

1. Masuk ke Konsol HoloWeb. Untuk informasi lebih lanjut, lihat Hubungkan ke HoloWeb dan jalankan kueri.

2. Di bilah navigasi atas, klik Diagnostics and Optimization.

3. Di panel navigasi kiri, pilih Management for Information About Active Queries > Active Query Tasks.

4. Di halaman Active Query Tasks, klik Search untuk melihat dan mengelola kueri aktif pada instans saat ini.

   Daftar hasil mencakup informasi berikut:

   Parameter	Deskripsi
   Query start	Kapan kueri dimulai.
   Runtime	Waktu eksekusi kueri.
   PID	ID proses (PID) layanan yang menangani kueri.
   Query	Pernyataan SQL yang dieksekusi.
   State	Status koneksi saat ini. Status umum meliputi: active: Kueri sedang berjalan. idle: Koneksi dalam keadaan idle. idle in transaction: Koneksi idle dalam transaksi. idle in transaction (Aborted): Koneksi idle dalam transaksi yang gagal. \N: Status null. Biasanya menunjukkan proses maintenance latar belakang sistem, bukan koneksi pengguna, dan dapat diabaikan.
   User name	Username untuk koneksi saat ini.
   Application	Aplikasi yang memulai kueri.
   Client address	Alamat IP klien.

   Untuk menghentikan kueri berdurasi panjang, klik Cancel di kolom Actions-nya. Anda juga dapat memilih beberapa kueri dan klik Batch Cancel.

5. (Opsional) Klik Details di kolom Actions untuk suatu kueri guna melihat informasi detailnya.

   Di halaman Details, Anda dapat melakukan operasi berikut:

   • Copy: Salin pernyataan SQL yang dieksekusi oleh kueri.

   • Format: Format pernyataan SQL yang dieksekusi oleh kueri.

Untuk menghentikan kueri yang tidak berjalan sesuai harapan, gunakan perintah berikut.

• Untuk menghentikan satu kueri:

  SELECT pg_cancel_backend(<pid>);

• Untuk menghentikan beberapa kueri secara batch:

  SELECT pg_cancel_backend(pid)
          ,query
          ,datname
          ,usename
          ,application_name
          ,client_addr
          ,client_port
          ,backend_start
          ,state
  FROM    pg_stat_activity
  WHERE   length(query) > 0
  AND     pid != pg_backend_pid()
  AND     backend_type = 'client backend'
  AND     application_name != 'hologres'