本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用匹配流程比對輸入資料
*相符工作流程*是一種資料處理任務，可合併和比較來自不同輸入來源的資料，並根據不同的相符技術判斷哪些記錄相符。 會從您指定的位置 AWS Entity Resolution 讀取您的資料，在記錄之間尋找相符項目，並為每個相符的資料集指派[相符 ID](glossary.md#match-id-defin)。
下圖摘要說明如何建立相符的工作流程。
![\[A summary of the four steps to create a matching workflow in AWS Entity Resolution\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/HIW-Matching-Workflow.png)
**Topics**
+ [比對工作流程類型](#matching-workflow-types)
+ [資料輸出選項](#data-output-options)
+ [比對工作流程結果](#matching-workflow-results)
+ [建立規則型比對工作流程](creating-matching-workflow-rule-based.md)
+ [建立以機器學習為基礎的比對工作流程](create-matching-workflow-ml.md)
+ [建立提供者服務型比對工作流程](create-matching-workflow-provider.md)
+ [編輯相符的工作流程](edit-matching-workflow.md)
+ [刪除相符的工作流程](delete-matching-workflow.md)
+ [修改或產生規則型比對工作流程的比對 ID](generate-match-id.md)
+ [查詢規則型比對工作流程的比對 ID](find-match-id.md)
+ [從規則型或 ML 型比對工作流程刪除記錄](delete-records.md)
+ [對相符的工作流程進行故障診斷](troubleshooting.md)
## 比對工作流程類型
AWS Entity Resolution 支援三種類型的相符工作流程：
規則型比對
使用可設定的規則，根據指定欄位的確切或模糊比對來識別相符記錄。您可以定義相符條件，例如類似拼寫的相符名稱，或是格式不同的地址。
以機器學習為基礎的比對
使用機器學習模型來識別類似的記錄，即使資料有變化、錯誤或缺少欄位。這種方法可以偵測比規則型比對更複雜的比對。
供應商服務型比對
使用第三方資料提供者來擴充和驗證您的資料，然後再進行比對。這種類型的比對與 Amazon Connect Customer Profiles 輸出不相容。
## 資料輸出選項
AWS Entity Resolution 可以將資料輸出檔案寫入：
+ 您指定的 Amazon S3 位置
+ Amazon Connect Customer Profiles （用於重複資料刪除）
**重要**
匯出至 Amazon Connect Customer Profiles 與供應商型比對不相容。若要匯出至 Amazon Connect Customer Profiles，您必須使用規則型比對或機器學習型比對。
您可以視需要使用 AWS Entity Resolution 來雜湊輸出資料 – 協助您維持對資料的控制。
下表顯示三種類型的相符工作流程及其支援的輸出目的地。
| 比對類型 | S3 輸出 | 客戶設定檔輸出 |
| --- | --- | --- |
| [規則型](creating-matching-workflow-rule-based.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) 是 |
| [以機器學習為基礎的](create-matching-workflow-ml.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) 是 |
| [提供者服務型](create-matching-workflow-provider.md) | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) 是 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/negative_icon.svg)否 |
## 比對工作流程結果
建立並執行相符的工作流程後，您可以在指定的 S3 位置或 Amazon Connect Customer Profiles 中檢視結果。比對工作流程會在資料編製索引後產生 IDs。
相符的工作流程可以有多個執行，結果 （成功或錯誤） 會寫入名稱`jobId`為 的資料夾。
對於 S3 輸出目的地的每個執行：
+ 資料輸出同時包含成功比對的檔案和錯誤的檔案
+ 成功結果會寫入包含多個檔案的`success`資料夾
+ 錯誤會寫入具有多個欄位的`error`資料夾
對於 Amazon Connect Customer Profiles 輸出目的地的每個執行：
+ 重複資料刪除的客戶記錄會直接傳送到您的 Amazon Connect 執行個體
+ 您可以在 AWS Entity Resolution 主控台中檢視最近的任務歷史記錄
+ Amazon Connect 中的現有設定檔不包含在重複資料刪除程序中
建立並執行相符工作流程之後，您可以使用[規則型比對](creating-matching-workflow-rule-based.md)或[機器學習 (ML) 比對](create-matching-workflow-ml.md)的輸出，做為[提供者服務型比對](create-matching-workflow-provider.md)的輸入，或反之亦然，以滿足您的業務需求。
例如，若要節省提供者訂閱成本，您可以先執行[規則型比對](creating-matching-workflow-rule-based.md)，在資料上尋找相符項目。然後，您可以將一部分不相符的記錄傳送到[提供者服務型比對](create-matching-workflow-provider.md)。請注意，如果您打算匯出至客戶設定檔，您應該僅使用規則型或機器學習型比對。
如需故障診斷錯誤的詳細資訊，請參閱 [對相符的工作流程進行故障診斷](troubleshooting.md)。
# 建立規則型比對工作流程
*[規則型比對](glossary.md#rule-based-matching-defn)*是一套階層式的瀑布比對規則，由 根據您輸入的資料建議 AWS Entity Resolution，且您可以完全設定。規則型比對工作流程可讓您比較純文字或雜湊資料，根據您自訂的條件尋找完全相符項目。
當 AWS Entity Resolution 在資料中找到兩個或多個記錄之間的相符項目時，它會指派：
+ 與相符資料集中記錄相符的 [ID](glossary.md#match-id-defin)
+ 產生相符項目的相符[規則](glossary.md#match-rule-defn)。
在 中建立規則型比對工作流程時 AWS Entity Resolution，您必須選擇**簡單**或**進階**規則類型。規則類型會決定您可以建立的規則條件複雜性。您無法在建立工作流程後變更規則類型。
您可以使用下列圖表來比較兩種**規則類型**，並判斷哪個符合您的使用案例。
**規則類型比較圖表**
| 使用案例 | 進階規則類型 | 簡單規則類型 |
| --- |--- |--- |
| 與輸入類型one-to-one映射的結構描述映射 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) Yes | No |
| --- |--- |--- |
| 具有多個資料欄映射至相同輸入類型的結構描述映射 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/negative_icon.svg) No | Yes |
| --- |--- |--- |
| 支援精確和模糊比對 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) Yes | No (Exact matching only) |
| --- |--- |--- |
| 支援 AND、OR 和括號運算子 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) Yes | No (AND operator only) |
| --- |--- |--- |
| 支援批次工作流程 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) Yes | Yes |
| --- |--- |--- |
| 支援增量工作流程 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/success_icon.svg) Yes | Yes |
| --- |--- |--- |
| 支援即時工作流程 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/negative_icon.svg)No | Yes |
| --- |--- |--- |
| 支援 ID 映射工作流程 | ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/negative_icon.svg) No | Yes |
| --- |--- |--- |
在您決定要使用的規則類型之後，請使用下列主題來建立具有**進階**或**簡單**規則類型的規則型比對工作流程。
**Topics**
+ [使用進階規則類型建立規則型比對工作流程](rule-based-mw-advanced.md)
+ [使用簡易規則類型建立規則型比對工作流程](rule-based-mw-simple.md)
# 使用進階規則類型建立規則型比對工作流程
**先決條件**
建立規則型比對工作流程之前，您必須：
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 個資料輸入。
**注意**
若要使用**進階**規則，您的結構描述映射必須符合下列要求：
除非欄位分組在一起，否則每個輸入欄位都必須對應至唯一的相符索引鍵。
如果輸入欄位分組在一起，它們可以共用相同的相符索引鍵。
例如，下列結構描述映射對**進階**規則有效：
`firstName: { matchKey: 'name', groupName: 'name' }`
`lastName: { matchKey: 'name', groupName: 'name' }`
在此情況下， `firstName`和 `lastName` 欄位會分組在一起，並共用相同的名稱相符索引鍵，這是允許的。
檢閱您的結構描述映射，並更新它們以遵循此one-to-one比對規則，除非欄位已正確分組，以便使用**進階**規則。
如果您的資料表具有 DELETE 資料欄，結構描述映射的類型必須是 `String`，而且您無法擁有 `matchKey`和 `groupName`。
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-advanced.html)
1. （選用） 若要為資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。
1. 選擇**下一步**。
1. 針對**步驟 2：選擇相符的技術**：
1. 針對**比對方法**，選擇**規則型比對**。
1. 針對**規則類型**，選擇**進階**。
![\[選擇比對技術畫面，並選取進階規則型比對選項。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-rule-based-advanced.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. 針對**相符規則**，輸入**規則名稱**，然後根據您的目標從下拉式清單中選擇適當的相符函數和運算子，以建置**規則條件**。
您最多可以建立 25 個規則。
您必須使用 **AND** 運算子結合模糊比對函數 (**Cosine**、**Levenshtein** 或 **Soundex**) 與完全相符的函數 (**Exact**、**ExactManyToMany**)。
您可以使用下表，根據您的目標，協助決定要使用的函數或運算子類型。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/rule-based-mw-advanced.html)
**Example 符合電話號碼和電子郵件的規則條件**
以下是符合電話號碼 (**電話**配對金鑰） 和電子郵件地址 (**電子郵件地址**配對金鑰） 記錄的規則條件範例：
`Exact(Phone,EmptyValues=Process) AND Levenshtein("Email address",2)`
![\[符合電話號碼和電子郵件地址記錄的規則條件範例。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/matching-rule-condition-example.png)
**電話**比對金鑰使用**精確**比對函數來比對相同的字串。**電話**比對金鑰會使用 **EmptyValues=Process** 修飾詞處理比對中的空值。
**電子郵件地址**比對金鑰使用 **Levenshtein** 比對函數，來比對使用預設 Levenshtein Distance 演算法閾值 2 的拼寫錯誤資料。**電子郵件**比對金鑰不會使用任何選用修飾詞。
**AND** 運算子結合了**精確**比對函數和 **Levenshtein** 比對函數。
**Example 使用 ExactManyToMany 執行比對金鑰比對的規則條件**
以下是符合三個地址欄位 (**HomeAddress** 比對金鑰、**BillingAddress** 比對金鑰和 **ShippingAddress** 比對金鑰，透過檢查是否有任何相符項目具有相同值來尋找潛在比對項目的規則條件範例。
`ExactManyToMany` 運算子會評估指定地址欄位的所有可能組合，以識別任何兩個或多個地址之間的完全相符。例如，它會偵測 是否`HomeAddress`與 `BillingAddress`或 相符`ShippingAddress`，或這三個地址是否完全相符。
```
ExactManyToMany(HomeAddress, BillingAddress, ShippingAddress)
```
**Example 使用叢集的規則條件**
在具有模糊條件的進階規則型比對中，系統會先根據完全相符將記錄分組為叢集。形成這些初始叢集後，系統會套用模糊比對篩選條件，以識別每個叢集內的其他相符項目。為了獲得最佳效能，您應該根據資料模式選取完全相符的條件，以建立定義明確的初始叢集。
以下是將多個完全相符項目與模糊比對需求結合的規則條件範例。它使用`AND`運算子來檢查三個欄位 - `FullName`、出生日期 (`DOB`) 和 `Address`- 在記錄之間完全相符。它也允許使用 Levenshtein 距離的 `InternalID` 欄位中的次要變化`1`。Levenshtein 距離會測量將一個字串變更為另一個字串所需的單一字元編輯次數下限。距離為 1 表示它將只比對一個字元 `InternalIDs` （例如單一錯別字、刪除或插入）。這種條件組合有助於識別非常可能代表相同實體的記錄，即使識別符中存在小差異。
```
Exact(FullName) AND Exact(DOB) AND Exact(Address) and Levenshtein(InternalID, 1)
```
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-advanced.html)
1. 選擇**下一步**。
1. 針對**步驟 4：檢閱並建立**：
1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。
1. 選擇 **Create and run (建立並執行)**。
訊息隨即出現，指出已建立相符的工作流程，且任務已開始。
1. 在相符的工作流程詳細資訊頁面的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
+ **任務 ID**。
+ 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗**
+ 工作流程任務的**完成時間**。
+ **處理的記錄**數量。
+ **未處理的記錄**數目。
+ **產生的唯一比對 IDs**。
+ **輸入記錄**的數量。
您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。
1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。
1. （僅限**手動**處理類型） 如果您已使用**手動**處理類型建立**規則型比對**工作流程，您可以在比對工作流程詳細資訊頁面上選擇**執行工作流程**，隨時執行比對工作流程。
1. （僅限**自動**處理類型） 如果您的資料表具有 DELETE 資料欄，則：
+ DELETE 欄中設定為 *true* 的記錄會被刪除。
+ DELETE 欄中設定為 *false* 的記錄會擷取至 S3。
如需詳細資訊，請參閱[步驟 1：準備第一方資料表](prepare-input-data.md#prepare-first-party-tables)。
------
#### [ 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\$10-9-】\$1
+ `inputSourceConfig` （必要） – 1–20 個輸入來源組態的清單
+ `outputSourceConfig` （必要） – 確切有一個輸出來源組態
+ `resolutionTechniques` （必要） – 設定為 "RULE\$1MATCHING" 做為規則型比對的 resolutionType
+ `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
------
# 使用簡易規則類型建立規則型比對工作流程
**先決條件**
建立規則型比對工作流程之前，您必須：
1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。
1. 如果使用 Amazon Connect Customer Profiles 做為輸出目的地，請確定您已設定適當的許可。
下列程序示範如何使用 AWS Entity Resolution 主控台或 `CreateMatchingWorkflow` API，使用 **Simple** 規則類型建立規則型比對工作流程。
------
#### [ 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\$10-9-】\$1
+ `inputSourceConfig` （必要） – 1–20 個輸入來源組態的清單
+ `outputSourceConfig` （必要） – 確切有一個輸出來源組態
+ `resolutionTechniques` （必要） – 將規則型比對設為 "RULE\$1MATCHING"
+ `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
------
# 建立以機器學習為基礎的比對工作流程
*[機器學習型比對](glossary.md#ml-matching-defn)*是一種預設程序，會嘗試比對您輸入所有資料的記錄。機器學習型比對工作流程可讓您比較純文字資料，以使用機器學習模型尋找廣泛的比對。
**注意**
機器學習模型不支援雜湊資料的比較。
當 AWS Entity Resolution 在資料中找到兩個或多個記錄之間的相符項目時，它會指派：
+ 與相符資料集中記錄相符的 [ID](glossary.md#match-id-defin)
+ 配對[可信度層級](glossary.md#confidence-level-defn)百分比。
您可以使用 ML 型比對工作流程的輸出做為資料服務提供者比對的輸入，反之亦然，以符合您的特定目標。例如，您可以執行 ML 型比對，先在您自己的記錄上尋找跨資料來源的比對。如果子集不相符，您可以執行[提供者服務型比對](create-matching-workflow-provider.md)來尋找其他比對。
**先決條件**
建立 ML 型比對工作流程之前，您必須：
1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。
1. 如果使用 Amazon Connect Customer Profiles 做為輸出目的地，請確定您已設定適當的許可。
**若要建立 ML 型比對工作流程：**
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 資料表**，然後選擇對應的**結構描述映射**。
您最多可以新增 20 個資料輸入。
1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。如果您不想標準化資料，請取消選取**標準化資料**選項。
以機器學習為基礎的比對只會標準化 [名稱](glossary.md#normalization-ML-defn-name)、 [Phone](glossary.md#normalization-ML-defn-phone)和 [Email](glossary.md#normalization-ML-defn-email)。
1. 若要指定**服務存取**許可，請選擇 選項並採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-ml.html)
1. （選用） 若要為資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。
1. 選擇**下一步**。
1. 針對**步驟 2：選擇相符的技術**：
1. 針對**比對方法**，選擇**以機器學習為基礎的比對**。
![\[AWS Entity Resolution 搭配規則型或機器學習比對選項的相符工作流程建立界面。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-machine-learning.PNG)
1. 對於**處理節奏**，會選取**手動**選項。
此選項可讓您隨需執行工作流程以進行大量更新。
**注意**
機器學習型比對工作流程不支援自動 （增量） 處理。
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/create-matching-workflow-ml.html)
1. 選擇**下一步**。
1. 針對**步驟 4：檢閱並建立**：
1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。
1. 選擇 **Create and run (建立並執行)**。
訊息隨即出現，指出已建立相符的工作流程，且任務已開始。
1. 在相符的工作流程詳細資訊頁面上的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
+ **任務 ID**。
+ 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗**
+ 工作流程任務的**完成時間**。
+ **處理的記錄**數量。
+ **未處理的記錄**數目。
+ **產生的唯一比對 IDs**。
+ **輸入記錄**的數量。
您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。
1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。
1. （僅限**手動**處理類型） 如果您已使用**手動**處理類型建立**機器學習型相符**工作流程，您可以在相符工作流程詳細資訊頁面上選擇**執行工作流程**，隨時執行相符的工作流程。
# 建立提供者服務型比對工作流程
*[提供者服務型比對](glossary.md#provider-service-matching)*可讓您將已知的識別符與偏好的資料服務提供者比對。
AWS Entity Resolution 目前支援下列資料提供者服務：
+ LiveRamp
+ TransUnion
+ 統一 ID 2.0
如需支援的提供者服務的詳細資訊，請參閱 [準備第三方輸入資料](prepare-third-party-input-data.md)。
您可以在 上對這些提供者使用公有訂閱， AWS Data Exchange 或直接與資料提供者交涉私有優惠。如需建立新訂閱或重複使用現有訂閱至提供者服務的詳細資訊，請參閱 [步驟 1：在 上訂閱提供者服務 AWS Data Exchange](prepare-third-party-input-data.md#subscribe-provider-service)。
下列各節說明如何建立以提供者為基礎的比對工作流程。
**Topics**
+ [使用 LiveRamp 建立相符的工作流程](#create-mw-liveramp)
+ [使用 TransUnion 建立相符的工作流程](#create-mw-transunion)
+ [使用 UID 2.0 建立相符的工作流程](#create-mw-uid)
## 使用 LiveRamp 建立相符的工作流程
LiveRamp 服務提供名為 RampID 的識別符。RampID 是需求端平台中最常用的 IDs 之一，可建立廣告行銷活動的對象。搭配 LiveRamp 使用相符的工作流程，您可以將雜湊電子郵件地址解析為 RAMPIDs。
**注意**
AWS Entity Resolution 支援 PII 型 RampID 指派。
**先決條件**
使用 LiveRamp 建立相符的工作流程之前，您必須：
1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。
1. 訂閱 LiveRamp 服務
1. 將適當的許可設定為您希望暫時寫入相符工作流程輸出的 Amazon S3 資料暫存儲存貯體
使用 LiveRamp 建立 ID 映射工作流程之前，請將下列許可新增至 S3 資料暫存儲存貯體。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::715724997226:root"
},
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketPolicy",
"s3:ListBucketVersions",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
------
將每個 ** 取代為您自己的資訊。
| | |
| --- |--- |
| staging-bucket | Amazon S3 bucket that temporarily stores your data while running a provider service-based workflow. |
**若要使用 LiveRamp 建立相符的工作流程：**
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 資料表**，然後選擇對應的**結構描述映射**。
您最多可以新增 20 個資料輸入。
1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。
**注意**
只有**建立結構描述映射**中的下列案例才支援標準化：
如果將下列**名稱**子類型分組：**名字**、**中間名**、**姓氏**。
如果將下列**地址**子類型分組：**街道地址 1**、**街道地址 2**：**街道地址 3 名稱**、**城市名稱**、**州**、**國家**/地區、**郵遞區號**。
如果將下列**電話**子類型分組：**電話號碼**、**電話國家/地區代碼**。
如果您使用僅限電子郵件的解析程序，請取消選取**標準化資料**選項，因為輸入資料只會使用雜湊電子郵件。
1. 若要指定**服務存取**許可，請選擇 選項並採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. （選用） 若要為資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。
1. 選擇**下一步**。
1. 針對**步驟 2：選擇相符的技術**：
1. 針對**相符方法**，選擇**提供者服務**。
1. 針對**提供者服務**，選擇 **LiveRamp**。
**注意**
確保您的資料輸入檔案格式和標準化符合提供者服務的指導方針。
如需有關相符工作流程的輸入檔案格式準則的詳細資訊，請參閱 LiveRamp 文件中的[透過 ADX 執行身分解析](https://docs.liveramp.com/identity/en/perform-identity-resolution-through-adx.html)。
1. 對於 **LiveRamp 產品**，請從下拉式清單中選擇產品。
![\[已選取 LiveRamp 提供者服務的提供者服務選項。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-liveramp.png)
**注意**
如果您選擇**指派 PII，**則在執行實體解析時必須至少提供一個非識別符資料欄。例如，GENDER。
1. 針對 **LiveRamp 組態**，輸入**用戶端 ID 管理員 ARN** 和**用戶端秘密管理員 ARN**。
![\[LiveRamp 組態表單包含 Client ID Manager ARN 和 Client Secret Manager ARN 的欄位。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-liveramp-config.png)
1. 針對**資料暫存**，選擇 **Amazon S3 位置**，以便在處理資料時暫時儲存資料。
您必須擁有資料暫存 **Amazon S3 位置**的許可。如需詳細資訊，請參閱[為 建立工作流程任務角色 AWS Entity Resolution](create-workflow-job-role.md)。
1. 選擇**下一步**。
1. 對於**步驟 3：指定資料輸出**：
1. 針對**資料輸出目的地和格式**，選擇資料輸出的 **Amazon S3 位置**，以及**資料格式**是**標準化資料**還是**原始資料**。
1. 對於**加密**，如果您選擇**自訂加密設定**，請輸入**AWS KMS 金鑰** ARN。
1. 檢視 **LiveRamp 產生的輸出**。
這是 LiveRamp 產生的額外資訊。
1. 針對**資料輸出**，決定您要包含、隱藏或遮罩的欄位，然後根據您的目標採取建議的動作。
**注意**
如果您已選擇 **LiveRamp**，由於 LiveRamp 隱私權篩選條件會移除個人身分識別資訊 (PII)，某些欄位會顯示**無法使用**的**輸出**狀態。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
![\[AWS Entity Resolution ID 映射工作流程建立界面，具有指定資料輸出位置的選項。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/specify-data-output.PNG)
1. 選擇**下一步**。
1. 針對**步驟 4：檢閱並建立**：
1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。
1. 選擇 **Create and run (建立並執行)**。
訊息隨即出現，指出已建立相符的工作流程，且任務已開始。
1. 在相符的工作流程詳細資訊頁面上的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
+ **任務 ID**。
+ 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗**
+ 工作流程任務**完成的時間**。
+ **處理的記錄**數量。
+ **未處理的記錄**數目。
+ **產生的唯一比對 IDs**。
+ **輸入記錄**的數量。
您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。
1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。
## 使用 TransUnion 建立相符的工作流程
如果您訂閱 TransUnion 服務，您可以透過使用 TransUnion Person 和 Household E Keys 以及超過 200 個資料屬性，連結、比對和增強跨不同管道存放的客戶相關記錄，以改善客戶理解。
TransUnion 服務提供稱為 TransUnion Individual 和 Household IDs識別符。TransUnion 提供已知識別符的 ID 指派 （也稱為編碼），例如名稱、地址、電話號碼和電子郵件地址。
**先決條件**
使用 LiveRamp 建立相符的工作流程之前，您必須：
1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。
1. 擁有 TransUnion 服務的訂閱
1. 將適當的許可設定為您希望暫時寫入相符工作流程輸出的 Amazon S3 資料暫存儲存貯體
使用 TransUnion 建立相符的工作流程之前，請將下列許可新增至 S3 資料預備儲存貯體。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::381491956555:root"
},
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:GetObjectVersion",
"s3:DeleteObject"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::381491956555:root"
},
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:GetBucketPolicy",
"s3:ListBucketVersions",
"s3:GetBucketAcl"
],
"Resource": [
"arn:aws:s3:::",
"arn:aws:s3:::/*"
]
}
]
}
```
------
將每個 ** 取代為您自己的資訊。
| | |
| --- |--- |
| staging-bucket | Amazon S3 bucket that temporarily stores your data while running a provider service-based workflow. |
**若要使用 TransUnion 建立相符的工作流程：**
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 資料表**，然後選擇對應的**結構描述映射**。
您最多可以新增 20 個資料輸入。
1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。如果您不想標準化資料，請取消選取**標準化資料**選項。
**注意**
只有**建立結構描述映射**中的下列案例才支援標準化：
如果將下列**名稱**子類型分組：**名字**、**中間名**、**姓氏**。
如果將下列**地址**子類型分組：**街道地址 1**、**街道地址 2**：**街道地址 3 名稱**、**城市名稱**、**州**、**國家**/地區、**郵遞區號**。
如果將下列**電話**子類型分組：**電話號碼**、**電話號碼國家/地區代碼**。
1. 若要指定**服務存取**許可，請選擇 選項並採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. （選用） 若要為資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。
1. 選擇**下一步**。
1. 針對**步驟 2：選擇相符的技術**：
1. 針對**相符方法**，選擇**提供者服務**。
1. 針對**提供者服務**，選擇 **TransUnion**。
**注意**
確保您的資料輸入檔案格式和標準化符合提供者服務的指導方針。
![\[已選取 TransUnion 提供者服務的提供者服務選項。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-transunion.PNG)
1. 針對**資料預備**，選擇 **Amazon S3 位置**，以便在處理資料時暫時儲存資料。
您必須擁有資料暫存 **Amazon S3 位置**的許可。如需詳細資訊，請參閱[為 建立工作流程任務角色 AWS Entity Resolution](create-workflow-job-role.md)。
1. 選擇**下一步**。
1. 針對**步驟 3：指定資料輸出**：
1. 針對**資料輸出目的地和格式**，選擇資料輸出的 **Amazon S3 位置**，以及**資料格式**是**標準化資料**還是**原始資料**。
1. 對於**加密**，如果您選擇**自訂加密設定**，請輸入**AWS KMS 金鑰** ARN。
1. 檢視 **TransUnion 產生的輸出**。
這是 TransUnion 產生的額外資訊。
1. 對於**資料輸出**，決定您要包含、隱藏或遮罩的欄位，然後根據您的目標採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. 對於**系統產生的輸出**，檢視包含的所有欄位。
1. 選擇**下一步**。
1. 針對**步驟 4：檢閱並建立**：
1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。
1. 選擇 **Create and run (建立並執行)**。
訊息隨即出現，指出已建立相符的工作流程，且任務已開始。
1. 在相符的工作流程詳細資訊頁面的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
+ **任務 ID**。
+ 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗**
+ 工作流程任務的**完成時間**。
+ **處理的記錄**數量。
+ **未處理的記錄**數目。
+ **產生的唯一比對 IDs**。
+ **輸入記錄**的數量。
您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。
1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。
## 使用 UID 2.0 建立相符的工作流程
如果您有 Unified ID 2.0 服務的訂閱，您可以啟動具有確定性身分的廣告行銷活動，並倚賴與廣告生態系統中許多UID2-enabled的參與者的互通性。如需詳細資訊，請參閱[統一 ID 2.0 概觀。]( https://unifiedid.com/docs/intro)
統一 ID 2.0 服務提供原始 UID 2，用於在 Trade Desk 平台中建立廣告活動。UID 2.0 是使用開放原始碼架構產生。
在一個工作流程中，您可以使用 **Email Address**或 **Phone number** 產生原始 UID2，但不能同時使用兩者。如果結構描述映射中同時存在兩者，則工作流程會挑選 **Email Address**，而 **Phone number**將是傳遞欄位。若要支援兩者，請建立新的結構描述映射，其中 **Phone number** 已映射**Email Address**但未映射。然後，使用此新的結構描述映射建立第二個工作流程。
**注意**
原始 UID2s的建立方式是新增來自鹽儲存貯體的鹽，該鹽儲存貯體大約每年輪換一次，導致原始 UID2 也會隨之輪換。因此，建議您每天重新整理原始 UID2s。如需詳細資訊，請參閱 https：//[https://unifiedid.com/docs/getting-started/gs-faqs\$1how-often-should-uid2s-be-refreshed-for-incremental-updates](https://unifiedid.com/docs/getting-started/gs-faqs#how-often-should-uid2s-be-refreshed-for-incremental-updates)。
**先決條件**
使用 UID 2.0 建立相符的工作流程之前，您必須：
1. 建立結構描述映射。如需詳細資訊，請參閱[建立結構描述映射](create-schema-mapping.md)。
1. 擁有 UID 2.0 服務的訂閱
**若要使用 UID 2.0 建立相符的工作流程：**
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 資料表**，然後選擇對應的**結構描述映射**。
您最多可以新增 20 個資料輸入。
1. 保留已選取**標準化資料**選項，以便在比對之前標準化資料輸入 (**Email Address** 或 **Phone number**)。
如需**Email Address**標準化的詳細資訊，請參閱 UID 2.0 文件中的[電子郵件地址標準化](https://unifiedid.com/docs/getting-started/gs-normalization-encoding#email-address-normalization)。
如需**Phone number**標準化的詳細資訊，請參閱 UID 2.0 文件中的[電話號碼標準化](https://unifiedid.com/docs/getting-started/gs-normalization-encoding#phone-number-normalization)。
1. 若要指定**服務存取**許可，請選擇 選項並採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. （選用） 若要為資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。
1. 選擇**下一步**。
1. 針對**步驟 2：選擇相符的技術**：
1. 針對**相符方法**，選擇**提供者服務**。
1. 針對**提供者服務**，選擇**統一 ID 2.0。**
![\[已選取統一 ID 提供者服務的提供者服務選項。\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/images/choose-matching-method-uid.PNG)
1. 選擇**下一步**。
1. 針對**步驟 3：指定資料輸出**：
1. 針對**資料輸出目的地和格式**，選擇資料輸出的 **Amazon S3 位置**，以及**資料格式**是**標準化資料**還是**原始資料**。
1. 對於**加密**，如果您選擇**自訂加密設定**，請輸入**AWS KMS 金鑰** ARN。
1. 檢視 **Unified ID 2.0 產生的輸出。**
這是 UID 2.0 所產生的所有其他資訊清單
1. 對於**資料輸出**，決定您要包含、隱藏或遮罩的欄位，然後根據您的目標採取建議的動作。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/create-matching-workflow-provider.html)
1. 對於**系統產生的輸出**，檢視包含的所有欄位。
1. 選擇**下一步**。
1. 針對**步驟 4：檢閱並建立**：
1. 檢閱您針對先前步驟所做的選擇，並視需要編輯。
1. 選擇 **Create and run (建立並執行)**。
訊息隨即出現，指出已建立相符的工作流程，且任務已開始。
1. 在相符的工作流程詳細資訊頁面的**指標**索引標籤上，檢視**最後一個任務指標**下的下列項目：
+ **任務 ID**。
+ 相符工作流程任務**的狀態**：**已佇列**、**進行中**、**已完成**、**失敗**
+ 工作流程任務的**完成時間**。
+ **處理的記錄**數量。
+ **未處理的記錄**數目。
+ **產生的唯一比對 IDs**。
+ **輸入記錄**的數量。
您也可以檢視先前已在任務**歷史記錄**下執行之相符工作流程任務的任務指標。
1. 比對工作流程任務完成後 (**狀態**為**已完成**)，您可以前往**資料輸出**索引標籤，然後選取您的 **Amazon S3 位置**以檢視結果。
# 編輯相符的工作流程
編輯相符的工作流程可讓您讓實體解析程序保持在up-to-date，並回應組織隨時間變化的需求。您可能想要調整相符條件、技術或資料輸出，以提高實體解析程序的準確性和效率。如果您在目前工作流程的結果中發現問題或錯誤，編輯它可協助您診斷和解決這些問題。
**若要編輯相符的工作流程：**
1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 開啟 AWS Entity Resolution 主控台。
1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。
1. 選擇相符的工作流程。
1. 在相符的工作流程詳細資訊頁面上，選擇右上角的**編輯工作流程**。
1. 在**指定相符的工作流程詳細資訊**頁面上，進行任何必要的變更，然後選擇**下一步**。
1. 在**選擇相符的技術**頁面上，進行任何必要的變更，然後選擇**下一步**。
**重要**
您可以將**處理節奏**從**手動**變更為**自動**，但在變更為**自動**之後，您無法將其變更回**手動**。
如果**處理節奏**已設定為**自動**，則您無法將其變更為**手動**。
1. 在**指定資料輸出**頁面上，進行任何必要的變更，然後選擇**下一步**。
1. 在**檢閱和儲存**頁面上，進行任何必要的變更，然後選擇**儲存**。
# 刪除相符的工作流程
如果不再使用相符的工作流程或已淘汰，刪除它有助於保持工作區井然有序。如果您開發了新的改進工作流程來取代舊工作流程，刪除舊工作流程有助於確保您僅使用up-to-date程序。
**若要刪除相符的工作流程：**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 開啟 AWS Entity Resolution 主控台。
1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。
1. 選擇相符的工作流程。
1. 在相符的工作流程詳細資訊頁面的右上角，選擇**刪除**。
1. 確認刪除，然後選擇**刪除**。
# 修改或產生規則型比對工作流程的比對 ID
*相符 ID* 是執行相符工作流程後，由 產生 AWS Entity Resolution 並套用至每個相符記錄集的識別符。這是輸出中包含的相符工作流程中繼資料的一部分。
當您需要更新現有客戶的記錄或將新客戶新增至資料集時，您可以使用 AWS Entity Resolution 主控台或 `GenerateMatchID` API。修改現有的比對 ID 有助於在更新客戶資訊時保持一致性，同時在將先前無法識別的客戶新增至系統時，需要產生新的比對 ID。
**注意**
無論您使用 主控台或 API，都會產生額外費用。您選擇的處理類型會影響操作的準確性和回應時間。
**重要**
如果您在任務進行時撤銷對 S3 儲存貯體的 AWS Entity Resolution 許可， AWS Entity Resolution 仍會處理結果輸出至 S3 並收取費用，但無法將結果交付至您的儲存貯體。若要避免此問題，請先確定 AWS Entity Resolution 具有寫入 S3 儲存貯體的正確許可，再啟動任務。如果在處理期間撤銷許可， AWS Entity Resolution 會在您還原正確的儲存貯體許可後，嘗試在任務完成後最多 30 天內重新交付結果。
下列程序會引導您完成查詢或產生相符 ID、選取處理類型，以及檢視結果的程序。
------
#### [ Console ]
**使用主控台修改或產生相符 ID**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 開啟 AWS Entity Resolution 主控台。
1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。
1. 選擇已處理的規則型比對工作流程 (**任務狀態**為**已完成**)。
1. 在相符工作流程詳細資訊頁面上，選擇**相符 IDs**索引標籤。
1. 選擇**修改或產生比對 ID**。
**注意**
**修改或產生比對 ID** 選項僅適用於使用**自動**處理節奏的比對工作流程。如果您已選取**手動**處理節奏，此選項將顯示為非作用中。若要使用此選項，請編輯工作流程以使用**自動**處理節奏。如需編輯工作流程的詳細資訊，請參閱 [編輯相符的工作流程](edit-matching-workflow.md)。
1. 從下拉式清單中選取**AWS Glue 資料表**。
如果工作流程中只有一個 AWS Glue 資料表，預設會選取它。
1. 選擇**處理類型**。
+ **一致** – 您可以查詢現有的配對 ID，或立即產生並儲存新的配對 ID。此選項具有最高的準確度和較慢的回應時間。
+ **背景** （在 API `EVENTUAL` 中顯示為 ) – 您可以立即查詢現有的比對 ID 或產生新的比對 ID。更新的記錄會儲存在背景中。此選項具有快速的初始回應，並在稍後於 S3 中提供完整的結果。
+ **快速產生 ID** （在 API `EVENTUAL_NO_LOOKUP`中顯示為 ) – 您可以建立新的比對 ID，而無需查詢現有的比對 ID。更新的記錄會儲存在背景中。此選項具有最快的回應。建議僅用於唯一記錄。
1. 對於**記錄屬性**，
1. 輸入**唯一 ID** **的值**。
1. 根據您工作流程中設定的規則，輸入與現有記錄相符的每個**相符金鑰****的值**。
1. 選擇**尋找相符 ID 並儲存記錄**。
顯示成功訊息，指出找到相符 ID 或產生新的相符 ID，並儲存記錄。
1. 在成功訊息中檢視對應的相符 ID 和儲存到相符工作流程的相關規則。
1. （選用） 若要複製比對 ID，請選擇**複製**。
------
#### [ API ]
**使用 API 修改或產生相符 ID**
**注意**
若要成功呼叫此 API，您必須先使用 [StartMatchingJob API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) 成功執行規則型比對工作流程。
如需支援之程式設計語言的完整清單，請參閱 [GenerateMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html) 的[另請參閱](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso)一節。
1. 開啟終端機或命令提示以提出 API 請求。
1. 建立對下列端點的 POST 請求：
```
/matchingworkflows/workflowName/generateMatches
```
1. 在請求標頭中，將 Content-type 設定為 application/json。
1. 在請求 URI 中，指定您的 `workflowName`。
必須`workflowName`：
+ 長度介於 1 到 255 個字元之間
+ 符合模式 【a-zA-Z\$10-9-】\$1
1. 針對請求內文，請提供下列 JSON：
```
{
"processingType": "string",
"records": [
{
"inputSourceARN": "string",
"recordAttributeMap": {
"string" : "string"
},
"uniqueId": "string"
}
]
}
```
其中：
+ `processingType` （選用） - 預設為 `CONSISTENT`。選擇下列其中一個值：
+ `CONSISTENT` - 提供最高準確度和較慢的回應時間
+ `EVENTUAL` - 使用背景處理更快速的初始回應
+ `EVENTUAL_NO_LOOKUP` - 已知記錄是唯一的記錄時，提供最快的回應
+ `records` （必要） - 僅包含一個記錄物件的陣列
1. 傳送 請求。
如果成功，您會收到狀態碼為 200 的回應，以及包含下列項目的 JSON 內文：
```
{
"failedRecords": [
{
"errorMessage": "string",
"inputSourceARN": "string",
"uniqueId": "string"
}
],
"matchGroups": [
{
"matchId": "string",
"matchRule": "string",
"records": [
{
"inputSourceARN": "string",
"recordId": "string"
}
]
}
]
}
```
如果呼叫失敗，您可能會收到下列其中一個錯誤：
+ 403 - 如果您沒有足夠的存取權，則為 AccessDeniedException
+ 如果找不到資源，則為 404 - ResourceNotFoundException
+ 429 - 如果請求已調節，則 ThrottlingException
+ 400 - 如果輸入驗證失敗，則 ValidationException
+ 500 - 如果發生內部服務故障，則為 InternalServerException
------
# 查詢規則型比對工作流程的比對 ID
完成規則型比對工作流程後，您可以擷取每個已處理記錄的比對 ID 和相關規則。此資訊可協助您了解記錄的比對方式，以及套用了哪些規則。下列程序示範如何使用 AWS Entity Resolution 主控台或 `GetMatchID` API 存取此資料。
------
#### [ Console ]
**使用主控台查詢相符 ID**
1. 登入 AWS 管理主控台 並在 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 開啟 AWS Entity Resolution 主控台。
1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。
1. 選擇已處理的規則型比對工作流程 (**任務狀態**為**已完成**)。
1. 在相符工作流程詳細資訊頁面上，選擇**相符 IDs**索引標籤。
1. 選擇**查詢比對 ID**。
**注意**
**查詢相符 ID** 選項僅適用於使用**自動**處理節奏的相符工作流程。如果您已選取**手動**處理節奏，此選項將顯示為非作用中。若要使用此選項，請編輯工作流程以使用**自動**處理節奏。如需編輯工作流程的詳細資訊，請參閱 [編輯相符的工作流程](edit-matching-workflow.md)。
1. 執行以下任意一項：
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/find-match-id.html)
1. 針對**記錄屬性**，輸入現有**相符金鑰****的值**，以查詢每個現有記錄。
**提示**
輸入盡可能多的值，以協助尋找相符 ID。
1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。如果您不想標準化資料，請取消選取**標準化資料**選項。
1. 如果您想要檢視相符規則，請展開**檢視相符規則**。
1. 選擇 **Look up** (查閱)。
隨即出現成功訊息，指出找到相符 ID。
1. 檢視對應的相符 ID 和找到的相關聯規則。
------
#### [ API ]
**使用 API 查詢相符 ID**
**注意**
若要成功呼叫此 API，您必須先使用 [StartMatchingJob API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) 成功執行規則型比對工作流程。
如需支援之程式設計語言的完整清單，請參閱 [GetMatchID API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html) 的[另請參閱](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso)一節。
1. 開啟終端機或命令提示以提出 API 請求。
1. 建立對下列端點的 POST 請求：
```
/matchingworkflows/workflowName/matches
```
1. 在請求標頭中，將 Content-type 設定為 application/json。
1. 在請求 URI 中，指定您的 `workflowName`。
必須`workflowName`：
+ 長度介於 1 到 255 個字元之間
+ 符合模式 【a-zA-Z\$10-9-】\$1
1. 針對請求內文，請提供下列 JSON：
```
{
"applyNormalization": boolean,
"record": {
"string" : "string"
}
}
```
其中：
`applyNormalization` （選用） - 設定為 `true`以標準化結構描述中定義的屬性
`record` （必要） - 要擷取 相符 ID 的記錄
1. 傳送 請求。
如果成功，您會收到狀態碼為 200 的回應，以及包含下列項目的 JSON 內文：
```
{
"matchId": "string",
"matchRule": "string"
}
```
`matchId` 是此相符記錄群組的唯一識別符，並`matchRule`指出記錄相符的規則。
如果呼叫失敗，您可能會收到下列其中一個錯誤：
+ 403 - 如果您沒有足夠的存取權，則為 AccessDeniedException
+ 如果找不到資源，則為 404 - ResourceNotFoundException
+ 429 - 如果請求已調節，則 ThrottlingException
+ 400 - 如果輸入驗證失敗，則 ValidationException
+ 500 - 如果發生內部服務故障，則為 InternalServerException
------
# 從規則型或 ML 型比對工作流程刪除記錄
如果您需要遵守資料管理法規，您可以從規則型或 ML 型比對工作流程中刪除記錄。
**從規則型或 ML 型比對工作流程中刪除記錄**
1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 的 AWS Entity Resolution 主控台。
1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。
1. 選擇規則型或 ML 型比對工作流程。
1. 在相符的工作流程詳細資訊頁面上，從**動作**下拉式清單中選擇**刪除唯一 IDs** 。
1. 在唯一 ID 區段中輸入您要刪除**的唯一 IDs**。
您最多可以輸入 10 IDs。
1. 指定要從中刪除唯一 IDs的**輸入來源**。
如果工作流程只有一個**輸入來源**，預設會列出**輸入來源**。
如果您只指定一個**輸入來源**，則其他輸入來源中的唯一 IDs 不會受到影響。
1. 選擇**刪除唯一 IDs**。
# 對相符的工作流程進行故障診斷
使用以下資訊來協助您診斷和修正執行相符工作流程時可能遇到的常見問題。
## 我在執行相符的工作流程後收到錯誤檔案
### 常見原因
相符的工作流程可以有多個執行，並將結果 （成功或錯誤） 寫入名稱`jobId`為 的資料夾。
相符工作流程的成功結果會寫入包含多個檔案的`success`資料夾，而每個檔案都包含成功記錄的子集。
相符工作流程的錯誤會寫入具有多個欄位的`error`資料夾，每個欄位都包含錯誤記錄的子集。
錯誤檔案的建立原因如下：
+ [唯一 ID](glossary.md#unique-id-defn) 為：
+ null
+ 資料列中遺失
+ 資料表中記錄中遺失
+ 在資料表中的另一列資料中重複
+ 未指定
+ 在相同來源中不是唯一的
+ 跨多個來源不是唯一的
+ 跨來源重疊
+ 超過 38 個字元 （僅限規則型比對工作流程）
+ [結構描述映射](glossary.md#schema-mapping-definition)中的其中一個欄位包含預留名稱：
+ EmailAddress
+ InputSourceARN
+ MatchRule
+ MatchID
+ HashingProtocol
+ ConfidenceLevel
+ 來源
**注意**
如果錯誤檔案中的記錄是由於先前列出的原因建立的，則會向您收取費用，因為它會產生服務的處理成本。如果錯誤檔案中的記錄是由於內部伺服器錯誤，則不會向您收取費用。
### Resolution
**解決此問題**
1. 檢查[唯一 ID](glossary.md#unique-id-defn) 是否有效。
如果[唯一 ID](glossary.md#unique-id-defn) 無效，請在資料表中更新唯一 ID、儲存新資料表、建立新的結構描述映射，然後再次執行相符的工作流程。
1. 檢查[結構描述映射](glossary.md#schema-mapping-definition)中的其中一個欄位是否包含預留名稱。
如果其中一個欄位包含預留名稱，請使用新名稱建立新的結構描述映射，然後再次執行相符的工作流程。