本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
查詢規則型比對工作流程的比對 ID
完成規則型比對工作流程後,您可以擷取每個已處理記錄的比對 ID 和相關規則。此資訊可協助您了解記錄的比對方式,以及套用了哪些規則。下列程序示範如何使用 AWS Entity Resolution 主控台或 GetMatchID
API 存取此資料。
- Console
-
使用主控台查詢相符 ID
-
登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/entityresolution/
開啟 AWS Entity Resolution 主控台。 -
在左側導覽窗格中的工作流程下,選擇相符。
-
選擇已處理的規則型比對工作流程 (任務狀態為已完成)。
-
在相符工作流程詳細資訊頁面上,選擇相符 IDs索引標籤。
-
選擇查詢比對 ID。
-
執行以下任意一項:
如果 ... 然後 ... 只有一個結構描述映射與此工作流程相關聯。 檢視預設選取的結構描述映射。 有一個以上的結構描述映射與此工作流程相關聯。 從下拉式清單中選擇結構描述映射。 -
針對記錄屬性,輸入現有相符金鑰的值,以查詢每個現有記錄。
提示
輸入盡可能多的值,以協助尋找相符 ID。
-
預設會選取標準化資料選項,以便在比對之前標準化資料輸入。如果您不想標準化資料,請取消選取標準化資料選項。
-
如果您想要檢視相符規則,請展開檢視相符規則。
-
選擇 Look up (查閱)。
隨即出現成功訊息,指出找到相符 ID。
-
檢視對應的相符 ID 和找到的相關聯規則。
-
- API
-
使用 API 查詢相符 ID
注意
若要成功呼叫此 API,您必須先使用 StartMatchingJob API 成功執行規則型比對工作流程。
如需支援之程式設計語言的完整清單,請參閱 GetMatchID API 的另請參閱一節。
-
開啟終端機或命令提示以提出 API 請求。
-
建立對下列端點的 POST 請求:
/matchingworkflows/workflowName/matches
-
在請求標頭中,將 Content-type 設定為 application/json。
-
在請求 URI 中,指定您的
workflowName
。必須
workflowName
:-
長度介於 1 到 255 個字元之間
-
比對模式 【a-zA-Z_0-9-】*
-
-
針對請求內文,請提供下列 JSON:
{ "applyNormalization": boolean, "record": { "string" : "string" } }
其中:
applyNormalization
(選用) - 設定為true
以標準化結構描述中定義的屬性record
(必要) - 要擷取 相符 ID 的記錄 -
傳送 請求。
如果成功,您會收到狀態碼為 200 的回應,以及包含下列項目的 JSON 內文:
{ "matchId": "string", "matchRule": "string" }
matchId
是此相符記錄群組的唯一識別符,並matchRule
指出記錄相符的規則。如果呼叫失敗,您可能會收到下列其中一個錯誤:
-
403 - 如果您沒有足夠的存取權,則為 AccessDeniedException
-
如果找不到資源,則為 404 - ResourceNotFoundException
-
429 - 如果請求已調節,則 ThrottlingException
-
400 - 如果輸入驗證失敗,則 ValidationException
-
500 - 如果內部服務失敗,則為 InternalServerException
-
-