Hologres:Manage connections

Hologres, PostgreSQL ile uyumludur. Bağlantıları incelemek ve çalışan sorguları teşhis etmek için pg_stat_activity görünümünü sorgulayın. Temel işlemler şunlardır:

• Bağlantı mimarisi: Bir istemci bağlantısının erişim katmanından (Gateway) yürütme katmanına (FE, FixedFE ve Walsender) nasıl iletildiği ve her katmanın neden kendi bağlantı sınırına sahip olduğu.

• Katmanlara göre bağlantı sınırları: Her katmanın bağlantı sınırı ve sınır aşıldığında döndürülen hata.

• Hata mesajı referansı: Hata mesajından hangi katmanın sınırına ulaştığını belirleme ve buna ilişkin çözüm adımları.

• Varsayılan maksimum bağlantı sayısını sorgulayın: Her örnek teknik özelliğinin varsayılan bir bağlantı sınırı vardır. Kendi sınırınızı sorgulamak için bir komut çalıştırın.

• HoloWeb'de bağlantıları yönetin: HoloWeb konsolunda etkin bağlantıları görüntüleyin, yönetin ve sonlandırın.

• SQL ile bağlantıları sorgulayın: Bağlantı sayılarını sorgulayın, durumları kontrol edin ve boşta kalan bağlantıları sonlandırın.

• FixedFE bağlantılarını sorgulayın: FixedFE bağlantıları pg_stat_activity içinde görünmez. Bunun yerine özel görünümü sorgulayın.

• Bağlantıları sonlandırın: Belirli bağlantılar tarafından tutulan kaynakları serbest bırakmak için SQL işlevlerini kullanın.

• Superuser'lar için ayrılmış bağlantılar: Bağlantı sınırına ulaşıldığında yönetim işlemleri için ayrılmış bağlantıları kullanın.

• Tek bir kullanıcı için bağlantıları sınırlayın: Kaynakların aşırı kullanımını önlemek için kullanıcı başına bağlantı sınırı ayarlayın.

• Boşta kalan bağlantıları otomatik olarak sonlandırın: Belirtilen süreden daha uzun süre boşta kalan bağlantıları otomatik olarak kapatın.

• Bağlantı kullanımı için en iyi uygulamalar: Hologres bağlantı yönetimi için en iyi uygulamalar.

Gateway bağlantı sınırı

• Hologres V4.0.15'ten başlayarak, sanal depo örneğindeki tek bir Gateway düğümü en fazla 8.000 bağlantıyı kabul eder. Bu sınır daha önce sınırsızdı ve çok yüksek bağlantı oranlarının örneği kararsız hale getirmesini önlemek için getirildi. Daha fazla bilgi için bkz. V4.0 (Eylül 2025).

• Tüm örnek için Gateway sınırı, Gateway düğümü sayısı çarpı 8.000'dir. Bir örnekte en az iki Gateway düğümü bulunur ve bu sayıyı konsolda değiştirebilirsiniz.

• Erişim katmanındaki tepe yükü izlemek için konsoldaki Gateway Connection Usage ölçümünü kullanın.

Sınıra ulaşıldığında aşağıdaki hata döndürülür:

too many client tcp connections (global client_max)

FE bağlantı sınırı (max_connections)

Tek bir FE düğümünün kabul ettiği normal SQL bağlantı sayısı max_connections parametresi ile belirlenir. Varsayılan değer örnek türüne bağlıdır. Aşağıdaki gibi sorgulayın:

-- Maximum connections of a single FE node.
show max_connections;

-- Maximum connections of the whole instance (FE node count multiplied by max_connections). Supported in Hologres V1.3.23 and later.
select instance_max_connections();

Hologres, Superuser'lar için bir dizi bağlantı ayırır (superuser_reserved_connections), böylece sınıra ulaşıldığında bile oturum açabilir ve boşta kalan bağlantıları sonlandırmak gibi yönetimsel işlemleri yapabilirsiniz. Dolayısıyla normal kullanıcılar max_connections eksi ayrılmış bağlantı sayısını kullanabilir.

Sınıra ulaşıldığında aşağıdaki hatalardan biri döndürülür:

FATAL: sorry, too many clients already connection limit exceeded for superusers
FATAL: remaining connection slots are reserved for non-replication superuser connections

FixedFE bağlantı sınırı

• Her FE düğümündeki FixedFE hizmetinin düğüm başına 6.400 bağlantılık kendi sınırı vardır.

• Tüm örnek için FixedFE sınırı, FE düğümü sayısı çarpı 6.400'dür.

