DataWorks：資料服務入門

進入資料服務

登入DataWorks控制台，切換至目標地區後，單擊左側導覽列的資料分析與服務 > 資料服務，在下拉框中選擇對應工作空間後單擊進入資料服務。

操作流程

1. 步驟一：建立資料來源並配置網路連通性

   使用資料服務建立API前，需先將您的資料庫或資料倉儲添加為DataWorks資料來源，以此作為資料服務API的資料來源。開發資料服務API時，資料服務將訪問該資料來源擷取資料表的Schema資訊，協助您進一步佈建要求和返回參數。調用資料服務API時，資料服務將訪問該資料來源來執行查詢請求。資料服務支援的資料來源請參見資料服務資料來源列表。

   重要

   如果連通性測試失敗，請根據網路連通與白名單配置檢查配置結果。

2. 步驟二：建立API分組

   資料服務基於API Gateway對外提供服務。在API Gateway中，分組是API的嵌入式管理單元，並與調用地址的網域名稱相關聯。因此，在資料服務中建立API前，需先在API Gateway建立API分組。

3. 步驟三：建立商務程序

   資料服務基於商務程序實現以業務為單元的API開發，並通過商務程序對API及函數等檔案進行組織管理。因此，在資料服務建立API前，需先建立商務程序。

4. 步驟四：產生API

   商務程序建立完成後，您可基於該商務程序建立相應業務的API。

5. 步驟五：測試API

   已建立的API需進行測試回合，測試通過後，該API才可發布上線。

6. 步驟六：發布API

   通過測試的API需發布上線，發布成功後，其他服務才可調用該API。

7. 步驟七：調用API

   資料服務支援使用簡單身份認證及加密簽名身份認證調用資料服務API，您可根據需要選擇。

8. 步驟八：查看與管理API

   發布上線的API可在服務管理頁面查看，同時，資料服務支援根據業務需求進行下線、授權及查看API調用詳情等管理操作。

步驟一：建立資料來源並配置網路連通性

使用資料服務建立API前，您需將資料庫或資料倉儲添加為DataWorks的資料來源，並保障資料服務資源群組與您的目標資料來源網路連通，以便調用API時DataWorks可成功訪問資料來源。本文樣本建立名為rds_workshop_log的MySQL資料來源，並測試該資料來源與公用資料服務資源群組的連通性。

1. 進入管理中心。

2. 在左側導覽列單擊資料來源管理，進入資料來源管理頁面。

3. 建立資料來源並測試網路連通性。

   1. 單擊新增資料來源，選擇所需資料來源類型。

      本文樣本選擇MySQL。

   2. 配置資料來源資訊。

      根據介面提示進行配置，詳情請參見配置MySQL資料來源。

   3. 選擇資料Serverless資源群組並測試資源群組與資料來源的連通性。

      說明

      • 在任務高並發執行且無法錯峰啟動並執行情況下，需要專有資源來保障高並發和高頻率的API調用。建議您選擇購買使用DataWorks的獨享資料服務資源群組和Serverless資源群組。

      • 使用Serverless資源群組時，需要為Serverless資源群組配置資料服務配額。

   4. 單擊完成，成功建立資料來源。

步驟二：建立API分組

資料服務基於API Gateway對外提供服務。在API Gateway中，分組是API的嵌入式管理單元，並與調用地址的網域名稱相關聯。因此，在資料服務中建立API前，需先在API Gateway建立API分組。

1. 進入API Gateway。

2. 在左側導覽列單擊API管理 > 分組管理。

3. 在分組管理介面，單擊建立分組，建立分組。

   本文樣本建立名為Workshop的分組。

步驟三：建立商務程序

資料服務基於商務程序實現以業務為單元的API開發，並基於商務程序對API及建立API所使用的函數等檔案進行組織管理。因此，建立API前，需先建立商務程序。

1. 建立商務程序。

   在資料服務 > 服務開發頁面，通過如下兩種方式建立：

   • 方式一：單擊表徵圖，選擇建立商務程序。

   • 方式二：按右鍵左側導覽列的商務程序目錄，選擇建立商務程序。

2. 配置商務程序相關參數。

   配置	描述
   業務名稱	根據業務情境自訂名稱。本文樣本建立的商務程序名為DataService。
   API分組	選擇API分組，用於後續管理API。本文樣本使用步驟二中建立的Workshop分組。 說明 API分組是針對某個功能或情境的API集合，也是API Gateway對API的最小嵌入式管理單元。如果您需要建立分組，可參考步驟二：建立API分組操作。

3. 單擊確定，成功建立商務程序。

   商務程序建立完成後，您可在資料服務左側目錄查看目標商務程序詳情。

步驟四：產生API

您需根據業務需要，在建立的商務程序中產生API。

