Hologres:Mengelola koneksi

Pengelolaan koneksi dan kueri

Mengkueri tampilan pg_stat_activity

select * from pg_stat_activity ;

Penggunaan

Hanya Superuser yang dapat melihat semua informasi koneksi. Pengguna standar hanya dapat melihat koneksi miliknya sendiri.

Koneksi maksimum default

Mengelola koneksi di HoloWeb

Mengkueri informasi koneksi menggunakan SQL

Jika Anda lebih suka menggunakan SQL untuk mengkueri informasi koneksi, Anda dapat melakukan operasi berikut.

1. Mengkueri jumlah koneksi ke database saat ini.

   Anda dapat menjalankan perintah berikut untuk melihat jumlah koneksi ke database saat ini. Untuk informasi lebih lanjut tentang bidang-bidang tersebut, lihat Mengkueri tampilan pg_stat_activity.

   • Untuk 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;

   • Untuk Hologres V0.10 dan versi 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. Menampilkan status setiap koneksi.

   Anda dapat menggunakan HoloWeb di Konsol Hologres untuk melihat status koneksi setiap instans, atau eksekusi pernyataan berikut untuk mengkueri tampilan pg_stat_activity guna mendapatkan status semua koneksi JDBC atau PSQL.

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

   Ganti <statename> dengan salah satu parameter status berikut:

   • idle: Koneksi idle. Proses sedang menunggu perintah client baru.

   • active: Koneksi aktif, di mana proses sedang mengeksekusi kueri.

   • idle in transaction: Proses berada dalam transaksi tetapi tidak sedang mengeksekusi kueri.

   • idle in transaction (aborted): Proses berada dalam transaksi gagal, dan proses tidak sedang mengeksekusi kueri.

   • fastpath function call: Menunjukkan bahwa proses sedang mengeksekusi fungsi fast-path.

   • disabled: Menunjukkan bahwa track activities untuk proses dinonaktifkan.

   Sebagai contoh, Anda dapat menjalankan perintah berikut untuk mengkueri koneksi idle di instans saat ini.

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

   Komponen periferal Hologres, seperti HoloWeb, menggunakan JDBC dan mengonsumsi sejumlah koneksi tertentu. Jika Anda memiliki jumlah koneksi yang cukup, Anda tidak perlu khawatir tentang penggunaan ini. Jika jumlah koneksi SQL secara konsisten mendekati atau mencapai max_connections, ini menunjukkan bahwa Anda harus memeriksa aplikasi Anda untuk kebocoran koneksi dan menetapkan ukuran kolam koneksi yang sesuai. Atau, Anda dapat melepaskan koneksi idle seperti yang dijelaskan pada bagian berikut. Untuk informasi lebih lanjut, lihat Melepaskan koneksi.

3. Menampilkan jumlah koneksi pada setiap node akses

   Anda dapat mengkueri jumlah koneksi saat ini pada setiap node FE instans. Fitur ini didukung di Hologres V1.3.23 dan versi lebih baru. Node FE tanpa koneksi aktif tidak muncul dalam hasil kueri.

   select * from hologres.hg_connections;

   Tabel berikut menjelaskan bidang-bidang dalam hasil kueri.

   • fe_id: ID node FE.

   • used_connections: Jumlah koneksi yang sedang digunakan pada node FE.

   • max_connections: Jumlah maksimum koneksi untuk node FE, yang sama dengan nilai kembali perintah show max_connections.

Menghentikan koneksi

Kondisi berikut menunjukkan bahwa batas koneksi untuk sistem atau node akses tertentu telah tercapai:

• Jika jumlah koneksi mencapai atau melebihi nilai max_connections, Anda dapat melihat jumlah koneksi di halaman Monitoring and Alarms di konsol Hologres.

• Terjadi error FATAL: sorry, too many clients already connection limit exceeded for superusers.

• Terjadi error FATAL: remaining connection slots are reserved for non-replication superuser connections.

Jika Anda mengalami masalah ini, hubungkan ke instans dengan akun Superuser dan jalankan pernyataan berikut untuk memeriksa apakah terdapat terlalu banyak koneksi idle.

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

Jika hasil kueri menunjukkan jumlah proses idle yang tidak perlu secara berlebihan, temukan pid dari hasil tersebut dan jalankan pernyataan berikut untuk melepaskan koneksi idle. Untuk informasi lebih lanjut tentang bidang-bidang tersebut, lihat Mengkueri tampilan pg_stat_activity.

select pg_cancel_backend(<pid>);     -- Membatalkan kueri pada koneksi.
select pg_terminate_backend(<pid>);  -- Menghentikan proses koneksi backend yang sesuai.

-- Menghentikan 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 terlebih dahulu untuk Superuser

Hologres menyediakan sejumlah koneksi terlebih dahulu untuk Superuser. Jumlah koneksi terlebih dahulu bervariasi berdasarkan spesifikasi instans. Untuk informasi lebih lanjut, lihat Manajemen instans. Koneksi terlebih dahulu ini digunakan untuk tugas manajemen, seperti menghentikan koneksi idle saat batas koneksi maksimum tercapai. Jumlah maksimum koneksi yang tersedia untuk pengguna standar adalah max_connections dikurangi jumlah koneksi terlebih dahulu. Kami merekomendasikan agar Anda tidak menggunakan akun Superuser untuk operasi database reguler. Hal ini dapat menghabiskan semua koneksi yang tersedia, sehingga mencegah Anda menggunakan saluran administratif untuk melepaskannya.

Batas koneksi pengguna

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

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

Secara otomatis menghentikan koneksi idle

Jika jumlah koneksi ke instans secara konsisten mendekati batas atas, aplikasi Anda mungkin mengalami kebocoran koneksi. Anda dapat mengaktifkan penghentian otomatis koneksi idle untuk melepaskan sumber daya. Saat koneksi idle lebih lama dari waktu yang ditentukan, koneksi tersebut akan secara otomatis diputus.

• Batasan

  Penghentian otomatis koneksi idle hanya didukung di Hologres V0.10.25 dan versi lebih baru. Jika instans Anda menjalankan versi sebelumnya, lihat Error umum yang terjadi saat upgrade atau bergabunglah dengan grup DingTalk Hologres untuk meminta upgrade instans. Untuk informasi tentang cara bergabung dengan grup DingTalk untuk dukungan online, lihat Bagaimana cara mendapatkan dukungan online lebih lanjut?

• Sintaks

  • Tingkat session

    -- Secara otomatis memutus koneksi jika telah idle selama 10 menit (600.000 milidetik).
    SET idle_session_timeout = 600000;

  • Tingkat database

    -- Secara otomatis memutus koneksi ke database ini jika telah idle selama 10 menit (600.000 milidetik).
    ALTER DATABASE  <db_name> SET idle_session_timeout = 600000;

    Ganti <db_name> dengan nama database tempat Anda ingin mengaktifkan penghentian otomatis koneksi idle.

Praktik terbaik koneksi

Error umum

• Pesan error dikembalikan selama eksekusi SQL: terminating connection due to idle state timeout.

• Penyebab: Koneksi secara otomatis dihentikan karena melebihi timeout idle yang dikonfigurasi.

• Solusi: Hubungkan ulang ke instans atau tingkatkan timeout koneksi idle. Untuk informasi tentang cara mengubah timeout koneksi idle, lihat Secara otomatis menghentikan koneksi idle.