• FixedFE bağlantıları max_connections değerinden düşülmez ve pg_stat_activity içinde görünmez. Bunun yerine özel hg_fixed_fe_stat_activity görünümünü sorgulayın. Daha fazla bilgi için bkz. FixedFE bağlantılarını sorgulayın.

• Tipik FixedFE bağlantıları arasında holo-client, Flink konektörü ve DataWorks Data Integration'dan gelen Fixed Plan yazma işlemleri ve nokta sorguları ile Hologres V2.1'den başlayarak varsayılan olarak hafif bağlantılar kullanan ikili günlük tüketim bağlantıları yer alır.

• FixedFE bağlantıları teşhis amaçlı salt okunurdur: SQL ile bunları sonlandıramazsınız. FixedFE sınırına ulaşıldığında, istemci tarafındaki bağlantı havuzu yapılandırmasını kontrol edin veya etkilenen işi yeniden başlatın.

Sınıra ulaşıldığında aşağıdaki hata döndürülür:

FATAL: too many fixed frontend connections

Walsender bağlantı sınırı (max_wal_senders)

• Mantıksal çoğaltma bağlantılarına (replication=database) FE üzerindeki Walsender süreçleri hizmet verir. FE düğümü başına sınır max_wal_senders parametresi ile belirlenir ve varsayılan değeri 600'dür.

• Walsender bağlantıları max_connections değerinden bağımsızdır. Hiçbiri diğerini tüketmez.

Sınıra ulaşıldığında aşağıdaki hata döndürülür:

FATAL: number of requested standby connections exceeds max_wal_senders (currently 600)

Sınır özeti

pg_stat_activity görünümü, örnek bağlantıları ve sorguları hakkında çalışma zamanı bilgileri sağlar. Sorgulamak için aşağıdaki komutu çalıştırın.

select * from pg_stat_activity ;

Aşağıdaki tabloda pg_stat_activity alanları açıklanmaktadır.

Varsayılan bağlantı sınırı örnek teknik özelliklerine göre değişir. Sorgulamak için aşağıdaki komutları çalıştırın. Her komut, FE düğümü başına sınırı döndürür. Toplam örnek sınırını elde etmek için FE düğümü sayısıyla çarpın. FE düğümü sayıları Örnek yönetimi bölümünde listelenmiştir.

• Tüm örnek için maksimum bağlantı sayısını sorgulayın (Hologres V1.3.23 ve sonrası).

  select instance_max_connections();

• Tek bir FE düğümü için maksimum bağlantı sayısını sorgulayın. Toplam örnek sınırını elde etmek için FE düğümü sayısıyla çarpın.

  show max_connections;

HoloWeb konsolunda etkin bağlantıları görüntüleyin ve yönetin.

1. HoloWeb konsolunda oturum açın. HoloWeb'e bağlanın ve SQL sorguları çalıştırın.

2. Üst gezinme çubuğunda Diagnostics and Optimization öğesine tıklayın.

3. Sol gezinme bölmesinde Connections öğesine tıklayın.

4. Connections sayfasında, örneğiniz için bağlantıları ve ilgili bilgileri görüntülemek üzere parametreleri yapılandırın.

   Not

   Yalnızca Superuser'lar tüm bağlantıları görüntüleyebilir. Standart kullanıcılar yalnızca kendi bağlantılarını görür.

   Aşağıdaki tabloda parametreler açıklanmaktadır.

   Parametre	Açıklama
   Instance name	Hologres örnek adı.
   Database	Hologres veritabanı. Tüm veritabanlarına yönelik bağlantıları görüntülemek için boş bırakın.
   Database	Bağlı veritabanının adı. Not Veritabanı adı Postgres ise, bu bir arka plan bakım bağlantısını gösterir ve göz ardı edilebilir.
   User Name	Bağlantı için kullanılan kullanıcı hesabı.
   Client Address	Bu, orijinal kaynak IP değil, yönlendirilmiş bir giden IP adresi olabilir.
   Application Name	Bağlantıyı oluşturan uygulamanın adı.
   State	Bağlantının durumu. Yaygın durumlar şunları içerir: active: Bağlantı etkin. idle: Bağlantı boşta. idle in transaction: Bağlantı, uzun süren bir işlem içinde boşta. idle in transaction (Aborted): Bağlantı, başarısız bir işlem içinde boşta.
   Query Start	Sorgunun başlama zamanı.
   Query	Yürütülen sorgu. Not Uzun sorgular kısaltılabilir.
   PID	Sorgunun işlem kimliği (PID).
   Operation	Kill: Beklenmeyen bağlantıları tek tek veya toplu olarak sonlandırın. Details: Bağlantı hakkında ayrıntılı bilgileri görüntülemek için tıklayın.

