如何使用flink-dts-connector檔案 - Data Transmission Service

完成資料訂閱通道的配置後，您可以使用flink-dts-connector檔案消費通道中的資料，用於Flink用戶端消費。本文介紹如何flink-dts-connector檔案的使用說明。

注意事項

僅支援Flink用戶端使用DataStream API、Table API和SQL。
如您的Flink用戶端使用Table API和SQL，則單次配置時僅支援消費單張表的資料，如需消費多張表的資料，您需進行多次配置獨立的任務。

操作步驟

本文以IntelliJ IDEA軟體（Community Edition 2020.1 Windows版本）為例，介紹如何使用flink-dts-connector檔案來消費訂閱通道中的資料。

建立新版資料訂閱通道，詳情請參見訂閱者案概覽中的相關配置文檔。
建立一個或多個消費組，詳情請參見新增消費組。
下載flink-dts-connector檔案並解壓。
運行IntelliJ IDEA工具，然後單擊Open or Import。
在彈出的對話方塊中，定位至flink-dts-connector檔案所在目錄，依次展開檔案夾，找到專案物件模型檔案：pom.xml。
在彈出對話方塊中，選擇Open as Project。

在pom.xml檔案中添加如下依賴：

<dependency>
      <groupId>com.alibaba.flink</groupId>
      <artifactId>flink-dts-connector</artifactId>
      <version>1.1.1-SNAPSHOT</version>
      <classifier>jar-with-dependencies</classifier>
</dependency>

在IntelliJ IDEA軟體介面，依次展開檔案夾，並根據您所使用的Flink Connector的程式類型，選擇對應的Java檔案。
- 如Flink用戶端類型為DataStream API，您需雙擊開啟flink-dts-connector-master\src\test\java\com\alibaba\flink\connectors\dts\datastream\DtsExample.java檔案，並執行如下操作：
  1. 在IntelliJ IDEA軟體介面的頂部，單擊如下表徵圖。
  2. 在彈跳框中單擊DtsExample > Edit。
  3. 在彈跳框的Program arguments中，按如下樣本輸入參數及對應的值，並單擊下方的Run，啟動flink-dts-connector。
    說明
    具體參數說明及查詢方式，請參見參數說明。
```
--broker-url dts-cn-******.******.***:****** --topic cn_hangzhou_rm_**********_dtstest_version2 --sid dts****** --user dtstest --password Test123456 --checkpoint 1624440043
```
  4. 運行結果如下圖所示，該用戶端可正常訂閱到源庫的資料變更資訊。
    說明
    如需查詢資料變更的具體記錄，您可登入Flink用戶端的Task Manager介面進行查看。
- 如Flink用戶端類型為Table API和SQL，您需雙擊開啟flink-dts-connector-master\src\test\java\com\alibaba\flink\connectors\dts\sql\DtsTableISelectTCaseTest.java檔案，並執行如下操作：
  說明
  單個DtsTableISelectTCaseTest.java檔案，僅支援配置並消費單張表的訂閱資料。如需配置並消費多張表中的資料，您需要重複配置，並運行多個獨立任務。
  1. 在如下位置添加前置字元//，注釋該行代碼資訊。
  2. 設定所需消費的單張表的資訊，支援使用SQL語句。
  3. 設定訂閱通道參數，具體參數說明及查詢方式，請參見參數說明。
  4. 在IntelliJ IDEA軟體介面的頂部，單擊Run'DtsTableISelectTCaseTest'，啟動flink-dts-connector。
  5. 運行結果如下圖所示，該用戶端可正常訂閱到源庫的資料變更資訊。
    說明
    如需查詢資料變更的具體記錄，您可登入Flink用戶端的Task Manager介面進行查看。

參數說明

DstExample檔案中的參數	DtsTableISelectTCaseTest檔案中的參數	說明	查詢方式
`broker-url`	`dts.server`	資料訂閱通道的網路地址及連接埠號碼資訊。說明如果您部署的Flink所屬的ECS執行個體與資料訂閱通道屬於傳統網路或同一專用網路，建議通過內網地址進行資料訂閱，網路延遲最小。不建議使用公網地址。	在DTS控制台單擊目標訂閱執行個體ID，在基本資料頁面，您可以擷取到訂閱Topic和網路資訊。
`topic`	`topic`	資料訂閱通道的訂閱Topic。	在DTS控制台單擊目標訂閱執行個體ID，在基本資料頁面，您可以擷取到訂閱Topic和網路資訊。
`sid`	`dts.sid`	消費組ID。	在DTS控制台單擊目標訂閱執行個體ID，然後單擊左側導覽列的數據消費，您可以擷取到消費組ID/名稱和消費組的帳號資訊。說明消費組帳號的密碼已在您建立消費組時指定。
`user`	`dts.user`	消費組的帳號。警告如您未使用本文提供的flink-dts-connector檔案，請按照`<消費組的帳號>-<消費組ID>`的格式設定使用者名稱（例如：`dtstest-dtsae******bpv`），否則無法正常串連。
`password`	`dts.password`	該帳號的密碼。
`checkpoint`	`dts.checkpoint`	消費位點，即flink-dts-connector消費第一條資料的時間戳記，格式為Unix時間戳記，例如1624440043。說明消費位點資訊可用於：當業務程式中斷後，傳入已消費位點繼續消費資料，防止資料丟失。在訂閱用戶端啟動時，傳入所需的消費位點，調整訂閱位點，實現按需消費資料。	消費的資料時間點必須在訂閱執行個體的資料範圍之內，並需轉化為Unix時間戳記。說明您可以在訂閱工作清單的數據範圍列，查看訂閱執行個體的資料範圍。 Unix時間戳記轉換工具可用搜尋引擎擷取。
無	`dts-cdc.table.name`	訂閱對象。僅支援傳入單張表，且格式要求為如下：當資料庫類型為MySQL、PolarDB for MySQL、PolarDB-X 1.0、PolarDB-X 2.0時：格式為`<資料庫名稱>.<表名稱>`。當資料庫為其他類型時：格式為`<Schema名稱>.<表名稱>`。	在DTS控制台單擊目標訂閱執行個體ID，在基本資料或任務管理頁面的上方，單擊查看訂閱對象，查詢訂閱對象所屬資料庫和表。

常見問題

報錯提示	可能的原因	解決方式
`Cluster changed from * to *, consumer require restart.`	DTS用於讀取增量資料的模組DStore發生切換，導致Flink用戶端的消費位點丟失。	您無需重啟用戶端，僅需查詢用戶端的消費位點，並在DtsExample.java和DtsTableISelectTCaseTest.java檔案中重新傳入消費位點`checkpoint`或`dts.checkpoint`，即可重新消費訂閱資料。