RDS PostgreSQL升級核心小版本 - ApsaraDB RDS

雲資料庫RDS PostgreSQL提供核心小版本升級功能。通過升級，您將獲得包含效能提升、新功能支援和安全問題解決的最新版本，能夠確保資料庫服務的持續最佳化和安全。

RDS PostgreSQL核心小版本功能詳情請參見AliPG核心小版本發布記錄。

注意事項

升級核心小版本會重啟執行個體，RDS服務可能會出現一次30秒的閃斷，請您盡量在業務低峰期執行升級操作，或確保您的應用有自動重連機制。
升級核心小版本後無法降級。
小版本升級通常不會出現相容性問題，但因外掛程式的升級有可能會有相容性問題，如果涉及到外掛程式升級（如GanosBase外掛程式版本升級），建議先使用恢複PostgreSQL資料功能，在恢複的新執行個體上測試新版本外掛程式的相容性。
相關外掛程式升級注意事項：
- 如果您的業務已經使用了PostGIS或GanosBase外掛程式，在升級核心小版本後，還需要手動升級PostGIS或GanosBase外掛程式，升級方法，請參見時空引擎外掛程式升級。
- 如果您的執行個體大版本為PostgreSQL 14，在20230330核心小版本前已使用了TimescaleDB外掛程式（外掛程式版本小於等於2.5.0），在升級核心小版本到20230330或以上版本後，必須手動執行ALTER EXTENSION timescaledb UPDATE;命令進行手動升級外掛程式後，才能繼續使用TimescaleDB外掛程式。

查看核心小版本

您可以通過如下兩種方法查看執行個體當前的核心小版本。

登入RDS管理主控台，在目標執行個體的基本資料頁面查看。
說明
此方法僅適用於PostgreSQL雲端硬碟版執行個體。
串連目標PostgreSQL執行個體，通過show rds_release_date;命令查看。
說明
此方法適用於PostgreSQL雲端硬碟版和本地碟版執行個體。

手動升級核心小版本

本地碟執行個體升級核心小版本

本地碟執行個體暫不支援手動升級核心小版本。您可以通過重啟執行個體自動升級到最新的小版本。具體操作請參見重啟執行個體。

說明

如果當前執行個體為主執行個體，擁有隻讀執行個體，請先逐個重啟所有隻讀執行個體，再重啟主執行個體。如果只重啟主執行個體，則唯讀執行個體不會升級核心小版本。

雲端硬碟執行個體升級核心小版本

說明

如果當前執行個體為主執行個體，擁有隻讀執行個體，可以通過兩種方式進行升級。

對主執行個體發起核心小版本升級，該主執行個體下的所有隻讀執行個體都會先立即進行並發升級，然後再升級主執行個體。
如果您不希望所有隻讀執行個體立即升級，請先逐個升級所有隻讀執行個體，然後再升級主執行個體。

訪問RDS執行個體列表，在上方選擇地區，然後單擊目標執行個體ID。
在配置資訊地區中單擊升級核心小版本。
在彈出的對話方塊中，選擇可升級到版本和升級時間，單擊確定。
可升級到版本中各欄位含義：
- rds：RDS執行個體。
- postgres：PostgreSQL資料庫。
- 1200：PostgreSQL大版本為12。
- 20220830：AliPG核心小版本。各小版本的具體資訊，請參見AliPG核心小版本發布記錄。
- 12.11：PostgreSQL社區小版本號碼。

自動升級核心小版本

警告

自動升級僅為系統輔助升級手段，並不保證所有執行個體均能立即升級至最新核心版本。您可以在執行個體的基本資料頁查看核心版本狀態，並及時升級核心版本，以避免歷史核心版本可能存在的潛在風險。如您取消了系統下發的版本升級任務，或查看控制台版本升級提示後仍未及時升級至最新穩定版本，因此造成的業務中斷、資料丟失等損失和後果均由您承擔。詳情請參見服務合約。

購買RDS PostgreSQL雲端硬碟版執行個體時，預設選擇小版本升级策略為自动升级，當您的核心小版本低於最新核心小版本時，系統將會不定期地下發主動營運任務來升級核心小版本。任務資訊將通過郵件、站內信等渠道通知您。自動升級操作將會在您設定的可維護時間段內進行。您可以在事件管理中修改升級時間，或在任務開始前取消任務，詳情請參見計劃內事件。

說明

自動升級核心小版本功能僅支援雲端硬碟版執行個體。

image..png

修改自動升級設定

訪問RDS執行個體列表，在上方選擇地區，然後單擊目標執行個體ID。
在執行個體的基本資料頁的配置資訊地區查看小版本自動升級的設定情況。
單擊小版本自動升級右側的設定。
在彈出的對話方塊中，選擇自動升級或手動升級，然後單擊確定。

常見問題

升級核心小版本後，PostGIS和GanosBase外掛程式訪問出錯，如何處理？

在升級核心小版本後，還需要手動升級PostGIS或GanosBase外掛程式，升級方法，請參見時空引擎外掛程式升級。

PostGIS在升級核心小版本時有哪些相容性問題？

相容性差異如下表所示：

說明

核心小版本在20211031前的RDS PostgreSQL執行個體，可能會遇到如下相容性問題。

PostGIS外掛程式版本

只升級RDS PostgreSQL核心小版本

升級RDS PostgreSQL核心小版本 + 升級PostGIS外掛程式

2.5.x

使用如下函數時，可能導致資料庫崩潰
- ST_ClusterKMeans
- ST_GeomFromKML
- ST_AsKML
使用如下函數時，將會報錯
- ST_Buffer
  報錯：Invalid buffer parameter: uad_segs (accept: 'endcap', 'join', 'mitre_limit', 'miter_limit', 'quad_segs' and 'side')
  解決辦法：將quadsegs參數修改為quad_segs。
- ST_Intersects
  報錯：ERROR: GetGenericCacheCollection: Could not find upper context
  解決辦法：無。
如下函數將會被刪除，無法使用
- ST_Force_2D
- ST_Locate_Along_Measure
- ST_Estimated_Extent
如下函數的參數值或寫法將與升級前不一致
- ST_GeomFromGeoJSON：升級後會預設指定SRID=4326。
- ST_AsGeoJSON：maxdecimaldigits從16修改為9。
- MutliPoint寫法不一致：
  - 升級前：MULTIPOINT(1 1,-1 1)
  - 升級後：MULTIPOINT((1 1),(-1 1))

如下函數將會被刪除，無法使用
- ST_Force_2D
- ST_Locate_Along_Measure
- ST_Estimated_Extent
如下函數的參數值或寫法將與升級前不一致
- ST_GeomFromGeoJSON：升級後會預設指定SRID=4326。
- ST_AsGeoJSON：參數maxdecimaldigits從16修改為9。
- MutliPoint寫法不一致：
  - 升級前：MULTIPOINT(1 1,-1 1)
  - 升級後：MULTIPOINT((1 1),(-1 1))

3.1.x

使用如下函數時，可能導致資料庫崩潰
- ST_ClusterKMeans
MutliPoint寫法將與升級前不一致
- 升級前：MULTIPOINT(1 1,-1 1)
- 升級後：MULTIPOINT((1 1),(-1 1))

MutliPoint寫法將與升級前不一致

升級前：MULTIPOINT(1 1,-1 1)
升級後：MULTIPOINT((1 1),(-1 1))

API	描述
升級核心小版本	升級資料庫的核心小版本。
修改RDS升級核心小版本的方式	設定核心小版本升級策略為自動或手動。