-- List all FixedFE connections on the current FE node.
select * from hg_fixed_fe_stat_activity;

-- Count FixedFE connections to compare against the limit of 6,400.
select count(*) from hg_fixed_fe_stat_activity;

-- Group FixedFE connections by database, user, and application.
SELECT  datname
        ,usename
        ,application_name
        ,COUNT(1)
FROM    hg_fixed_fe_stat_activity
GROUP BY datname
         ,usename
         ,application_name;

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

select pg_cancel_backend(<pid>);     -- Cancels the query on the connection.
select pg_terminate_backend(<pid>);  -- Terminates the corresponding backend connection process.

-- Terminate backend IDLE connection processes in a batch to release connections.
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%';

Kullanıcı bağlantı sınırı ayarlayın

Aşırı kaynak tüketimini önlemek için kullanıcı başına bağlantı sınırı ayarlayın.

Tek bir erişim düğümünde bir kullanıcı için bağlantıları sınırlamak üzere aşağıdaki deyimi çalıştırın. Çok düğümlü örnekler için toplam sınır (düğüm başına bağlantı) * (düğüm sayısı) şeklindedir.

• Sözdizimi

  ALTER ROLE "Alibaba Cloud account ID" CONNECTION LIMIT <number>; 

• Parametreler

  Parametre	Açıklama
  Alibaba Cloud account ID	Sınırlandırılacak hesabın kimliği. Bir RAM kullanıcısı için hesap UID'sinin önüne p4_ ekleyin. Hesaba genel bakış.
  number	Bağlantı sınırı. Değer [-1, N] aralığında olmalıdır. -1 değeri, kullanıcının bağlantı sınırını kaldırır.

• Örnek

  Bu örnekte, RAM kullanıcısı 283813xxxx düğüm başına bir bağlantı ile sınırlandırılmaktadır.

  ALTER ROLE "p4_283813xxxx" CONNECTION LIMIT 1; 

Kullanıcı bağlantı sınırlarını görüntüleyin

Örnek kullanıcıları için düğüm başına bağlantı sınırlarını görüntülemek üzere aşağıdaki deyimi çalıştırın.

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

Örnek sorgu sonucu:

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

Hologres bağlantılarını kullanırken aşağıdaki en iyi uygulamaları takip edin.

• Superuser hesabını akıllıca kullanın

  • Uygulama bağlantıları veya normal işlemler için Superuser hesaplarını kullanmayın. Bağlantılar sınırı aşarsa, Superuser'lar bile bağlanamayabilir.

  • Bağlantı sınırı tükenmesi veya yanıt vermeyen sorgular gibi acil durumlar için özel bir Superuser hesabı oluşturun.

• Uygun bir bağlantı havuzu yapılandırın

  • Hologres, idle_session_timeout etkinleştirilmedikçe varsayılan olarak boşta kalan bağlantıları otomatik olarak sonlandırmaz. Boşta kalan bağlantıları hızlıca serbest bırakmak için bir bağlantı havuzu kullanın.

  • Kaynakları serbest bırakmak için boşta kalan bağlantıları periyodik olarak temizleyin.

  • holo-client ve Flink konektörü gibi Fixed Plan istemcilerinin bağlantı havuzunu da aynı özenle boyutlandırın. Bunlar düğüm başına 6.400'lük FixedFE kotasını tüketir ve buradaki bir sızıntı Fixed Plan yolunu bozar.

  • Bir ikili günlük tüketim işi yük devrettikten sonra, eski bağlantıların serbest bırakıldığını onaylayın; böylece eski bağlantılar FixedFE kotasını tüketmez. İkili günlük tüketimi, Hologres V2.1'den başlayarak varsayılan olarak hafif FixedFE bağlantılarını kullanır. Geleneksel Walsender çoğaltma protokolünü hala kullanıyorsanız, bunun yerine max_wal_senders kotasını izleyin.

• Bağlantı kullanımını katman katman izleyin

  • Erişim katmanı (Gateway): Konsoldaki Gateway Connection Usage ölçümünü izleyin.

  • FE katmanı: Her FE düğümünün doluluk seviyesi için hologres.hg_connections sorgulayın, ardından tek tek bağlantıları incelemek için pg_stat_activity kullanın.

  • FixedFE katmanı: hg_fixed_fe_stat_activity görünümünde Fixed Plan bağlantılarını sayın.

  • Walsender: İkili günlük tüketim bağlantılarını görmek için pg_stat_activity üzerinde backend_type = 'walsender' filtresini uygulayın.