全部產品
Search
文件中心

ApsaraDB for ClickHouse:通過遷移升級核心大版本

更新時間:Jun 30, 2024

核心大版本的升級涉及效能提升、新功能和問題修複等。本文介紹如何通過叢集間的資料移轉升級核心大版本。

前提條件

  • 源叢集和目的地組群均為社區相容版叢集。

  • 源叢集和目的地組群已具備資料庫帳號和密碼。

  • 源叢集和目的地組群的副本需一致。

  • 源叢集和目的地組群需在同一地區,且使用相同的VPC。

  • 源叢集和目的地組群的冷熱分層狀態需一致。

  • 源叢集的所有本地表都需要具有唯一的分布式表。

  • 目的地組群的磁碟使用率需大於等於源叢集的磁碟使用率的1.2倍。

  • 已將源叢集的IP地址添加到目的地組群的白名單中。

  • 已將目的地組群的IP地址添加到源叢集的白名單中。

說明

您可以通過select * from system.clusters;查看雲資料庫ClickHouse執行個體的IP地址。如何設定白名單,請參見設定白名單

注意事項

  • 升級核心大版本後不支援降級核心大版本。

  • 遷移發起時,源叢集和目的地組群不能有正在啟動並執行管控任務(包含擴容,升降配等)。

  • 雲資料庫ClickHouse叢集間的資料移轉支援全量遷移和增量遷移。

  • 非MergeTree類型的表(例如,外表、Log表等)僅支援遷移表結構。因此當源叢集存在非MergeTree類型的表時,若您使用資料移轉功能,目的地組群中非MergeTree類型的表只有表結構沒有具體的業務資料。

  • 升級核心大版本後會造成用戶端串連資料庫服務失敗,請務必修改用戶端的串連地址。

升級核心大版本的影響

  • 20.8及以上版本的叢集在通過資料移轉升級核心大版本時,源叢集在遷移過程中可讀可寫,為保證遷移任務儘快完成,建議在遷移任務完成95%左右時主動暫停資料寫入;20.3及以下版本的叢集在通過資料移轉升級核心大版本時,源叢集在遷移過程中可讀不可寫,直到遷移完成。

  • 目的地組群在遷移過程中不可讀寫,直到遷移完成。

版本支援

源叢集的核心版本支援如下升級。

源叢集的核心版本

可升級到的核心版本

19.15

21.8、22.8

20.3

21.8、22.8

20.8

21.8、22.8

21.8

22.8

步驟一:建立目的地組群

建立一個高版本的社區相容版叢集。支援的版本號碼和建立社區兼版叢集的操作步驟,請參見版本支援建立叢集

步驟二:將資料移轉至目的地組群

重要

此操作需要登入目的地組群,而非源叢集。

  1. 登入ClickHouse控制台

  2. 叢集列表頁面,選擇預設執行個體列表,單擊目的地組群ID。

  3. 單擊左側導覽列的執行個體遷移

  4. 執行個體遷移頁面,單擊建立遷移任務

    執行個體遷移

    說明

    如果當前叢集沒有遷移記錄,則顯示沒有資料

  5. 進入到任務配置環節,選擇源執行個體ID,並分別填寫源叢集和目的地組群的資料庫帳號資料庫密碼

    選擇源及目標執行個體

  6. 單擊測試連接以進行下一步,進行叢集的連通性校正。

    • 測試連接成功,進行下一步。

    • 測試連接失敗。如果提示的錯誤資訊為Source instance account or password error.時,請重新填寫正確的資料庫帳號資料庫密碼

  7. 測試連接成功後,進入遷移內容確認環節。單擊下一步:預檢測並啟動同步

    遷移內容配置

    說明

    源叢集可遷移內容包含:叢集、庫、表、資料字典、物化視圖、使用者權限和叢集配置。

  8. 遷移任務配置完成後,後台進行遷移鏈路預檢測並啟動任務。

    • 校正成功,單擊完成

    • 校正失敗,您需要按照提示資訊進行操作,重新進行資料移轉。檢測專案及要求如下。

      檢測專案

      檢測要求

      執行個體狀態檢測

      遷移發起時,源叢集和目的地組群不能有正在啟動並執行管控任務(包含擴容,升降配等)。如果當前源執行個體和目的執行個體有管控任務正在運行,則不能發起遷移任務。

      儲存空間檢測

      遷移同步進行前,進行儲存空間校正。保證目的地組群的磁碟使用率大於等於源叢集的磁碟使用率的1.2倍。

      本地表和分布式表檢測

      如果存在本地表沒有建立分布式表或者分布式表不唯一,則校正失敗。請刪除多餘的分布式表。

  9. 遷移任務完成後,在執行個體遷移頁面查看遷移任務。

    遷移任務管理

    說明

    當遷移任務的遷移狀態已完成時,說明源叢集的資料已成功遷移至目的地組群。

步驟三:刪除源叢集

刪除源叢集的具體操作,請參見刪除叢集

警告

源叢集刪除後,源叢集的所有資料都會被刪除無法找回,請在目的地組群中檢測源叢集的業務資料是否全部遷移至目的地組群。