ApsaraDB RDS:Introduction to the check report of a major engine version upgrade for an ApsaraDB RDS for PostgreSQL instance

Disk uyarısı

Uyarı formatı: Total disk space: {*} GB; Used disk: {*} GB; Used inodes: {*}; bytes-per-nodes: {*}; Minimum disk space required for upgrade: {*} GB

Neden: Örnekte çok fazla nesne bulunur; mevcut depolama alanı yükseltme için yetersizdir.

Çözüm:

• Mavi-yeşil dağıtım modu: Yeni örneğin depolama kapasitesini, yükseltme için gereken minimum disk alanına eşit veya daha büyük bir değere ayarlayın.

• Yerel yükseltme modu: Yükseltmeye başlamadan önce örneğin depolama kapasitesini, yükseltme için gereken minimum disk alanına eşit veya daha büyük bir değere genişletin. Daha fazla bilgi için bkz. Change the configuration.

Bellek uyarısı

Uyarı formatı: Current memory: {*} GB; Recommended memory: {*} GB; Minimum memory: {*} GB

Neden: Örnekte çok fazla nesne bulunur; mevcut bellek, yükseltme sırasında salt okunur süresini en aza indirmek için yetersizdir.

Çözüm:

• Mavi-yeşil dağıtım modu: Yeni örneğin teknik özelliklerini, belleğinin minimum bellek gereksinimini karşılayacak şekilde ayarlayın.

• Yerel yükseltme modu: Mevcut bellek önerilen bellek kapasitesinden azsa örnek teknik özelliklerini yükseltin. Daha fazla bilgi için bkz. Change the configuration.

Abonelik uyarısı

Uyarı formatı: The instance has replication slot subscribers. To prevent subscription data inconsistency, see the Alibaba Cloud documentation

Neden: Örnekte çoğaltma yuvası aboneleri bulunur. Kontrol etmek için aşağıdaki sorguyu çalıştırın:

SELECT * FROM pg_subscription;

Çözüm: Çoğaltma yuvası abonelerini yönetmek için Upgrade the database major version konusundaki adımları izleyin.

Dizi uyarısı (yalnızca sıfır kesinti modu)

Uyarı formatı: Total Sequence tables: {0}. Too many Sequence tables will extend the switchover time for logical replication major version upgrade.

Neden: Örnek diziler içerir. Bunları listelemek için aşağıdaki sorguyu çalıştırın:

SELECT * FROM pg_sequences;

Çözüm: Örnekte çok sayıda dizi varsa üretim ortamını yükseltmeden önce gerçek geçiş süresini ölçmek için örneği klonlayın ve bir test yükseltmesi çalıştırın.

Hesap hatası

Hata formatı: Invalid superuser account: {*}; Invalid account: {*}; Please see the Alibaba Cloud documentation

Neden: Örnekte yedek süper kullanıcı hesapları veya geçersiz şifreleme yapılandırmalarına sahip standart hesaplar bulunur.

Çözüm:

• Yedek süper kullanıcı hesapları: Silme talebinde bulunmak için bir ticket gönderin.

• Geçersiz standart hesaplar: Etkilenen hesapların parolalarını sıfırlayın.

Ön kontrol hatası

Hata formatı: pg_upgrade pre-check task failed, need to check [pg_upgrade error log] and [pg_upgrade-related files and errors]

Neden: pg_upgrade ön kontrolü başarısız oldu.

Çözüm: Belirli sorunu belirlemek ve çözmek için kontrol raporunun pg_upgrade hata günlüğü bölümünü inceleyin.

pgcrypto eklenti hatası

Hata formatı: The pg_crypto extension is installed in schema: pg_catalog in database: {*}, please see the Alibaba Cloud documentation

Neden: pgcrypto eklentisi, yalnızca daha sonraki PostgreSQL sürümlerinde bulunan işlevleri pg_catalog içinde oluşturur. Bu durum büyük motor sürümü yükseltmesinin başarısız olmasına neden olur.

Çözüm: Etkilenen her veritabanında pgcrypto eklentisini kaldırın ve pg_catalog dışındaki bir şemada yeniden oluşturun.

Küçük sürüm hatası (yalnızca sıfır kesinti modu)

Hata formatı: Zero-downtime major version upgrade requires minimum minor version 20250228

Neden: Örneğin küçük motor sürümü 20250228 tarihinden eskidir.

Çözüm: Küçük motor sürümünü 20250228 veya daha yenisine Upgrade the minor engine version konusundaki adımları izleyerek yükseltin.

loadable_libraries.txt: uyumsuz eklentiler

loadable_libraries.txt dosyası, hedef PostgreSQL sürümü tarafından yüklenemeyen kitaplık dosyalarını listeler. Her kitaplık genellikle bir eklentiye karşılık gelir.

Neden: Yüklü bir veya daha fazla eklenti hedef büyük motor sürümüyle uyumsuzdur.

Çözüm: loadable_libraries.txt içinde listelenen eklentileri kontrol edin. Her eklenti için uygulamanızın buna bağlı olup olmadığını doğrulayın; ardından yükseltmeden önce kaldırıp kaldırmayacağınıza karar verin. Her sürümde desteklenen eklentilerin listesi için bkz. Supported extensions.

Aşağıdaki bölümlerde en yaygın uyumsuz eklentiler açıklanmaktadır.

tables_with_oids.txt: OID'li tablolar

tables_with_oids.txt dosyası, WITH OIDS bildirimiyle oluşturulan tabloları listeler. PostgreSQL 12 ve sonraki sürümler WITH OIDS ifadesini desteklemez.

Neden: Bir veya daha fazla tablo, hedef sürümde desteklenmeyen WITH OIDS bildirimini kullanır.

Çözüm:

• Seçenek 1 (önerilen): WITH OIDS ifadesini hala destekleyen PostgreSQL 11'e yükseltin.

• Seçenek 2: tables_with_oids.txt içinde listelenen tabloları gözden geçirin ve uygulamanızın OID değerlerine bağlı olmadığını doğrulayın. Ardından etkilenen her tablo için aşağıdaki ifadeyi çalıştırın:

  ALTER TABLE {table_name} SET WITHOUT OIDS;

Yabancı tablolar

Hata formatı: Foreign tables in database: {0}. Total databases: {1}

Neden: Örnek, mantıksal çoğaltmanın çoğaltamadığı yabancı tablolar içerir.

Çözüm: Tüm yabancı tabloları kaldırın.

1. Her veritabanında yabancı tabloları belirleyin:

   SELECT COUNT(*) AS count, relkind
   FROM pg_class
   WHERE relkind IN ('f')
   GROUP BY relkind;

2. Yabancı tabloları kaldırın:

   DROP FOREIGN TABLE [ IF EXISTS ] name [ CASCADE | RESTRICT ];

Daha fazla bilgi için PostgreSQL documentation on DROP FOREIGN TABLE adresine bakın.

Birincil anahtarı veya benzersiz anahtarı olmayan tablolar

Hata formatı: Tables without primary key or unique key in database: {0}. Total databases: {1}

Neden: Mantıksal çoğaltma, çoğaltma sırasında satırları tanımlamak için her tablonun bir birincil anahtara, benzersiz anahtara veya REPLICA IDENTITY FULL ayarına sahip olmasını gerektirir.

Çözüm: Etkilenen her tabloya bir birincil anahtar veya benzersiz anahtar ekleyin ya da REPLICA IDENTITY FULL ayarını yapın.

1. Her veritabanında birincil anahtarı veya benzersiz anahtarı olmayan tabloları belirleyin:

   SELECT COUNT(*) AS count
   FROM information_schema.tables t
   LEFT JOIN information_schema.table_constraints tc
       ON t.table_name = tc.table_name
       AND t.table_schema = tc.table_schema
       AND (tc.constraint_type = 'PRIMARY KEY' OR tc.constraint_type = 'UNIQUE')
   JOIN pg_class c
       ON t.table_name = c.relname
   JOIN pg_namespace ns
       ON c.relnamespace = ns.oid
       AND ns.nspname = t.table_schema
   WHERE t.table_type = 'BASE TABLE'
       AND tc.constraint_type IS NULL
       AND t.table_schema NOT IN ('pg_catalog', 'information_schema')
       AND c.relreplident != 'f';

2. Tabloda REPLICA IDENTITY FULL ayarını yapın (anahtar eklemek mümkün değilse):

   ALTER TABLE name REPLICA IDENTITY FULL;

3. Veya bir birincil anahtar veya benzersiz anahtar ekleyin:

   -- Primary key
   ALTER TABLE name
       ADD CONSTRAINT constraint_name PRIMARY KEY (column_name);
   
   -- Unique key
   ALTER TABLE name
       ADD CONSTRAINT constraint_name UNIQUE (column_name);

Daha fazla bilgi için PostgreSQL documentation on unique constraints adresine bakın.

Materyalize edilmiş görünümler

Hata formatı: Materialized views in database: {0}. Total databases: {1}

Neden: Mantıksal çoğaltma materyalize edilmiş görünümleri çoğaltamaz.

Çözüm: Tüm materyalize edilmiş görünümleri kaldırın.

1. Her veritabanında materyalize edilmiş görünümleri belirleyin:

   SELECT COUNT(*) AS count, relkind
   FROM pg_class
   WHERE relkind IN ('m')
   GROUP BY relkind;

2. Materyalize edilmiş görünümleri kaldırın:

   DROP MATERIALIZED VIEW IF EXISTS name;

Büyük nesneler

Hata formatı: Large objects in database: {0}. Total databases: {1}

Neden: Mantıksal çoğaltma, pg_largeobject içinde depolanan büyük nesneleri çoğaltamaz.

Çözüm: Büyük nesneleri kaldırın.

1. Her veritabanında büyük nesneleri sayın:

   SELECT COUNT(*) AS count
   FROM pg_largeobject_metadata;

2. Her büyük nesneyi kaldırın:

   SELECT lo_unlink(largeobject_oid);

Yasaklanmış eklentiler

Hata formatı: Logical replication prohibited extensions in database: {0}. Total databases: {1}

Neden: Aşağıdaki eklentiler mantıksal çoğaltmayla uyumsuzdur ve sıfır kesinti yükseltmesi sırasında mevcut olamaz: pg_partman, pg_cron, pg_active ve pglogical.

Çözüm: Uyumsuz eklentileri geçici olarak kaldırın.

1. Her veritabanında yasaklanmış herhangi bir eklentinin yüklü olup olmadığını kontrol edin:

   SELECT COUNT(*) AS count
   FROM pg_extension
   WHERE extname IN ('pg_partman', 'pg_cron', 'pg_active', 'pglogical');

2. Her yasaklanmış eklentiyi kaldırın:

   DROP EXTENSION extension_name;

Parametre gereksinimleri karşılanmadı

Hata formatı: Logical replication requires wal_level to be logical, max_wal_sender and max_replication_slots to be at least {0}, instance wal_level is: {1}, max_wal_sender is: {2}, max_replication_slots is: {3}

Neden: Aşağıdaki parametrelerden biri veya daha fazlası mantıksal çoğaltma gereksinimlerini karşılamıyor: wal_level, max_wal_sender veya max_replication_slots.

Çözüm: Parametre değerlerini güncelleyin. Bazı değişikliklerin etkili olması için yeniden başlatma gerekir. Daha fazla bilgi için bkz. Set the parameters of an instance.