Data Transmission Service提供的資料投遞功能，使用者可以通過SDK將各種類型的資料來源投遞到DTS，再由DTS同步至目標資料庫，從而支援更多類型的資料來源。
應用情境
資料投遞功能適用於以下任一情境：
源端為DTS同步方案暫不支援的資料庫類型，例如國產資料庫。
源端為日誌資料、特殊資料類型等。
出於安全等原因，源端不能直接連接DTS，例如源庫帳號密碼不能暴露。
前提條件
已建立用於接收資料的目標庫執行個體，當前僅支援AnalyticDB PostgreSQL版。建立方法，請參見建立執行個體。
目標AnalyticDB PostgreSQL版執行個體中需已建立好用於接收資料的資料庫和Schema（本樣本建立的Schema為dts_deliver_test）。建立方法，請參見匯入資料。
若源庫的接入方式需選擇為專線/VPN網關/智能網關，您需要允許DTS通過VPN網關訪問您的資料庫。操作方法，請參見通過VPN網關實現本地IDC與DTS雲端服務互連。
注意事項
使用SDK將源端資料投遞到DTS需要有一定的編碼能力。
AnalyticDB PostgreSQL版執行個體中的Schema名稱、投遞數據對象配置階段輸入的資料庫名稱和SDK中配置的dbName需保持一致，否則目標端可能接收不到資料。
執行個體建立後不支援修改分區數。
資料投遞執行個體建立成功後請及時使用SDK進行資料投遞，否則執行個體會因採集不到增量資料而失敗。
若執行個體運行失敗，DTS技術支援人員將在8小時內嘗試恢複該執行個體。在恢複失敗執行個體的過程中，可能會對該執行個體進行重啟、調整參數等操作。
說明在調整參數時，僅會修改執行個體的參數，不會對資料庫中的參數進行修改。可能修改的參數，包括但不限於修改執行個體參數中的參數。
費用說明
詳情請參見計費概述。
建立資料投遞執行個體
進入同步任務的列表頁面。
在頂部功能表列中，單擊整合與開發。
在左側導覽列，選擇。
說明實際操作可能會因DMS的模式和布局不同，而有所差異。更多資訊，請參見極簡模式和自訂DMS介面布局與樣式。
您也可以登入新版DTS同步工作清單頁面。
在同步任務右側，選擇同步執行個體所屬地區。
說明新版DTS同步工作清單頁面，需要在頁面左上方選擇同步執行個體所屬地區。
單擊建立任務，配置源庫及目標庫資訊。
類別
配置
說明
無
任務名稱
DTS會自動產生一個任務名稱，建議配置具有業務意義的名稱（無唯一性要求），便於後續識別。
源庫資訊
選擇DMS資料庫執行個體
請勿選擇資料庫執行個體，資料投遞任務僅支援手動在下方填入資料庫資訊。
資料庫類型
選擇資料投遞。
接入方式
請根據實際情況進行選擇，本樣本選擇公網IP。
說明若您選擇為專線/VPN網關/智能網關，則還需選擇VPN網關所屬專用網路和虛擬交換器。
執行個體地區
選擇用戶端所在的地區。
說明若選項中沒有您資料庫所屬的地區，您可以選擇一個該資料庫距離最近的地區。
目標庫資訊
選擇DMS資料庫執行個體
您可以按實際需求，選擇是否使用已有執行個體。
如使用已有執行個體，下方資料庫資訊將自動填入，您無需重複輸入。
如不使用已有執行個體，您需要輸入下方的資料庫資訊。
資料庫類型
選擇AnalyticDB PostgreSQL。
接入方式
選擇雲執行個體。
執行個體地區
選擇目標AnalyticDB PostgreSQL版執行個體所屬地區。
執行個體ID
選擇目標AnalyticDB PostgreSQL版執行個體ID。
資料庫名稱
填入目標AnalyticDB PostgreSQL版執行個體中用於接收資料的資料庫名稱。
資料庫帳號
填入目標AnalyticDB PostgreSQL版執行個體的資料庫帳號，需要具有讀寫權限。建立帳號的方法，請參見建立資料庫帳號。
資料庫密碼
填入該資料庫帳號對應的密碼。
配置完成後，單擊頁面下方的測試連接以進行下一步。
如果源或目標資料庫是阿里雲資料庫執行個體（例如RDS MySQL、ApsaraDB for MongoDB等），DTS會自動將對應地區DTS服務的IP地址添加到阿里雲資料庫執行個體的白名單中；如果源或目標資料庫是ECS上的自建資料庫，DTS會自動將對應地區DTS服務的IP地址添加到ECS的安全規則中，您還需確保自建資料庫沒有限制ECS的訪問（若資料庫是叢集部署在多個ECS執行個體，您需要手動將DTS服務對應地區的IP地址添到其餘每個ECS的安全規則中）；如果源或目標資料庫是IDC自建資料庫或其他雲資料庫，則需要您手動添加對應地區DTS服務的IP地址，以允許來自DTS伺服器的訪問。DTS服務的IP地址，請參見DTS伺服器的IP位址區段。
警告DTS自動添加或您手動添加DTS服務的公網IP位址區段可能會存在安全風險，一旦使用本產品代表您已理解和確認其中可能存在的安全風險，並且需要您做好基本的安全防護，包括但不限於加強帳號密碼強度防範、限制各網段開放的連接埠號碼、內部各API使用鑒權方式通訊、定期檢查並限制不需要的網段，或者使用通過內網（專線/VPN網關/智能網關）的方式接入。
配置任務對象及進階配置。
配置
說明
目標已存在表的處理模式
預檢查並報錯攔截：檢查目標資料庫中是否有同名的表。如果目標資料庫中沒有同名的表，則通過該檢查專案；如果目標資料庫中有同名的表，則在預檢查階段提示錯誤，資料同步任務不會被啟動。
說明如果目標庫中同名的表不方便刪除或重新命名，您可以更改該表在目標庫中的名稱，請參見庫表列名映射。
忽略報錯並繼續執行：跳過目標資料庫中是否有同名表的檢查項。
警告選擇為忽略報錯並繼續執行，可能導致資料不一致，給業務帶來風險，例如：
表結構一致的情況下，如在目標庫遇到與源庫主鍵或唯一鍵的值相同的記錄：
全量期間，DTS會保留目的地組群中的該條記錄，即源庫中的該條記錄不會同步至目標資料庫中。
增量期間，DTS不會保留目的地組群中的該條記錄，即源庫中的該條記錄會覆蓋至目標資料庫中。
表結構不一致的情況下，可能會導致無法初始化資料、只能同步部分列的資料或同步失敗，請謹慎操作。
目標庫對象名稱大小寫策略
您可以配置目標執行個體中同步對象的庫名、表名和列名的英文大小寫策略。預設情況下選擇DTS預設策略，您也可以選擇與源庫、目標庫預設策略保持一致。更多資訊，請參見目標庫對象名稱大小寫策略。
投遞數據對象配置
單擊添加庫，並在彈出的新增數據庫對話方塊中，輸入源庫名稱。
重要源庫名稱需要與AnalyticDB PostgreSQL執行個體中的Schema名一致，本樣本輸入dts_deliver_test。
若列表中已有資料庫且需要新增資料庫，您可以單擊已有庫後的添加按鈕。
單擊確定。
單擊剛添加的資料庫前的
，展開資料庫列表。單擊Table後的新增錶，並在彈出的添加錶對話方塊中，輸入源庫的表名稱。
重要源庫的表名需要與SDK中配置的tableName保持一致，本樣本輸入tab1,tab2,tab3。更多資訊，請參加見參數說明。
單擊確定。
（可選）配置表名和列名映射。
單擊剛建立的表後的編輯按鈕。
配置表名映射。
修改表名稱。
配置列名映射。
取消選中全表同步，然後修改列名稱和映射列名稱。
重要列名稱和映射列名稱需要配合SDK使用，其中列名稱為SDK中的源列名（即FakeSource.java檔案中createField的name），映射列名稱為目標AnalyticDB PostgreSQL版執行個體中的列名。
單擊
按鈕可以添加更多列。
配置完成後，單擊確定。
說明您可以根據實際情況重複操作添加、編輯、大量編輯、刪除資料庫或表。
單擊下一步高級配置，進行進階配置。
配置
說明
選擇調度該任務的專屬叢集
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在設定的重試時間內相關操作執行成功，同步任務將自動回復。否則，同步任務將會失敗。
重要源庫、目標庫出現其他問題後的重試時間的值需要小於源庫、目標庫無法串連後的重試時間的值。
是否限制增量同步處理速率
您也可以根據實際情況，選擇是否對增量同步處理任務進行限速設定（設定每秒增量遷移的行數RPS和每秒增量遷移的數據量MB），以緩解目標庫的壓力。
環境標籤
請根據實際情況，選擇用於標識執行個體的環境標籤。
配置ETL功能
選擇是否配置ETL功能。關於ETL的更多資訊，請參見什麼是ETL。
是：配置ETL功能，並在文字框中填寫資料處理語句，詳情請參見在DTS遷移或同步任務中配置ETL。
否：不配置ETL功能。
儲存任務並進行預檢查。
若您需要查看調用API介面配置該執行個體時的參數資訊，請將滑鼠游標移動至下一步儲存任務並預檢查按鈕上，然後單擊氣泡中的預覽OpenAPI參數。
若您無需查看或已完成查看API參數，請單擊頁面下方的下一步儲存任務並預檢查。
說明在同步作業正式啟動之前，會先進行預檢查。只有預檢查通過後，才能成功啟動同步作業。
如果預檢查失敗，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
如果預檢查產生警告：
對於不可以忽略的檢查項，請單擊失敗檢查項後的查看詳情，並根據提示修複後重新進行預檢查。
對於可以忽略無需修複的檢查項，您可以依次單擊點擊確認警示詳情、確認屏蔽、確定、重新進行預檢查，跳過警示檢查項重新進行預檢查。如果選擇屏蔽警示檢查項，可能會導致資料不一致等問題，給業務帶來風險。
預檢查通過率顯示為100%時，單擊下一步購買。
在購買頁面，選擇資料同步執行個體的計費方式、鏈路規格，詳細說明請參見下表。
類別
參數
說明
資訊配置
計費方式
預付費（訂用帳戶）：在建立執行個體時支付費用。適合長期需求，價格比隨用隨付更實惠，且購買時間長度越長，折扣越多。
後付費（隨用隨付）：按小時計費。適合短期需求，用完可立即釋放執行個體，節省費用。
分區數
即目標Topic的Partition（分區）數量。
重要執行個體建立後不支援修改分區數，請謹慎選擇。
資源群組配置
執行個體所屬的資源群組，預設為default resource group。更多資訊，請參見什麼是資源管理。
鏈路規格
DTS為您提供了不同效能的同步規格，同步鏈路規格的不同會影響同步速率，您可以根據業務情境進行選擇。更多資訊，請參見資料同步鏈路規格說明。
訂購時間長度
在預付費模式下，選擇訂用帳戶執行個體的時間長度和數量，包月可選擇1~9個月，包年可選擇1年、2年、3年和5年。
說明該選項僅在付費類型為預付費時出現。
配置完成後，閱讀並勾選《資料轉送（隨用隨付）服務條款》。
單擊購買並啟動，並在彈出的確認對話方塊，單擊確定。
您可在資料同步介面查看具體任務進度。
使用SDK將源端資料投遞到DTS
配置DTS投遞的SDK。
開啟IntelliJ IDEA等類似軟體，建立一個業務Project。
在建立的業務Project中，找到專案物件模型檔案：pom.xml。
在pom.xml中添加如下依賴：
<dependency> <groupId>com.aliyun.dts.deliver</groupId> <artifactId>dts-deliver-client</artifactId> <version>1.0.0</version> </dependency>說明您可以在dts-deliver-client頁面查看最新Maven依賴。
下載範例程式碼，參考dts-deliver-test檔案夾中的DtsDeliverTest.java檔案進行投遞。範例程式碼，參見使用範例程式碼。
說明FakeSource.java檔案中：read方法是資料來源的樣本，createField中的name是源列名，您需要根據實際情況進行編碼。
在同步任務列表單擊目標資料投遞執行個體ID，並在左側導覽列單擊基本資料，擷取SDK範例程式碼中使用的參數。
參數
說明
擷取方式
ip:port
資料投遞通道的地址。
在投遞通道資訊地區，單擊公網地址或VPC網絡地址後的複製。
重要用戶端所屬的網路在當前執行個體Virtual Private Cloud時，才可以使用VPC網絡地址。
ak
DTS資料投遞執行個體所屬帳號的AccessKey ID和AccessKey Secret。
secret
dts_job_id
說明即DTS_JOB_ID.getKey()後需要填入的資訊。
DTS資料投遞執行個體的任務ID。
重要請勿填寫為執行個體ID。
您可以調用DescribeDtsJobs介面查詢。
說明投遞Topic中_vpc_與_data_delivery_間的資訊即為您需要填入的dts_job_id。例如投遞Topic為cn_hangzhou_vpc_cxti86dc11z***_data_delivery_version2時，則dts_job_id需填入cxti86dc11z***。
topic
投遞的目標Topic。
在投遞通道資訊地區，單擊投遞Topic後的複製。
partition
目標Topic的Partition（分區）數量。
在投遞通道資訊地區，查看分區數。
region
DTS資料投遞執行個體的地區。
在投遞通道資訊地區，查看執行個體地區。
dbName
源端資料庫名稱，需要與AnalyticDB PostgreSQL執行個體中的Schema名一致。
請根據實際情況填寫，本樣本為dts_deliver_test。
tableName
源端表名稱，需要與投遞數據對象配置階段輸入的表名一致。
請根據實際情況填寫，本樣本為tab1、tab2、tab3。
參數配置完後，記錄目前時間並啟動SDK。
修改資料投遞執行個體的位點，詳情請參見修改同步或遷移執行個體的當前位點。
說明資料投遞執行個體的當前位點預設為增量寫入模組開始啟動並執行時間，您需要修改為SDK啟動的時間。
在目標端查看資料。