本文由簡體中文內容自動轉碼而成。阿里雲不保證此自動轉碼的準確性、完整性及時效性。本文内容請以簡體中文版本為準。

建立PolarDB-X 1.0資料訂閱任務

更新時間:2025-03-12 20:29
重要

本文中含有需要您注意的重要提示訊息,忽略該訊息可能對您的業務造成影響,請務必仔細閱讀。

本文介紹如何建立PolarDB-X 1.0資料訂閱任務。

前提條件

注意事項

類型

說明

類型

說明

源庫限制

  • 待訂閱的表需具備主鍵或唯一約束(僅具有唯一約束的表不支援訂閱結構更新,建議使用主鍵約束),且欄位具有唯一性,否則可能會導致訂閱到的重複資料

  • 如訂閱對象為表層級,則單次訂閱任務僅支援至多500張表。當超出數量限制,任務提交後會顯示請求報錯,此時建議您拆分待訂閱的表,配置多個訂閱任務,或者配置整庫的訂閱任務。

  • PolarDB-X 1.0下面掛載的RDS MySQL的Binlog日誌:

    • 需開啟,並且binlog_row_image為full。否則預檢查階段提示報錯,且無法成功啟動資料訂閱任務。

    • DTS要求來源資料庫的本地Binlog日誌儲存24小時以上,否則DTS可能因無法擷取Binlog而導致任務失敗,極端情況下甚至可能會導致資料不一致或丟失。由於您所設定的Binlog日誌儲存時間低於DTS要求的時間進而導致的問題,不在DTS的SLA保障範圍內。

  • 若源執行個體為唯讀執行個體或臨時執行個體,您需確保該執行個體有記錄事務的日誌。

    說明
    • RDS MySQL執行個體可以在RDS控制台,查看該執行個體是否為唯讀執行個體臨時執行個體

    • 在自建MySQL資料庫中執行SHOW VARIABLES LIKE 'read_only';命令,若返回結果為ON,即表示該資料庫為唯讀執行個體。

  • PolarDB-X 1.0執行個體的版本需為5.2及以上版本。

其他限制

  • DTS基於源PolarDB-X 1.0執行個體中XA事務的連續性,以確保可以成功訂閱到資料變更資訊。若XA事務的連續性遭到破壞(包括但不限於修改訂閱對象、增量資料擷取模組容災等情境),則未提交的XA事務可能會丟失。

  • 由於PolarDB-X 1.0的訂閱任務為分布式訂閱,其下掛的一個RDS MySQL對應一個訂閱子任務。子任務運行情況,可在任務拓撲進行查詢。

  • 由於PolarDB-X 1.0支援分庫分表,源PolarDB-X 1.0的某一DDL指令會在所有分表上執行對應的DDL操作,並且每個訂閱子任務的進度並不一致,因此DTS的訂閱資料可能陸續包含多條此DDL操作,如您多次消費此類DDL操作,可能會導致訂閱用戶端資料異常,建議您視具體情況處理。

  • 訂閱對象說明:

    • 不支援整庫訂閱,只支援表層級訂閱。

    • 訂閱任務配置完成後,不支援修改訂閱對象,如果需要新增訂閱的表,需要建立訂閱任務。

  • 在訂閱時,如果源庫進行主備切換,將會導致訂閱任務失敗。

  • 在訂閱期間,請勿對源執行個體執行擴容、縮容、遷移熱點表、變更拆分鍵操作和變更DDL等操作,否則資料訂閱任務會失敗,或者資料不一致。

  • 如果訂閱的來源資料庫還處於其他任務中(例如該資料庫還存在於某個正在啟動並執行資料移轉任務中),您可能會訂閱到訂閱對象以外的資料,此類情境中,您需要手動在訂閱用戶端中過濾掉不需要的資料。

  • 若您訂閱的單行資料超過16MB,則不支援消費,否則可能會導致消費用戶端記憶體OOM(Out of Memory)。

  • 請確認DTS對資料類型為FLOAT或DOUBLE的列的訂閱精度是否符合業務預期。DTS會通過ROUND(COLUMN,PRECISION)來讀取這兩類列的值。如果沒有明確定義其精度,DTS對FLOAT的訂閱精度為38位,對DOUBLE的訂閱精度為308位。

  • 由於使用pt-online-schema-change等類似工具執行線上DDL變更不會被訂閱到,用戶端在將消費到的資料寫入目標表時可能會因為表結構不一致而導致寫入失敗。

  • 若執行個體運行失敗,DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中,可能會對該執行個體進行重啟、調整參數等操作。

    說明

    在調整參數時,僅會修改執行個體的參數,不會對資料庫中的參數進行修改。

