Modificar o generar un identificador de coincidencia para un flujo de trabajo coincidente 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.

Modificar o generar un identificador de coincidencia para un flujo de trabajo coincidente basado en reglas

Un ID de coincidencia es el identificador generado AWS Entity Resolution y aplicado a cada conjunto de registros coincidentes después de ejecutar un flujo de trabajo coincidente. Esto forma parte de los metadatos coincidentes del flujo de trabajo que se incluyen en la salida.

Cuando necesites actualizar los registros de un cliente existente o añadir un cliente nuevo a tu conjunto de datos, puedes usar la AWS Entity Resolution consola o la GenerateMatchID API. La modificación de una ID de coincidencia existente ayuda a mantener la coherencia a la hora de actualizar la información del cliente, mientras que es necesario generar una nueva ID de coincidencia cuando se añaden al sistema clientes no identificados anteriormente.

nota

Se aplican cargos adicionales, ya sea que utilices la consola o la API. El tipo de procesamiento que elija afecta tanto a la precisión como al tiempo de respuesta de la operación.

importante

Si revoca AWS Entity Resolution los permisos de su bucket de S3 mientras hay un trabajo en curso, AWS Entity Resolution seguirá procesando y cobrando por enviar los resultados a S3, pero no podrá entregarlos a su bucket. Para evitar este problema, asegúrate de tener los AWS Entity Resolution permisos correctos para escribir en tu bucket de S3 antes de iniciar un trabajo. Si los permisos se revocan durante el procesamiento, AWS Entity Resolution intenta volver a entregar los resultados hasta 30 días después de haber completado el trabajo, una vez que hayas restablecido los permisos correctos del bucket.

El siguiente procedimiento le guiará por el proceso de buscar o generar un Match ID, seleccionar un tipo de procesamiento y ver los resultados.

Console
Para modificar o generar un identificador de coincidencia mediante la consola

  1. Inicie sesión en AWS Management Console y abra 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. Seleccione Modificar o generar el ID de coincidencia.

    nota

    La opción Modificar o generar el ID de coincidencia solo está disponible para los flujos de trabajo coincidentes que utilizan la cadencia de procesamiento automática. Si ha seleccionado la cadencia de procesamiento manual, esta opción aparecerá inactiva. Para usar esta opción, edite su flujo de trabajo para usar la cadencia de procesamiento automática. Para obtener más información sobre la edición de flujos de trabajo, consulteEdición de un flujo de trabajo coincidente.

  6. Seleccione la AWS Glue tabla en la lista desplegable.

    Si solo hay una AWS Glue tabla en el flujo de trabajo, se selecciona de forma predeterminada.

  7. Elija el tipo de procesamiento.

    • Coherente: puede buscar una ID de coincidencia existente o generar y guardar una nueva ID de coincidencia inmediatamente. Esta opción tiene la mayor precisión y el tiempo de respuesta más lento.

    • Antecedentes (se muestran como EVENTUAL en la API): puedes buscar un identificador de coincidencia existente o generar uno nuevo de forma inmediata. El registro actualizado se guarda en segundo plano. Esta opción tiene una respuesta inicial rápida, y los resultados completos estarán disponibles más adelante en S3.

    • Generación rápida de identificadores (se muestra como EVENTUAL_NO_LOOKUP en la API): puedes crear un nuevo identificador de coincidencia sin tener que buscar uno existente. El registro actualizado se guarda en segundo plano. Esta opción tiene la respuesta más rápida. Se recomienda solo para registros únicos.

  8. Para los atributos de registro,

    1. Introduzca el valor del identificador único.

    2. Introduzca un valor para cada clave de coincidencia que coincida con los registros existentes en función de las reglas configuradas en su flujo de trabajo.

  9. Elija Buscar ID de coincidencia y guarde el registro.

    Aparece un mensaje de confirmación que indica que se ha encontrado el identificador de coincidencia o que se ha generado un nuevo identificador de coincidencia y se ha guardado el registro.

  10. Vea el identificador de coincidencia correspondiente y la regla asociada que se guardó en el flujo de trabajo coincidente en el mensaje de confirmación.

  11. (Opcional) Para copiar el identificador de coincidencia, selecciona Copiar.

API
Para modificar o generar un identificador de coincidencia mediante la API
nota

Para llamar a esta API correctamente, primero debe 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 del GenerateMatch ID.

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

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

    /matchingworkflows/workflowName/generateMatches

  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 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: 

    {
   "processingType": "string",
   "records": [ 
      { 
         "inputSourceARN": "string",
         "recordAttributeMap": { 
            "string" : "string" 
         },
         "uniqueId": "string"
      }
   ]
}

    Donde:

    • processingType(opcional): el valor predeterminado es. CONSISTENT Elija uno de estos valores:

      • CONSISTENT- Para obtener la máxima precisión con un tiempo de respuesta más lento

      • EVENTUAL- Para una respuesta inicial más rápida con procesamiento en segundo plano

      • EVENTUAL_NO_LOOKUP- Para una respuesta más rápida cuando se sabe que los registros son únicos

    • records(obligatorio) - Matriz que contiene exactamente un objeto de registro

  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:

    {
   "failedRecords": [ 
      { 
         "errorMessage": "string",
         "inputSourceARN": "string",
         "uniqueId": "string"
      }
   ],
   "matchGroups": [ 
      { 
         "matchId": "string",
         "matchRule": "string",
         "records": [ 
            { 
               "inputSourceARN": "string",
               "recordId": "string"
            }
         ]
      }
   ]
}

    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