1. 概述编辑
1.1 版本
| FineDataLink 版本 | 功能變動 |
|---|---|
| 4.1.13.2 | 資料開發-定時任務支援讀取和寫入 Amazon S3 資料源 |
| 4.2.0.1 | 統一用 S3 協定相容目前已支援的全部檔案儲存系統 |
1.2 功能簡介
FDL 中支援配置 Amazon S3 資料源的資料連結。
資料開發-定時任務中可使用該資料連結，在阿裏雲 OSS，華為雲OBS，亞馬遜 S3，MinIO 等相容 S3 協定的物件儲存中進行讀取和寫入。
2. 準備工作编辑
2.1 前提條件
詳情請參見：前提條件
2.2 收集連結資訊
在連結資料源之前，請收集以下資訊：
存取域名：用於存取 Amazon S3 服務的 URL 或域名（必填）。
檔案儲存服務的地理區域（如果「存取域名」包含儲存區域，則此處不需要填寫）。
證件讀取方式。
3. 具體連結步驟编辑
1）管理者登入 FDL 工程，點選「管理系統>資料連結>資料連結管理」，選中某個資料夾後，建立資料連結。如下圖所示：
2）設定資料連結名稱（可同時修改資料連結所在目錄）。如下圖所示：
3）可根據資料源分類、支援形式、適配模組、資料源名稱篩選資料庫。如下圖所示：
4）配置資料連結。如下圖所示：
各設定項介紹如下表所示：
| 設定項 | 說明 |
|---|---|
| 存取域名（Endpoint） | 必填
|
| 區域（Region） | 非必填（如果 Endpoint 包含儲存區域，則此處不需要填寫）
|
| 證件讀取方式 | 可選擇：手動指定證件、使用 AWS 環境內預設憑證 1）手動指定證件：將允許使用者手動指定證件配置 2）使用AWS環境內預設憑證說明：將使用環境內的證件配置：設定AWS臨時證件並AWS 區域用於開發 注：使用 Amazon S3 相容讀取 OSS、OBS、COS 時，選擇「使用AWS環境內預設證件」時將無法正常連結，會報錯 |
| AccessKeyID | 「證件讀取方式」為「手動指定證件」時有該設定項 所選擇的檔案儲存廠商帳號的存取證件之一，用於驗證身分和授權存取儲存桶（Bucket）中的物件 |
| SecretAccessKey | 「證件讀取方式」為「手動指定證件」時有該設定項 所選擇的檔案儲存廠商帳號的存取證件之一，用於驗證身分和授權存取儲存桶（Bucket）中的物件 |
| 編碼 | 支援選擇：GBK、BIG5、ISO-8859-1、UTF-8、UTF-16、EUC_JP、EUC_KR、CP850 |
5）點選「測試連結」，若連結成功則「儲存」該連結。如下圖所示：
4. 使用資料源编辑
4.1 定時任務
Amazon S3 資料源分類於「檔案輸入」分類中：
4.1.1 讀取 Amazon S3 資料
1）「全局指派參數」、「資料同步」、「參數指派」、「資料轉換-檔案輸入」的資料來源新增：Amazon S3。如下圖所示：
注：各設定項說明請參見：檔案輸入功能說明；讀取資料夾時，不支援「檔案篩選」功能。
2）「檔案傳輸」的檔案來源新增：Amazon S3。如下圖所示：
注：各設定項說明請參見：檔案傳輸功能說明
4.1.2 寫入 Amazon S3
1）「資料同步」、「資料轉換-檔案匯出」的資料去向新增：Amazon S3。如下圖所示：
檔案重名策略支援：檔案重名，停止寫入並報錯；檔案重名，改寫目標檔案資料。
注：各設定項說明請參見：檔案匯出算子功能說明
2）「檔案傳輸」的檔案去向配置：
檔案重名策略支援：檔案重名，停止寫入並報錯；檔案重名，改寫目標檔案資料。
注：各設定項說明請參見：檔案傳輸功能說明
