Hologres：Mengelola koneksi

Ikhtisar pengelolaan koneksi dan kueri

Menanyakan Tampilan pg_stat_activity

select * from pg_stat_activity ;

Catatan Penggunaan

Hanya superuser yang dapat melihat informasi tentang semua koneksi. Pengguna biasa hanya dapat melihat informasi tentang koneksi mereka sendiri.

Menanyakan Jumlah Maksimum Default Koneksi ke Instans Hologres

Mengelola Koneksi di Konsol HoloWeb

Menanyakan Informasi Koneksi dengan Menjalankan Pernyataan SQL

Anda dapat menjalankan pernyataan SQL untuk menanyakan informasi koneksi.

1. Menanyakan jumlah koneksi ke database saat ini.

   Anda dapat menggunakan perintah berikut untuk melihat jumlah koneksi ke database saat ini. Untuk informasi selengkapnya tentang metrik, lihat Deskripsi metrik.

   • Sintaksis yang didukung di Hologres V1.1 dan versi lebih baru

     SELECT  datname::TEXT
             ,COUNT(1) AS COUNT
     FROM    pg_stat_activity
     WHERE   backend_type = 'client backend'
     AND     application_name != 'hologres'
     GROUP BY datname::TEXT;

   • Hologres V0.10 dan versi yang lebih lama.

     SELECT  datname
             ,COUNT(1) AS COUNT
     FROM    pg_stat_activity
     WHERE   backend_type = 'client backend'
     AND     application_name != 'hologres'
     GROUP BY datname;

2. Menanyakan status setiap koneksi.

   Anda dapat mengkueri status setiap koneksi ke instans menggunakan HoloWeb di konsol Hologres. Anda juga dapat mengeksekusi pernyataan berikut untuk mengkueri semua koneksi Java Database Connectivity (JDBC) atau PostgreSQL dalam status tertentu dengan mengkueri tampilan pg_stat_activity:

   select * from pg_stat_activity where backend_type = 'client backend' and state = '<statename>';

   Di mana statename adalah parameter status. Nilai valid sebagai berikut:

   • idle: menentukan koneksi idle. Status ini menunjukkan bahwa proses sedang menunggu perintah dari klien.

   • active: menentukan koneksi aktif. Status ini menunjukkan bahwa proses sedang mengeksekusi pernyataan query.

   • idle in transaction: Status ini menunjukkan bahwa proses berada dalam transaksi tetapi tidak mengeksekusi pernyataan query.

   • idle in transaction (aborted): Status ini menunjukkan bahwa proses berada dalam transaksi yang berisi pernyataan query. Pernyataan query tidak dapat dieksekusi karena kesalahan sintaksis.

   • fastpath function call: Status ini menunjukkan bahwa proses sedang mengeksekusi fungsi fast-path.

   • disabled: Menonaktifkan track activities untuk proses tersebut.

   Sebagai contoh, Anda dapat menjalankan pernyataan berikut untuk menanyakan koneksi idle ke instans saat ini:

   select * from pg_stat_activity where backend_type = 'client backend' and state = 'idle';

   Komponen Hologres seperti HoloWeb menggunakan koneksi JDBC. Jika jumlah maksimum koneksi ke instans Hologres Anda memenuhi persyaratan bisnis Anda, Anda tidak perlu khawatir tentang koneksi ini. Jika jumlah koneksi SQL ke instans Hologres Anda mendekati atau mencapai batas atas yang ditentukan oleh max_connections, periksa apakah kebocoran koneksi terjadi di aplikasi Anda. Jika kebocoran koneksi terjadi, konfigurasikan batas yang masuk akal pada pool koneksi aplikasi Anda atau lepaskan koneksi idle. Untuk informasi lebih lanjut tentang cara melepaskan koneksi idle, lihat Melepaskan Koneksi dalam topik ini.

3. Menanyakan jumlah koneksi ke setiap node FE.

   Di Hologres V1.3.23 dan versi lebih baru, Anda dapat menjalankan pernyataan berikut untuk menanyakan jumlah koneksi ke setiap node FE dari instans Hologres. Pernyataan ini tidak mengembalikan informasi tentang node FE yang tidak memiliki koneksi.

   select * from hologres.hg_connections;

   Deskripsi bidang dalam hasil yang dikembalikan:

   • fe_id: ID node FE.

   • used_connections: jumlah koneksi yang digunakan oleh node FE.

   • max_connections: jumlah maksimum koneksi yang diizinkan ke node FE. Nilai bidang ini sama dengan nilai balik perintah show max_connections.

Melepaskan Koneksi

Dalam skenario berikut, jumlah koneksi ke instans Hologres atau ke satu node FE dari instans Hologres mencapai batas atas:

• Jumlah koneksi mencapai atau melebihi nilai parameter max_connections. Anda dapat melihat jumlah koneksi di tab Informasi Pemantauan halaman detail instans di konsol Hologres.

• Pesan kesalahan berikut dikembalikan: FATAL: sorry, too many clients already connection limit exceeded for superusers.

• Pesan kesalahan berikut dikembalikan: FATAL: remaining connection slots are reserved for non-replication superuser connections.

