全部產品
Search
文件中心

Data Transmission Service:建立PolarDB PostgreSQL版資料訂閱任務

更新時間:Feb 11, 2025

本文為您介紹如何建立PolarDB PostgreSQL版資料訂閱任務。

前提條件

注意事項

類型

說明

源庫限制

  • 待訂閱的表需具備主鍵或唯一約束,且欄位具有唯一性,否則可能會導致訂閱到的重複資料。

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

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

  • 需開啟WAL日誌,即設定wal_level參數的值為logical,即在預寫式日誌WAL(Write-ahead logging)中增加支援邏輯編碼所需的資訊。設定方式請參見設定叢集參數

    說明

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

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

  • 由於源庫的邏輯訂閱本身存在使用限制,在訂閱執行個體運行期間,若源庫訂閱的單條資料在更新後超過256 MB,則可能會導致訂閱執行個體運行失敗且無法恢複,您需要重新設定訂閱執行個體。

其他限制

  • 單個資料訂閱任務只能訂閱一個資料庫,如需訂閱多個資料庫,您需要為每個資料庫配置資料訂閱任務。

  • 為保障訂閱延遲時間展示的準確性,DTS會在源庫中新增一個名為dts_postgres_heartbeat的心跳錶。

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

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

  • 帶時區的時間類型,預設會轉換為對應UTC+8時區的時間。

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

    說明

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

操作步驟

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

    通過DTS控制台進入

    1. 登入Data Transmission Service控制台

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

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

    通過DMS控制台進入

    說明

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

    1. 登入Data Management服務

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

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

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

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

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

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

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

    警告

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

    類別

    配置

    說明

    任務名稱

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

    源庫資訊

    選擇已有串連資訊

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

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

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

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

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

    資料庫類型

    選擇PolarDB for PostgreSQL

    接入方式

    選擇雲執行個體

    執行個體地區

    選擇PolarDB PostgreSQL版所屬地區。

    是否跨阿里雲帳號

    本樣本選擇不跨帳號

    重要

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

    執行個體ID

    選擇PolarDB PostgreSQL版執行個體ID。

    資料庫名稱

    填入待訂閱的資料庫名稱。

    資料庫帳號

    填入PolarDB PostgreSQL版資料庫的高許可權帳號。

    資料庫密碼

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

    消費網路類型

    網路類型

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

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

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

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

  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. 根據消費用戶端的類型,選擇訂閱資料的消費方式: