（推薦）向導模式

1. 在配置任務步驟的配置數據來源與去向區域，根據實際配置數據來源和數據去向。

   數據來源配置

   參數	說明
   表	表格存儲中的數據表名稱。
   主鍵區間分布（起始）	數據讀取的起始主鍵和結束主鍵，格式為JSON數組。 起始主鍵和結束主鍵需要是有效的主鍵或者是由INF_MIN和INF_MAX類型組成的虛擬點，虛擬點的列數必須與主鍵相同。 其中INF_MIN表示無限小，任何類型的值都比它大；INF_MAX表示無限大，任何類型的值都比它小。 數據表中的行按主鍵從小到大排序，讀取范圍是一個左閉右開的區間，返回的是大于等于起始主鍵且小于結束主鍵的所有的行。 假設表包含pk1（String類型）和pk2（Integer類型）兩個主鍵列。 如果需要導出全表數據，則配置示例如下： 主鍵區間分布（起始）的配置示例 [ { "type": "INF_MIN" }, { "type": "INF_MIN" } ] 主鍵區間分布（結束）的配置示例 [ { "type": "INF_MAX" }, { "type": "INF_MAX" } ] 如果需要導出pk1="tablestore" 的行，則配置示例如下： 主鍵區間分布（起始）的配置示例 [ 。 { "type": "STRING", "value": "tablestore" }, { "type": "INF_MIN" } ] 主鍵區間分布（結束）的配置示例 [ { "type": "STRING", "value": "tablestore" }, { "type": "INF_MAX" } ]
   主鍵區間分布（結束）
   切分配置信息	自定義切分配置信息，普通情況下不建議配置。當Tablestore數據存儲發生熱點，且使用Tablestore Reader自動切分的策略不能生效時，建議使用自定義的切分規則。切分指定的是在主鍵起始和結束區間內的切分點，僅配置切分鍵，無需指定全部的主鍵。格式為JSON數組。

   數據去向配置

   參數	說明
   文本類型	寫入OSS的文件類型，例如csv、txt。 說明 不同文件類型支持的配置有差異，請以實際界面為準。
   文件名(含路徑)	當設置文本類型為text、csv或orc時才能配置該參數。 OSS中的文件名稱，支持帶有路徑，例如tablestore/20231130/myotsdata.csv。
   文件路徑	當設置文本類型為parquet時才能配置該參數。 文件在OSS上的路徑，例如tablestore/20231130/。
   文件名	當設置文本類型為parquet時才能配置該參數。 OSS中的文件名稱。
   列分隔符	當設置文本類型為text或csv時才能配置該參數。 寫入OSS文件時，列之間使用的分隔符。
   行分隔符	當設置文本類型為text時才能配置才參數。 自定義的行分隔符，用來分隔不同數據行。例如配置為 \u0001。您需要使用數據中不存在的分隔符作為行分隔符。 如果要使用Linux或Windows平臺的默認行分隔符（\n、\r\n）建議置空此配置，平臺能自適應讀取。
   編碼	當設置文本類型為text或csv時才能配置該參數。 寫入文件的編碼配置。
   null值	當設置文本類型為text、csv或orc時才能配置該參數。 源數據源中可以表示為null的字符串，例如配置為null，如果源數據是null，則系統會視作null字段。
   時間格式	當設置文本類型為text或csv時才能配置該參數。 日期類型的數據寫入到OSS文件時的時間格式，例如yyyy-MM-dd。
   前綴沖突	當設置的文件名與OSS中已有文件名沖突時的處理方法。取值范圍如下： 替換：刪除原始文件，重建一個同名文件。 保留：保留原始文件，重建一個新文件，名稱為原文件名加隨機后綴。 報錯：同步任務停止執行。
   切分文件	當設置文本類型為text或csv時才能配置該參數。 寫入OSS文件時，單個Object文件的最大大小。單位為MB。最大值為100 GB。當文件大小超過指定的切分文件大小時，系統會生成新文件繼續寫入數據，直到完成所有數據寫入。
   寫為一個文件	當設置文本類型為text或csv時才能配置該參數。 寫入數據到OSS時，是否寫單個文件。默認寫多個文件，當讀不到任何數據時，如果配置了文件頭，則會輸出只包含文件頭的空文件，否則只輸出空文件。 如果需要寫入到單個文件，請選中寫為一個文件復選框。此時當讀不到任何數據時， 不會產生空文件。
   首行輸出表頭	當設置文本類型為text或csv時才能配置該參數。 寫入文件時第一行是否輸出表頭。默認不輸出表頭。如果需要在第一行輸出表頭，請選中首行輸出表頭復選框。

2. 在字段映射區域，單擊來源字段后的圖標，手動編輯要同步到OSS的來源字段，目標字段無需配置。

3. 在通道控制區域，配置任務運行參數，例如同步速率、臟數據同步策略等。關于參數配置的更多信息，請參見配置通道。

4. 單擊圖標，保存配置。

   說明

   執行后續操作時，如果未保存配置，則系統會出現保存確認的提示，單擊確認即可。

