Búsqueda de un identificador de coincidencia para un flujo de trabajo de coincidencia basado en reglas - AWS Entity Resolution

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Búsqueda de un identificador de coincidencia para un flujo de trabajo de coincidencia basado en reglas

Tras completar un flujo de trabajo de coincidencia basado en reglas, puede recuperar el identificador de coincidencia y la regla asociada para cada registro procesado. Esta información le ayuda a comprender cómo se compararon los registros y qué reglas se aplicaron. El siguiente procedimiento muestra cómo acceder a estos datos mediante la AWS Entity Resolution consola o la GetMatchID API.

Console
Para buscar un Match ID mediante la consola

  1. Inicia sesión en AWS Management Console y abre la AWS Entity Resolution consola en https://console.aws.amazon.com/entityresolution/.

  2. En el panel de navegación izquierdo, en Flujos de trabajo, selecciona Matching.

  3. Elija el flujo de trabajo coincidente basado en reglas que se ha procesado (el estado del trabajo es Completado).

  4. En la página de detalles del flujo de trabajo coincidente, seleccione la pestaña Coincidencia IDs.

  5. Selecciona Buscar ID de coincidencia.

  6. Realice una de las siguientes acciones:

    Si... Entonces...
    Solo hay un esquema de mapeo asociado a este flujo de trabajo. Vea el mapeo de esquemas que está seleccionado de forma predeterminada.
    Hay más de un mapeo de esquemas asociado a este flujo de trabajo. Elija el mapeo de esquemas en la lista desplegable.

  7. En el caso de los atributos del registro, introduzca el valor de una clave de coincidencia existente para buscar cada registro existente.

    sugerencia

    Introduce tantos valores como puedas para ayudarte a encontrar el identificador de coincidencia.

  8. La opción Normalizar datos está seleccionada de forma predeterminada, de modo que las entradas de datos se normalizan antes de la coincidencia. Si no desea normalizar los datos, deseleccione la opción Normalizar datos.

  9. Si desea ver las reglas de coincidencia, expanda la opción Ver reglas de coincidencia.

  10. Elija Look up (Buscar).

    Aparece un mensaje de confirmación que indica que se ha encontrado el identificador de coincidencia.

  11. Vea el identificador de coincidencia correspondiente y la regla asociada que se encontró.

API
Para buscar un identificador de coincidencia mediante la API
nota

Para llamar a esta API correctamente, primero debes haber ejecutado correctamente un flujo de trabajo de coincidencia basado en reglas mediante la StartMatchingJob API.

Para obtener una lista completa de los lenguajes de programación compatibles, consulta la sección Vea también de la API de GetMatchID.

  1. Abre un terminal o una línea de comandos para realizar la solicitud de API.

  2. Crea una solicitud POST para el siguiente punto final: 

    /matchingworkflows/workflowName/matches

  3. En el encabezado de la solicitud, establece el tipo de contenido en application/json.

  4. En el URI de la solicitud, especifique su. workflowName

    El workflowName debe:

    • Debe tener una longitud de entre 1 y 255 caracteres

    • Coincide con el patrón [a-zA-z_0-9-] *

  5. Para el cuerpo de la solicitud, proporciona el siguiente JSON: 

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

    Donde:

    applyNormalization(opcional): configúrelo en true para normalizar los atributos definidos en el esquema

    record(obligatorio): el registro del que se va a buscar el identificador de coincidencia

  6. Envíe la solicitud .

    Si se ejecuta correctamente, recibirás una respuesta con el código de estado 200 y un cuerpo JSON que contiene: 

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

    matchIdEs el identificador único de este grupo de registros coincidentes e matchRule indica la regla con la que coincide el registro.

    Si la llamada no se realiza correctamente, es posible que recibas uno de los siguientes errores:

    • 403: AccessDeniedException si no tienes acceso suficiente

    • 404: ResourceNotFoundException si no se puede encontrar el recurso

    • 429: ThrottlingException si la solicitud se ha limitado

    • 400: ValidationException si la entrada no pasa la validación

    • 500: InternalServerException si hay un fallo en el servicio interno