Dalam skenario ini, Anda dapat terhubung ke instans Hologres sebagai superuser dan menjalankan pernyataan berikut untuk memeriksa apakah ada koneksi idle yang berlebihan:

select * from pg_stat_activity where backend_type = 'client backend' and state = 'idle';

Jika hasil kueri menunjukkan bahwa terdapat proses idle berlebihan dan Anda memastikan bahwa koneksi tersebut tidak berguna, Anda dapat mengeksekusi pernyataan berikut untuk melepaskan koneksi idle sesuai kebutuhan. Anda dapat menggunakan nilai bidang pid dalam hasil kueri sebelumnya untuk menentukan koneksi yang ingin Anda lepaskan. Untuk informasi selengkapnya tentang bidang dalam pernyataan tersebut, lihat bidang-bidang dalam hasil kueri tampilan pg_stat_activity dalam topik ini.

select pg_cancel_backend(<pid>);     -- batalkan kueri pada koneksi
select pg_terminate_backend(<pid>);  -- hentikan proses koneksi backend yang sesuai

-- Hentikan proses koneksi backend IDLE secara batch untuk melepaskan koneksi
SELECT pg_terminate_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     state = 'idle'
AND     application_name != 'hologres'
AND     query not like '%pg_cancel_backend%';

Koneksi yang dicadangkan Administrator

Hologres secara otomatis menyediakan koneksi untuk superuser instans Hologres. Jumlah koneksi cadangan ke instans bervariasi berdasarkan spesifikasi instans. Untuk informasi lebih lanjut, lihat Manajemen Instans. Untuk instans Hologres, koneksi cadangan digunakan oleh superuser untuk mengelola koneksi ketika jumlah koneksi ke instans mencapai batas atas. Misalnya, superuser dapat menutup koneksi idle. Jumlah maksimum koneksi yang dapat digunakan pengguna biasa sama dengan jumlah maksimum koneksi dikurangi jumlah koneksi cadangan. Jika Anda adalah pengguna biasa, kami sarankan Anda tidak menggunakan akun superuser untuk mengelola database. Jika tidak, tidak ada koneksi yang dicadangkan, dan koneksi tidak dapat dilepaskan.

Jumlah Maksimum Koneksi untuk Satu Pengguna

SELECT rolname, rolconnlimit
FROM pg_roles
WHERE rolconnlimit <> -1;

       rolname | rolconnlimit 
---------------+--------------
 p4_283813xxxx |      1
(1 row)

Mengaktifkan Sistem untuk Secara Otomatis Melepaskan Koneksi Idle

Jika jumlah koneksi ke instans Hologres Anda mendekati atau mencapai batas atas, kemungkinan terjadi kebocoran koneksi. Anda dapat mengaktifkan pelepasan otomatis koneksi idle untuk melepaskan koneksi yang tidak digunakan selama periode waktu tertentu. Jika koneksi tetap idle selama periode waktu tertentu, koneksi tersebut akan ditutup secara otomatis. Koneksi yang tidak sedang mengeksekusi pernyataan SQL dianggap idle.

• Batasan

  Hologres V0.10.25 dan versi lebih baru mendukung pelepasan otomatis koneksi idle. Jika versi instans Hologres Anda lebih lama dari V0.10.25, tingkatkan instans Hologres Anda secara manual di konsol Hologres atau bergabunglah dengan grup DingTalk untuk dukungan teknis. Untuk informasi lebih lanjut tentang cara meningkatkan instans Hologres Anda secara manual di konsol Hologres, lihat Kesalahan umum persiapan peningkatan dalam topik "Peningkatan Instans". Untuk informasi lebih lanjut tentang cara bergabung dengan grup DingTalk Hologres, lihat Dapatkan dukungan online untuk Hologres.

• Contoh sintaks

  • Tingkat Sesi

    -- Jika koneksi idle selama 600.000 ms (10 menit), koneksi akan ditutup secara otomatis. 
    SET idle_session_timeout = 600000;

  • Tingkat Database

    -- Jika koneksi idle selama 600.000 ms (10 menit), koneksi akan ditutup secara otomatis. 
    ALTER DATABASE  <db_name> SET idle_session_timeout = 600000;

    Parameter db_name menentukan nama database tempat Anda ingin mengaktifkan pelepasan otomatis koneksi idle.

Praktik terbaik penggunaan koneksi

Kesalahan umum

• Kesalahan berikut terjadi saat Anda mengeksekusi pernyataan SQL: terminating connection due to idle state timeout.

• Penyebab: Periode timeout untuk melepaskan koneksi idle secara otomatis dikonfigurasi untuk instans Hologres. Setelah periode timeout yang ditentukan berakhir, koneksi ditutup secara otomatis. Kemudian, pesan kesalahan ini dikembalikan.

• Solusi: Terhubung kembali ke instans Hologres, atau tingkatkan periode timeout untuk melepaskan koneksi idle secara otomatis. Untuk informasi lebih lanjut tentang cara meningkatkan periode timeout, lihat Mengaktifkan Sistem untuk Secara Otomatis Melepaskan Koneksi Idle dalam topik ini.