腳本模式

全量數據的同步需要使用到Tablestore（OTS） Reader和OSS Writer插件。腳本配置規則請參見Tablestore數據源和OSS數據源。

1. 在配置任務步驟，單擊圖標，然后在彈出的對話框中單擊確認。

2. 在腳本配置頁面，請根據如下示例完成配置。

   重要

   • 由于全量導出一般是一次性的，所以無需配置自動調度參數。如果需要配置調度參數，請參見增量同步中的調度參數配置。

   • 如果在腳本配置中存在變量，例如存在${date}，則需要在運行同步任務時設置變量的具體值。

   • 為了便于理解，在配置示例中增加了注釋內容，實際使用腳本時請刪除所有注釋內容。

   {
       "type": "job", //不能修改。
       "version": "2.0", //版本號，不能修改。
       "steps": [
           {
               "stepType":"ots",//插件名，不能修改。
               "parameter":{
                   "datasource":"otssource",//表格存儲數據源名稱，請根據實際填寫。
                   "newVersion":"true",//使用新版otsreader。
                   "mode": "normal",// 行模式讀取數據。
                   "isTimeseriesTable":"false",// 配置該表為寬表（非時序表）。
                   "column":[//需要導出到OSS的列名，不能設置為空。
                       {
                           "name":"column1"http://Tablestore中列名，此列需要導入到OSS。
                       },
                       {
                           "name":"column2"
                       },
                       {
                           "name":"column3"
                       },
                       {
                           "name":"column4"
                       },
                       {
                           "name":"column5"
                       }
                   ],
                   "range":{
                       "split":[ //用于配置Tablestore的數據表的分區信息，可以加速導出。一般情況下無需配置。
                       ],
                       "end":[//Tablestore中結束主鍵信息。如果需要導出全量數據，此處請配置為INF_MAX；如果只需導出部分數據，則按需配置。當數據表存在多個主鍵列時，此處end中需要配置對應主鍵列信息。
                           {
                               "type":"STRING",
                               "value":"endValue"
                           },
                           {
                               "type":"INT",
                               "value":"100"
                           },
                           {
                               "type":"INF_MAX"
                           },
                           {
                               "type":"INF_MAX"
                           }
                       ],
                       "begin":[//Tablestore中起始主鍵信息。如果需要導出全量數據，此處請配置為INF_MIN；如果只需導出部分數據，則按需配置。當數據表存在多個主鍵列時，此處begin中需要配置對應主鍵列信息。
                           {
                               "type":"STRING",
                               "value":"beginValue"
                           },
                           {
                               "type":"INT",
                               "value":"0"
                           },
                           {
                               "type":"INF_MIN"
                           },
                           {
                               "type":"INF_MIN"
                           }
                       ]
                   },
                   "table":"datatable"http://Tablestore中的數據表名稱。
               },
               "name":"Reader",
               "category":"reader"
           },
           {
               "stepType": "oss",//插件名，不能修改。
               "parameter": {
                   "nullFormat": "null", //定義null值的字符串標識符方式，可以是空字符串。
                   "dateFormat": "yyyy-MM-dd HH:mm:ss",//日期格式。
                   "datasource": "osssource", //OSS數據源名稱，請根據實際填寫。
                   "envType": 1,
                   "writeSingleObject": true, //將同步數據寫入單個oss文件。
                   "writeMode": "truncate", //當同名文件存在時系統進行的操作，全量導出時請使用truncate，可選值包括truncate、append和nonConflict。truncate表示會清理已存在的同名文件，append表示會增加到已存在的同名文件內容后面，nonConflict表示當同名文件存在時會報錯。
                   "encoding": "UTF-8", //編碼類型。
                   "fieldDelimiter": ",", //每一列的分隔符。
                   "fileFormat": "csv", //導出的文本類型，取值范圍包括csv、text、parquet和orc。
                   "object": "tablestore/20231130/myotsdata.csv" //Object的前綴，無需包括Bucket名稱，例如tablestore/20231130/。如果是定時導出，則此處需要使用變量，例如tablestore/${date}，然后在配置調度參數時配置${date}的值。
               },
               "name": "Writer",
               "category": "writer"
           },
           {
               "name": "Processor",
               "stepType": null,
               "category": "processor",
               "copies": 1,
               "parameter": {
                   "nodes": [],
                   "edges": [],
                   "groups": [],
                   "version": "2.0"
               }
           }
       ],
       "setting": {
           "executeMode": null,
           "errorLimit": {
               "record": "0" //當錯誤個數超過record個數時，導入任務會失敗。
           },
           "speed": {
               "concurrent": 2, //并發度。
               "throttle": false
           }
       },
       "order": {
           "hops": [
               {
                   "from": "Reader",
                   "to": "Writer"
               }
           ]
       }
   }

3. 單擊圖標，保存配置。

   說明

   執行后續操作時，如果未保存腳本，則系統會出現保存確認的提示，單擊確認即可。