本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用簡易規則類型建立規則型比對工作流程
<a name="rule-based-mw-simple"></a>

**先決條件**

建立規則型比對工作流程之前，您必須：

1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。

1. 如果使用 Amazon Connect Customer Profiles 做為輸出目的地，請確定您已設定適當的許可。

下列程序示範如何使用 AWS Entity Resolution 主控台或 `CreateMatchingWorkflow` API，使用**簡易**規則類型建立規則型比對工作流程。

------
#### [ Console ]

**使用主控台建立具有**簡易**規則類型的規則型比對工作流程**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 開啟 AWS Entity Resolution 主控台。

1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。

1. 在**相符工作流程**頁面上的右上角，選擇**建立相符工作流程**。

1. 針對**步驟 1：指定相符的工作流程詳細資訊**，執行下列動作：

   1. 輸入**相符的工作流程名稱**和選用的**描述**。

   1. 針對**資料輸入**，選擇 **AWS 區域**、**AWS Glue 資料庫**、**AWS Glue 資料表**，然後選擇對應的**結構描述映射**。

      您最多可以新增 19 個資料輸入。

   1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。如果您不想標準化資料，請取消選取**標準化資料**選項。
**注意**  
只有**建立結構描述映射**中的下列案例才支援標準化：  
如果將下列**名稱**子類型分組：**名字**、**中間名**、**姓氏**。
如果將下列**地址**子類型分組：**街道地址 1**、**街道地址 2**、**街道地址 3**、**城市**、**州**、**國家**/地區、**郵遞區號**。
如果將下列**電話**子類型分組：**電話號碼**、**電話國家/地區代碼**。

   1. 若要指定**服務存取**許可，請選擇 選項並採取建議的動作。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/rule-based-mw-simple.html)

   1. （選用） 若要啟用資源**的標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。

   1. 選擇**下一步**。

1. 針對**步驟 2：選擇相符的技術**：

   1. 針對**比對方法**，選擇**規則型比對**。

   1. 針對**規則類型**，選擇**簡單**。  
![選擇比對技術畫面，並選取簡易規則型比對選項。](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-rule-based-simple.PNG)

   1. 針對**處理節奏**，選取下列其中一個選項。
      + 選擇**手動**以隨需執行工作流程以進行大量更新 
      + 選擇**自動**，在 S3 儲存貯體中有新資料時立即執行工作流程 
**注意**  
如果您選擇**自動**，請確定您的 S3 儲存貯體已開啟 Amazon EventBridge 通知。如需使用 S3 主控台啟用 Amazon EventBridge 的說明，請參閱《Amazon *Amazon S3*[啟用 Amazon EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html)。

   1. （選用） 對於**僅限 ID 映射的索引**，您可以選擇**開啟**僅編製資料索引的功能，而不是產生 IDs。

      根據預設，比對工作流程會在資料編製索引後產生 IDs。

   1. 針對**相符規則**，輸入**規則名稱**，然後選擇該規則的**相符索引鍵**。

      您最多可以建立 15 個規則，並且可以在規則中套用最多 15 個不同的相符金鑰來定義相符條件。  
![比對規則界面與欄位，以輸入規則名稱並選取比對索引鍵。](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/matching-rules.PNG)

   1. 針對**比較類型**，請根據您的目標選擇下列其中一個選項。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/rule-based-mw-simple.html)  
![比較類型選項：多個輸入欄位用於尋找儲存在多個欄位中資料的相符項目，或單一輸入欄位用於限制一個欄位內的比較。](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/comparison-type.PNG)

   1. 選擇**下一步**。

1. 針對**步驟 3：指定資料輸出和格式**：

   1. 對於**資料輸出目的地和格式**，選擇資料輸出的 **Amazon S3 位置**，以及**資料格式**是**標準化資料**還是**原始資料**。

   1. 針對**加密**，如果您選擇**自訂加密設定**，請輸入**AWS KMS 金鑰** ARN。

   1. 檢視**系統產生的輸出**。

   1. 對於**資料輸出**，決定您要包含、隱藏或遮罩的欄位，然後根據您的目標採取建議的動作。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/rule-based-mw-simple.html)

   1. 選擇**下一步**。

1. 針對**步驟 4：檢閱並建立**：

   1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。

   1. 選擇 **Create and run (建立並執行)**。

      訊息隨即出現，指出已建立相符的工作流程，且任務已開始。