1. 產生API。

   在資料服務 > 服務開發頁面，通過如下兩種方式產生：

   • 方式一：單擊表徵圖，選擇建立API > 產生API。

   • 方式二：按右鍵左側導覽列的目標商務程序，選擇建立 > API > 產生API。

2. 定義API相關屬性。

   在產生API對話方塊，配置API資訊。本文樣本配置如下圖。主要參數介紹如下。

   配置項	描述
   API模式	您可選擇使用嚮導模式或指令碼模式建立API。 嚮導模式：無需具備編碼能力，即可快速配置一個資料API。 指令碼模式：支援多表關聯、複雜查詢和彙總函式等進階功能，可自行編寫API的查詢SQL，滿足高階使用者的個人化查詢需求。 本文樣本使用嚮導模式。兩種模式的更多介紹，詳情請參見產生API概述。
   API名稱	自訂API名稱。本文樣本建立的API名稱為rpt_user_info_all_d。
   API Path	API的存放路徑，即相對於服務Host，API的請求路徑。該配置用於拼接API的調用地址。本文樣本路徑配置為/user。
   協議	支援HTTP及HTTPS。 如果您需要通過HTTPS協議調用API，請在發布API至網關後，在API Gateway控制台綁定獨立網域名稱並上傳SSL認證，詳情請參見支援 HTTPS。
   請求方式	支援GET及POST。 說明 當請求方式選擇GET時，後續API添加的請求參數的參數位置，僅支援選擇QUERY。 當請求方式選擇POST時，後續API添加的請求參數的參數位置，支援選擇QUERY和BODY。
   傳回型別	僅支援配置為JSON類型。
   可見範圍	定義該API建立後的可見範圍，取值包括工作空間和私人。 工作空間：該API對本工作空間內的所有成員可見。 私人：該API僅對API的負責人可見，且暫不支援授權。 本文樣本可見範圍選取工作空間。
   目標檔案夾	定義API在左側商務程序中的存放目錄。若您還未建立商務程序，請參考步驟三：建立商務程序建立。

3. 配置API參數。

   在API的編輯頁面，配置API參數。本文樣本配置如下圖。

   1. 選擇API的資料來源。

      在選擇表地區，選擇產生API所需的資料來源表。

      參數	描述
      資料來源類型	選擇需要基於哪類資料來源建立API。本文樣本選擇MySQL類型資料來源。
      資料來源名稱	選擇需要基於該類型資料來源下的哪個資料來源產生API。本文樣本選擇步驟一：建立資料來源並配置網路連通性建立的rds_workshop_log資料來源。
      資料來源環境	標準模式工作空間支援選擇訪問開發或生產環境資料來源，兩種環境的區別，詳情請參見工作空間模式區別。本文樣本選擇生產環境。
      資料表名稱	選擇該資料來源下需要產生API的資料表。本文樣本選擇rds_workshop_log資料來源中的rpt_user_info_all_d表。

   2. 定義請求參數和返回參數。

      選擇資料表後，選擇參數地區會自動顯示該表的所有欄位，您可根據需要選擇相應欄位作為API的請求參數和返回參數。若需對欄位進行排序，則可將目標欄位添加至排序欄位地區，進行相應調整。

      本文樣本請求參數為uid，返回參數為該表的所有欄位。

      說明

      單擊右側導覽列的請求參數或返回參數，即可修改參數中欄位的類型、樣本值、預設值等配置。具體請根據實際需要使用。

4. 配置API資源群組。

   在API編輯頁面，單擊右側服務資源群組，進行配置資源群組。由於預設提供的公用資料服務資源群組即將下線，所以建立API時，只能配置資源群組類型方案為獨享服務資源群組，選擇已配置資料服務配額的Serverless資源群組，或獨享資料服務資源群組。

步驟五：測試API

API產生後，需單擊API編輯頁面右上方的測試，驗證API的請求與傳回值是否符合預期。本文樣本佈建要求參數uid的值為0016359810821，測試返回結果。更多測試詳情，請參見測試API。

步驟六：發布API

API提交發布後才可在其他服務進行調用。單擊API編輯頁面右上方的提交，選擇對應版本進行發布。發布後的API，可在API Gateway查看。更多發布詳情，請參見發布API。

步驟七：調用API

調用API目前支援如下認證方式，您可根據需要選擇：

• 簡單身份認證：安全性低，適用於報表、資料大屏等情境。

• 加密簽名身份認證：安全性高，適用於應用開發情境。

1. 單擊資料服務頂部功能表列的服務管理，進入服務管理頁面。

2. 在左側導覽列選擇API調用。

   發行的API將發布至API Gateway服務，您可通過API GatewaySDK調用API。詳情請參見用戶端調用API樣本。

步驟八：查看與管理API

您可在服務管理頁面，查看發行API，並執行相關管理操作。