View a markdown version of this page

Modificar o generar un ID 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 ID 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. Forma parte de los metadatos del flujo de trabajo coincidentes que se incluyen en la salida.

Cuando necesites actualizar los registros de un cliente existente o añadir un nuevo cliente a tu conjunto de datos, puedes usar la AWS Entity Resolution consola o la GenerateMatchId API. Modificar un ID de coincidencia existente ayuda a mantener la coherencia a la hora de actualizar la información del cliente. Es necesario generar un nuevo ID de coincidencia cuando añades a tu 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.

Real-time requisitos de coincidencia

Para llamar a la GenerateMatchId API en un flujo de trabajo de coincidencia avanzado basado en reglas, enableRealTimeMatching configúrelo en. true En el caso de los flujos de trabajo de coincidencia simple, la coincidencia en tiempo real siempre está disponible y no es necesario establecer esta marca.

No puedes habilitar la coincidencia en tiempo real en los flujos de trabajo que utilizan alguno de los siguientes elementos:

  • Atributos difusos: CosineSoundex, o Levenshtein

  • EmptyValues=Ignore

Si enableRealTimeMatching se establece entrue, el flujo de trabajo no se puede usar con la StartMatchingJob API para ejecutar trabajos de flujo de trabajo.

importante

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

El siguiente procedimiento te guía durante el proceso de buscar o generar un ID de coincidencia, seleccionar un tipo de procesamiento y ver los resultados.

Console
Para modificar o generar un Match ID mediante la consola

  1. Inicia sesión Consola de administración de AWS 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, seleccione Coincidencia.

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

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

  5. Selecciona 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, consulteEditar 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. Elige el tipo de procesamiento.

    • Coherente: puedes buscar un ID de coincidencia existente o generar y guardar un nuevo ID de coincidencia de inmediato. Esta opción tiene la mayor precisión y el tiempo de respuesta más lento.

    • Antecedentes (tal y como aparecen 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 ofrece una respuesta inicial rápida y los resultados completos estarán disponibles en S3 más adelante.

    • Generación rápida de ID (se muestra como EVENTUAL_NO_LOOKUP en la API): puedes crear un nuevo ID de coincidencia sin 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 según las reglas configuradas en su flujo de trabajo.

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

    Aparece un mensaje de éxito en el que se indica que se encontró el ID de coincidencia o que se generó un nuevo ID de coincidencia y se guardó el registro.

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

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

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

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

Para obtener una lista completa de los lenguajes de programación compatibles, consulte la sección Vea también de. GenerateMatchId

  1. Abra una terminal o 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, Content-type defina como application/json.

  4. En el URI de la solicitud, especifique suworkflowName.

    workflowNameDeben:

    • Tener entre 1 y 255 caracteres

    • Coincide con el patrón [a-z A-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 tiene éxito, recibirá 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 suficiente acceso

    • 404: ResourceNotFoundException si no se puede encontrar el recurso

    • 429: ThrottlingException si la solicitud fue limitada

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

    • 500: InternalServerException si hay una falla en el servicio interno