Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Modifier ou générer 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'`GenerateMatchID`API. 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** 1. Connectez-vous à la Résolution des entités AWS console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/). 1. Dans le volet de navigation de gauche, sous **Workflows**, choisissez **Matching**. 1. Choisissez le flux de travail de correspondance basé sur des règles qui a été traité (le **statut du Job** est **terminé**). 1. Sur la page des détails du flux de travail correspondant, choisissez l'onglet **Match IDs**. 1. 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, consultez[Modification d'un flux de travail correspondant](edit-matching-workflow.md). 1. 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. 1. 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. 1. Pour les **attributs d'enregistrement**, 1. Entrez la **valeur** de l'**identifiant unique**. 1. 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. 1. 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é. 1. 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. 1. (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.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) Pour une liste complète des langages de programmation pris en charge, [consultez la section Voir aussi](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html#API_GenerateMatchId_SeeAlso) de l'[GenerateMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GenerateMatchId.html). 1. Ouvrez un terminal ou une invite de commande pour effectuer la demande d'API. 1. Créez une requête POST pour le point de terminaison suivant : ``` /matchingworkflows/workflowName/generateMatches ``` 1. Dans l'en-tête de la demande, définissez la Content-type valeur sur application/json. 1. Dans l'URI de demande, spécifiez votre`workflowName`. Le `workflowName` must : + Comporter entre 1 et 255 caractères + Correspond au modèle [a-z A-Z \_0-9-] \* 1. 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 1. 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 ------