查詢規則型比對工作流程的比對 ID - AWS Entity Resolution

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

查詢規則型比對工作流程的比對 ID

完成規則型比對工作流程後,您可以擷取每個已處理記錄的比對 ID 和相關規則。此資訊可協助您了解記錄的比對方式,以及套用了哪些規則。下列程序示範如何使用 AWS Entity Resolution 主控台或 GetMatchID API 存取此資料。

Console
使用主控台查詢相符 ID
  1. 登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/entityresolution/ 開啟 AWS Entity Resolution 主控台。

  2. 在左側導覽窗格中的工作流程下,選擇相符

  3. 選擇已處理的規則型比對工作流程 (任務狀態已完成)。

  4. 在相符工作流程詳細資訊頁面上,選擇相符 IDs索引標籤。

  5. 選擇查詢比對 ID

  6. 執行以下任意一項:

    如果 ... 然後 ...
    只有一個結構描述映射與此工作流程相關聯。 檢視預設選取的結構描述映射
    有一個以上的結構描述映射與此工作流程相關聯。 從下拉式清單中選擇結構描述映射
  7. 針對記錄屬性,輸入現有相符金鑰的值,以查詢每個現有記錄。

    提示

    輸入盡可能多的值,以協助尋找相符 ID。

  8. 預設會選取標準化資料選項,以便在比對之前標準化資料輸入。如果您不想標準化資料,請取消選取標準化資料選項。

  9. 如果您想要檢視相符規則,請展開檢視相符規則

  10. 選擇 Look up (查閱)。

    隨即出現成功訊息,指出找到相符 ID。

  11. 檢視對應的相符 ID 和找到的相關聯規則。

API
使用 API 查詢相符 ID
注意

若要成功呼叫此 API,您必須先使用 StartMatchingJob API 成功執行規則型比對工作流程。

如需支援之程式設計語言的完整清單,請參閱 GetMatchID API另請參閱一節。

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

  2. 建立對下列端點的 POST 請求:

    /matchingworkflows/workflowName/matches
  3. 在請求標頭中,將 Content-type 設定為 application/json。

  4. 在請求 URI 中,指定您的 workflowName

    必須workflowName

    • 長度介於 1 到 255 個字元之間

    • 比對模式 【a-zA-Z_0-9-】*

  5. 針對請求內文,請提供下列 JSON:

    { "applyNormalization": boolean, "record": { "string" : "string" } }

    其中:

    applyNormalization (選用) - 設定為 true以標準化結構描述中定義的屬性

    record (必要) - 要擷取 相符 ID 的記錄

  6. 傳送 請求。

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

    { "matchId": "string", "matchRule": "string" }

    matchId 是此相符記錄群組的唯一識別符,並matchRule指出記錄相符的規則。

    如果呼叫失敗,您可能會收到下列其中一個錯誤:

    • 403 - 如果您沒有足夠的存取權,則為 AccessDeniedException

    • 如果找不到資源,則為 404 - ResourceNotFoundException

    • 429 - 如果請求已調節,則 ThrottlingException

    • 400 - 如果輸入驗證失敗,則 ValidationException

    • 500 - 如果內部服務失敗,則為 InternalServerException