1. 在相符的工作流程詳細資訊頁面的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
   + **任務 ID**。
   + 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗** 
   + 工作流程任務的**完成時間**。
   + **處理的記錄**數量。
   + **未處理的記錄**數目。
   + **產生的唯一比對 IDs**。
   + **輸入記錄**的數量。

   您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。

1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。

1. （僅限**手動**處理類型） 如果您已使用**手動**處理類型建立**規則型比對**工作流程，您可以在比對工作流程詳細資訊頁面上選擇**執行工作流程**，隨時執行比對工作流程。

------
#### [ API ]

**使用 API 使用**簡易**規則類型建立規則型比對工作流程**
**注意**  
根據預設，工作流程會使用標準 （批次） 處理。若要使用增量 （自動處理，您必須明確設定。

1. 開啟終端機或命令提示以提出 API 請求。

1. 建立對下列端點的 POST 請求：

   ```
   /matchingworkflows
   ```

1. 在請求標頭中，將 Content-type 設定為 application/json。
**注意**  
如需支援程式設計語言的完整清單，請參閱 *[AWS Entity Resolution API 參考](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)*。

1. 針對請求內文，請提供下列必要的 JSON 參數：

   ```
   {
      "description": "{{string}}",
      "incrementalRunConfig": { 
         "incrementalRunType": "{{string}}"
      },
      "inputSourceConfig": [ 
         { 
            "applyNormalization": {{boolean}},
            "inputSourceARN": "{{string}}",
            "schemaName": "{{string}}"
         }
      ],
      "outputSourceConfig": [ 
         { 
            "applyNormalization": {{boolean}},
            "KMSArn": "{{string}}",
            "output": [ 
               { 
                  "hashed": boolean,
                  "name": "{{string}}"
               }
            ],
            "outputS3Path": "{{string}}"
         }
      ],
      "resolutionTechniques": { 
         "providerProperties": { 
            "intermediateSourceConfiguration": { 
               "intermediateS3Path": "{{string}}"
            },
            "providerConfiguration": {{JSON value}},
            "providerServiceArn": "{{string}}"
         },
         "resolutionType": "RULE_MATCHING",
         "ruleBasedProperties": { 
            "attributeMatchingModel": "{{string}}",
            "matchPurpose": "{{string}}",
            "rules": [ 
               { 
                  "matchingKeys": [ "{{string}}" ],
                  "ruleName": "{{string}}"
               }
            ]
         },
         "ruleConditionProperties": { 
            "rules": [ 
               { 
                  "condition": "{{string}}",
                  "ruleName": "{{string}}"
               }
            ]
         }
      },
      "roleArn": "{{string}}",
      "tags": { 
         "string" : "{{string}}" 
      },
      "workflowName": "{{{{string}}}}"
   }
   ```

   其中：
   + `workflowName` （必要） – 必須唯一且介於 1–255 個字元之間的相符模式 【a-zA-Z\_0-9-】\*
   + `inputSourceConfig` （必要） – 1–20 個輸入來源組態的清單
   + `outputSourceConfig` （必要） – 確切有一個輸出來源組態
   + `resolutionTechniques` （必要） – 將規則型比對設為 "RULE\_MATCHING"
   + `roleArn` （必要） – 用於工作流程執行的 IAM 角色 ARN
   + `ruleConditionProperties` （必要） – 規則條件清單和相符規則的名稱。

   選用參數包括：
   + `description` – 最多 255 個字元
   + `incrementalRunConfig` – 增量執行類型組態
   + `tags` – 最多 200 個鍵值對

1. （選用） 若要使用增量處理而非預設標準 （批次） 處理，請將下列參數新增至請求內文：

   ```
   "incrementalRunConfig": {
      "incrementalRunType": "AUTOMATIC"
   }
   ```

1. 傳送 請求。

1. 如果成功，您會收到狀態碼為 200 的回應，以及包含下列項目的 JSON 內文：

   ```
   {
      "workflowArn": "string",
      "workflowName": "string",
      // Plus all configured workflow details
   }
   ```

1. 如果呼叫失敗，您可能會收到下列其中一個錯誤：
   + 400 – 如果工作流程名稱已存在，則為 ConflictException 
   + 400 – 如果輸入驗證失敗，則 ValidationException 
   + 402 – 如果超過帳戶限制，則超出 ExceedsLimitException 
   + 403 – 如果您沒有足夠的存取權，則為 AccessDeniedException 
   + 429 – 如果請求已調節，則 ThrottlingException 
   + 500 – 如果發生內部服務故障，則為 InternalServerException 

------