操作步驟

  1. 進入目標地區的訂閱任務的列表頁面(二選一)。

    通過DTS控制台進入
    通過DMS控制台進入
    1. 登入Data Transmission Service控制台

    2. 在左側導覽列,單擊數據訂閱

    3. 在頁面左上方,選擇訂閱執行個體所屬地區。

    說明

    實際操作可能會因DMS的模式和布局不同,而有所差異。更多資訊。請參見極簡模式控制台自訂DMS介面布局與樣式

    1. 登入Data Management服務

    2. 在頂部功能表列中,選擇整合與開發 > 資料轉送(DTS) > 資料訂閱

    3. 訂閱任務右側,選擇訂閱執行個體所屬地區。

  2. 單擊創建任務,進入任務配置頁面。

  3. 可選:在頁面右上方,單擊試用新版配置頁

    說明
    • 若您已進入新版配置頁(頁面右上方的按鈕為返回舊版配置頁),則無需執行此操作。

    • 新版配置頁和舊版配置頁部分參數有差異,建議使用新版配置頁。

  4. 配置源庫及消費網路類型。

    警告

    選擇源執行個體後,建議您仔細閱讀頁面上方顯示的使用限制,否則可能會導致任務失敗或無法消費訂閱資料。

    類別

    配置

    說明

    類別

    配置

    說明

    任務名稱

    DTS會自動產生一個訂閱名稱,建議配置具有業務意義的名稱(無唯一性要求),便於後續識別。

    源庫資訊

    選擇已有串連資訊

    您可以按實際需求,選擇是否使用已有資料庫執行個體。

    • 如使用已有執行個體,下方資料庫資訊將自動填入,您無需重複輸入。

    • 如不使用已有執行個體,您需要配置下方的資料庫資訊。

    說明
    • 您可以在資料連線管理頁面或新版配置頁面,將資料庫錄入DTS。更多資訊,請參見資料連線管理

    • DMS控制台的配置項為選擇DMS資料庫執行個體,您可以單擊新增DMS資料庫執行個體或在控制台首頁將資料庫錄入DMS。更多資訊,請參見雲資料庫錄入他雲/自建資料庫錄入

    資料庫類型

    選擇PolarDB-X 1.0

    接入方式

    固定為雲執行個體

    執行個體地區

    選擇PolarDB-X 1.0執行個體所屬地區。

    是否跨阿里雲帳號

    本樣本選擇不跨帳號

    重要

    若您需要跨帳號訪問源庫資源(選擇跨帳號),請為建立DTS任務的阿里雲帳號配置RAM授權,並填入跨阿里雲帳號跨阿里雲帳號角色名稱。配置RAM授權的操作,請參見跨阿里雲帳號任務如何配置RAM授權

    執行個體ID

    選擇PolarDB-X 1.0執行個體ID。

    資料庫帳號

    填入PolarDB-X 1.0資料庫帳號,具備帶訂閱對象的讀許可權。

    資料庫密碼

    填入該資料庫帳號對應的密碼。

    消費網路類型

    網路類型

    資料訂閱執行個體的網路類型固定為專用網路,您需要選擇具體的專用網路虛擬交換器。更多資訊請參見專用網路

    說明
    • 任務建立成功後,消費網路類型不可更改。

    • 若您的資料訂閱用戶端部署在專用網路上,則建議選擇與用戶端一致的專用網路虛擬交換器

    • 通過內網地址進行資料訂閱時,網路延遲最小。

  5. 配置完成後,在頁面下方單擊測試連接以進行下一步

    說明

    請確保DTS服務的IP位址區段能夠被自動或手動添加至源庫的安全設定中,以允許DTS伺服器的訪問。更多資訊,請參見添加DTS伺服器的IP位址區段

  6. 配置任務對象。

    1. 對象配置頁面,配置待訂閱的對象。

      配置

      說明

      配置

      說明

      需要訂閱的資料類型

      需要訂閱的資料類型預設已勾選,且不支援修改。

      • 資料更新

        訂閱已選擇對象的增量資料更新,包含資料的INSERT、DELETE和UPDATE操作。

      • 結構更新

        訂閱整個執行個體所有對象的結構建立、刪除及修改,您需要使用資料訂閱用戶端過濾所需的資料。

      源庫對象

      源庫對象列表中,選擇待訂閱對象,單擊表徵圖向右小箭頭,將其移動到已選擇對象列表中。

      說明
      • 不支援整庫訂閱,只支援表層級訂閱。

      • 訂閱任務配置完成後,不支援修改訂閱對象,如果需要新增訂閱的表,需要建立訂閱任務。

    2. 單擊下一步高級配置,進行進階參數配置。

      配置

      說明

      配置

      說明

      選擇調度該任務的專屬叢集

      DTS預設將任務調度到共用叢集上,您無需選擇。您可以購買指定規格的專屬叢集來運行DTS訂閱任務,詳情請參見什麼是DTS專屬叢集

      源庫、目標庫無法串連後的重試時間

      在訂閱任務串連失敗時,DTS會立即進行持續的重試串連,預設持續重試時間為720分鐘,您也可以在取值範圍(10~1440分鐘)內自訂重試時間,建議設定30分鐘以上。如果DTS在設定的時間內重新串連上源庫,訂閱任務將自動回復。否則,訂閱任務將失敗。

      說明
      • 針對相同源庫的多個DTS執行個體,如DTS執行個體A和DTS執行個體B,設定網路重試時間時A設定30分鐘,B設定60分鐘,則重試時間以低的30分鐘為準。

      • 由於串連重試期間,DTS將收取任務運行費用,建議您根據業務需要自訂重試時間,或者在源庫釋放後儘快釋放DTS執行個體。

      源庫、目標庫出現其他問題後的重試時間

      在訂閱任務啟動後,若源庫出現非串連性的其他問題(如DDL或DML執行異常),則DTS會報錯並會立即進行持續的重試操作,預設持續重試時間為10分鐘,您也可以在取值範圍(1~1440分鐘)內自訂重試時間,建議設定10分鐘以上。如果DTS在設定的重試時間內相關操作執行成功,訂閱任務將自動回復。否則,訂閱任務將會失敗。

      重要

      源庫、目標庫出現其他問題後的重試時間的值需要小於源庫、目標庫無法串連後的重試時間的值。

      環境標籤

      您可以根據實際情況,選擇用於標識執行個體的環境標籤。本樣本無需選擇。

      監控警示

      是否設定警示,當訂閱失敗或延遲超過閾值後,將通知警示連絡人。

  7. 儲存任務並進行預檢查。

    • 若您需要查看調用API介面配置該執行個體時的參數資訊,請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上,然後單擊氣泡中的預覽OpenAPI參數

    • 若您無需查看或已完成查看API參數,請單擊頁面下方的下一步儲存任務並預檢查

    說明
    • 在訂閱任務正式啟動之前,會先進行預檢查。只有預檢查通過後,才能成功啟動訂閱任務。

    • 如果預檢查失敗,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

    • 如果預檢查產生警告:

      • 對於不可以忽略的檢查項,請單擊失敗檢查項後的查看詳情,並根據提示修複後重新進行預檢查。

      • 對於可以忽略無需修複的檢查項,您可以依次單擊點擊確認警示詳情確認屏蔽確定重新進行預檢查,跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項,可能會導致資料不一致等問題,給業務帶來風險。

  8. 購買執行個體。

    1. 預檢查通過率顯示為100%時,單擊下一步購買

    2. 購買頁面,選擇資料訂閱執行個體的計費方式,詳細說明請參見下表。

      參數

      說明

      參數

      說明

      計費方式

      • 預付費(訂用帳戶):在建立執行個體時支付費用。適合長期需求,價格比隨用隨付更實惠,且購買時間長度越長,折扣越多。

      • 後付費(隨用隨付):按小時計費。適合短期需求,用完可立即釋放執行個體,節省費用。

      資源群組配置

      執行個體所屬的資源群組,預設為default resource group。更多資訊,請參見什麼是資源管理

      訂閱時間長度

      在預付費模式下,選擇訂用帳戶執行個體的時間長度和數量,包月可選擇1~9個月,包年可選擇1年、2年、3年和5年。

      說明

      該選項僅在付費類型為預付費時出現。

    3. 配置完成後,閱讀並勾選《資料轉送(隨用隨付)服務條款》

    4. 單擊購買並啟動,訂閱任務正式開始,您可在工作清單查看具體任務進度。

後續步驟

成功運行訂閱任務後,您需要新增消費組,並根據下遊用戶端選擇訂閱資料消費方式。

  1. 消費組的建立和管理,請參見新增消費組

  2. 根據消費用戶端類型,選擇訂閱資料的消費方式:

  • 本頁導讀 (1, M)
  • 前提條件
  • 注意事項
  • 操作步驟
  • 後續步驟
文檔反饋