Modification ou génération d'un identifiant de correspondance pour un flux de travail de correspondance basé sur des règles

Un identifiant de correspondance est l'identifiant généré Résolution des entités AWS et appliqué à chaque ensemble d'enregistrements correspondants après l'exécution d'un flux de travail de correspondance. Cela fait partie des métadonnées de flux de travail correspondantes incluses dans la sortie.

Lorsque vous devez mettre à jour les enregistrements d'un client existant ou ajouter un nouveau client à votre ensemble de données, vous pouvez utiliser la Résolution des entités AWS console ou l'GenerateMatchIDAPI. La modification d'un identifiant de correspondance existant permet de maintenir la cohérence lors de la mise à jour des informations client, tandis que la génération d'un nouvel identifiant de correspondance est nécessaire lorsque vous ajoutez des clients non identifiés à votre système.

Note

Des frais supplémentaires s'appliquent, que vous utilisiez la console ou l'API. Le type de traitement que vous choisissez affecte à la fois la précision et le temps de réponse de l'opération.

Important

Si vous révoquez Résolution des entités AWS les autorisations d'accès à votre compartiment S3 alors qu'une tâche est en cours, vous Résolution des entités AWS continuerez à traiter et à facturer la sortie des résultats vers S3, mais vous ne pourrez pas les transmettre à votre compartiment. Pour éviter ce problème, assurez-vous qu'il Résolution des entités AWS dispose des autorisations appropriées pour écrire dans votre compartiment S3 avant de démarrer une tâche. Si les autorisations sont révoquées pendant le traitement, Résolution des entités AWS tente de fournir à nouveau les résultats pendant une période maximale de 30 jours après la fin du travail, une fois que vous avez rétabli les autorisations de bucket correctes.

La procédure suivante vous guide tout au long du processus de recherche ou de génération d'un identifiant de correspondance, de sélection d'un type de traitement et d'affichage des résultats.

Console

Pour modifier ou générer un Match ID à l'aide de la console

Connectez-vous à la Résolution des entités AWS console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/entityresolution/.
Dans le volet de navigation de gauche, sous Workflows, choisissez Matching.
Choisissez le flux de travail de correspondance basé sur des règles qui a été traité (le statut du Job est terminé).
Sur la page des détails du flux de travail correspondant, choisissez l' IDsonglet Match.
Choisissez Modifier ou générer un identifiant de match.

Note
L'option Modifier ou générer un identifiant de correspondance n'est disponible que pour les flux de travail correspondants utilisant la cadence de traitement automatique. Si vous avez sélectionné la cadence de traitement manuel, cette option apparaîtra inactive. Pour utiliser cette option, modifiez votre flux de travail afin d'utiliser la cadence de traitement automatique. Pour plus d'informations sur la modification des flux de travail, consultezModification d'un flux de travail correspondant.
Sélectionnez le AWS Glue tableau dans la liste déroulante.

S'il n'y a qu'une seule AWS Glue table dans le flux de travail, elle est sélectionnée par défaut.
Choisissez le type de traitement.
- Cohérent : vous pouvez rechercher un identifiant de match existant ou générer et enregistrer un nouveau numéro de match immédiatement. Cette option offre la plus grande précision et le temps de réponse le plus lent.
- Contexte (comme EVENTUAL dans l'API) — Vous pouvez rechercher un identifiant de match existant ou en générer un nouveau immédiatement. L'enregistrement mis à jour est enregistré en arrière-plan. Cette option a une réponse initiale rapide, les résultats complets étant disponibles ultérieurement dans S3.
- Génération rapide d'un identifiant (comme EVENTUAL_NO_LOOKUP dans l'API) — Vous pouvez créer un nouvel identifiant de match sans en rechercher un existant. L'enregistrement mis à jour est enregistré en arrière-plan. Cette option offre la réponse la plus rapide. Il est recommandé uniquement pour les enregistrements uniques.
Pour les attributs d'enregistrement,
1. Entrez la valeur de l'identifiant unique.
2. Entrez une valeur pour chaque clé de correspondance qui correspondra aux enregistrements existants en fonction des règles configurées dans votre flux de travail.
Choisissez Find match ID et enregistrez l'enregistrement.

Un message de réussite apparaît, indiquant que le Match ID a été trouvé ou qu'un nouveau Match ID a été généré et que l'enregistrement a été enregistré.
Affichez l'ID de correspondance correspondant et la règle associée qui ont été enregistrés dans le flux de travail correspondant dans le message de réussite.
(Facultatif) Pour copier l'identifiant du match, choisissez Copier.

API

Pour modifier ou générer un Match ID à l'aide de l'API

Note

Pour appeler cette API avec succès, vous devez d'abord avoir exécuté avec succès un flux de travail de correspondance basé sur des règles à l'aide de l'StartMatchingJob API.

Pour une liste complète des langages de programmation pris en charge, consultez la section Voir aussi de l'GenerateMatchID.

Ouvrez un terminal ou une invite de commande pour effectuer la demande d'API.
Créez une requête POST pour le point de terminaison suivant :
```
/matchingworkflows/workflowName/generateMatches
```
Dans l'en-tête de la demande, définissez le type de contenu sur application/json.
Dans l'URI de demande, spécifiez votreworkflowName.

Le workflowName must :
- Comporter entre 1 et 255 caractères
- Correspond au modèle [A-za-Z_0-9-] *
Pour le corps de la requête, fournissez le code JSON suivant :
```
{
   "processingType": "string",
   "records": [ 
      { 
         "inputSourceARN": "string",
         "recordAttributeMap": { 
            "string" : "string" 
         },
         "uniqueId": "string"
      }
   ]
}
```
Où :
- processingType(facultatif) - La valeur par défaut est. CONSISTENT Choisissez l'une des valeurs suivantes :
  - CONSISTENT- Pour une précision maximale avec un temps de réponse plus lent
  - EVENTUAL- Pour une réponse initiale plus rapide grâce au traitement en arrière-plan
  - EVENTUAL_NO_LOOKUP- Pour une réponse plus rapide lorsque les enregistrements sont connus pour être uniques
- records(obligatoire) - Tableau contenant exactement un objet d'enregistrement
Envoyez la demande .

En cas de succès, vous recevrez une réponse avec le code d'état 200 et un corps JSON contenant :
```
{
   "failedRecords": [ 
      { 
         "errorMessage": "string",
         "inputSourceARN": "string",
         "uniqueId": "string"
      }
   ],
   "matchGroups": [ 
      { 
         "matchId": "string",
         "matchRule": "string",
         "records": [ 
            { 
               "inputSourceARN": "string",
               "recordId": "string"
            }
         ]
      }
   ]
}
```
Si l'appel échoue, l'un des messages d'erreur suivants peut s'afficher :
- 403 - AccessDeniedException si vous ne disposez pas d'un accès suffisant
- 404 - ResourceNotFoundException si la ressource est introuvable
- 429 - ThrottlingException si la demande a été limitée
- 400 - ValidationException si la saisie échoue à la validation
- 500 - en InternalServerException cas de panne du service interne

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Supprimer un flux de travail correspondant

Recherche d'un identifiant de match