Hologres:Kelola kueri

Hologres kompatibel dengan PostgreSQL. Anda dapat melihat informasi waktu proses kueri dalam suatu instans menggunakan tampilan HG_STAT_ACTIVITY (PG_STAT_ACTIVITY) untuk menganalisis dan mendiagnosis pernyataan SQL yang sedang berjalan. Operasi tersebut mencakup hal-hal berikut:

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

• Kelola kueri aktif di Konsol HoloWeb: Lihat dan kelola kueri aktif di Konsol HoloWeb.

• Troubleshooting kunci: Gunakan kueri aktif untuk memeriksa apakah pernyataan SQL saat ini memegang kunci atau diblokir oleh kunci tersebut.

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

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

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

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

• FAQ: Pelajari penyebab dan solusi dari error ERROR: canceling statement due to statement timeout.

Jika Anda lebih suka mengkueri kueri aktif menggunakan SQL, jalankan pernyataan SQL berikut:

1. Lihat kueri aktif saat ini beserta tahap eksekusi dan konsumsi sumber dayanya:

   Catatan

   Superuser dapat melihat informasi waktu proses SQL semua pengguna. Pengguna non-superuser hanya dapat melihat informasi waktu proses SQL miliknya sendiri.

   -- Sintaks 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'
   
   -- Sintaks untuk Hologres V1.3 dan versi sebelumnya
   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:

   -- Sintaks 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:

   -- Sintaks 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 jangka panjang dalam instans saat ini:

   -- Sintaks 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;
   
   -- Sintaks untuk Hologres V1.3 dan versi sebelumnya
   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;

   Pernyataan update telah berjalan selama 24 detik dan belum selesai.

Anda dapat melihat dan mengelola kueri aktif di Konsol HoloWeb.

1. Masuk ke Konsol HoloWeb. Untuk informasi selengkapnya, 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 kueri berisi informasi berikut:

   Parameter	Deskripsi
   Query Start	Waktu saat kueri dimulai.
   Runtime	Waktu eksekusi kueri.
   PID	ID proses layanan kueri.
   Query	Pernyataan SQL yang dijalankan.
   State	Status koneksi saat ini. Status umum meliputi: active: Koneksi aktif. idle: Idle. idle in transaction: Koneksi idle dalam transaksi jangka panjang. idle in transaction (Aborted): Koneksi idle dalam transaksi yang gagal. \N: Status kosong. Ini menunjukkan proses yang bukan koneksi pengguna. Biasanya merupakan proses maintenance latar belakang sistem dan dapat diabaikan.
   User Name	Username koneksi saat ini.
   Application	Jenis aplikasi kueri.
   Client Address	Alamat IP klien yang memulai kueri.

   Jika suatu kueri berjalan lama, klik Cancel di kolom Actions kueri tersebut untuk menghentikannya. Anda juga dapat memilih beberapa kueri sekaligus dan mengklik Batch Cancel.

5. (Opsional) Klik Details di kolom Actions kueri target untuk melihat detailnya.

   Di halaman Details, Anda dapat melakukan operasi berikut:

   • Copy: Salin pernyataan SQL yang dijalankan.

   • Format: Format pernyataan SQL yang dijalankan.

Untuk menghentikan kueri yang tidak sesuai harapan, jalankan perintah berikut.

• Hentikan satu kueri:

  SELECT pg_cancel_backend(<pid>);

• Hentikan 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'