View a markdown version of this page

Ändern oder Generieren einer Match-ID für einen regelbasierten Matching-Workflow - AWS Entity Resolution

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ändern oder Generieren einer Match-ID für einen regelbasierten Matching-Workflow

Eine Match-ID ist die Kennung, die von jedem abgeglichenen Datensatz generiert AWS Entity Resolution und auf ihn angewendet wird, nachdem ein passender Workflow ausgeführt wurde. Dies ist Teil der passenden Workflow-Metadaten, die in der Ausgabe enthalten sind.

Wenn Sie Datensätze für einen bestehenden Kunden aktualisieren oder Ihrem Datensatz einen neuen Kunden hinzufügen müssen, können Sie die AWS Entity Resolution Konsole oder die GenerateMatchId API verwenden. Das Ändern einer vorhandenen Match-ID trägt dazu bei, die Konsistenz bei der Aktualisierung von Kundeninformationen aufrechtzuerhalten. Das Generieren einer neuen Match-ID ist erforderlich, wenn Sie Ihrem System zuvor unbekannte Kunden hinzufügen.

Anmerkung

Es fallen zusätzliche Gebühren an, unabhängig davon, ob Sie die Konsole oder die API verwenden. Die gewählte Verarbeitungsart wirkt sich sowohl auf die Genauigkeit als auch auf die Reaktionszeit des Vorgangs aus.

Real-time übereinstimmende Anforderungen

Um die GenerateMatchId API in einem erweiterten regelbasierten Matching-Workflow aufzurufen, setzen enableRealTimeMatching Sie den Wert auf. true Für einfache Matching-Workflows ist der Abgleich in Echtzeit immer verfügbar, und Sie müssen dieses Kennzeichen nicht setzen.

Sie können den Echtzeitabgleich nicht für Workflows aktivieren, die eines der folgenden Elemente verwenden:

  • Fuzzy-Attribute:Cosine, oder Soundex Levenshtein

  • EmptyValues=Ignore

Wenn auf gesetzt enableRealTimeMatching isttrue, kann der Workflow nicht zusammen mit der StartMatchingJob API verwendet werden, um Workflow-Jobs auszuführen.

Wichtig

Wenn Sie die AWS Entity Resolution Berechtigungen für Ihren S3-Bucket entziehen, während ein Job in Bearbeitung ist, AWS Entity Resolution verarbeitet und berechnet die Ausgabe der Ergebnisse an S3 trotzdem, kann die Ergebnisse jedoch nicht an Ihren Bucket liefern. Um dieses Problem zu vermeiden, stellen Sie sicher, dass Ihr AWS Entity Resolution Unternehmen über die richtigen Berechtigungen zum Schreiben in Ihren S3-Bucket verfügt, bevor Sie einen Job starten. Wenn Berechtigungen während der Verarbeitung entzogen werden, wird AWS Entity Resolution versucht, bis zu 30 Tage nach Abschluss des Auftrags erneut Ergebnisse zu liefern, sobald Sie die richtigen Bucket-Berechtigungen wiederhergestellt haben.

Das folgende Verfahren führt Sie Schritt für Schritt durch das Suchen oder Generieren einer Match-ID, das Auswählen eines Verarbeitungstyps und das Anzeigen der Ergebnisse.

Console
So ändern oder generieren Sie eine Match-ID mithilfe der Konsole

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AWS Entity Resolution Konsole unter https://console.aws.amazon.com/entityresolution/.

  2. Wählen Sie im linken Navigationsbereich unter Workflows die Option Matching aus.

  3. Wählen Sie den regelbasierten Matching-Workflow aus, der verarbeitet wurde (Auftragsstatus ist Abgeschlossen).

  4. Wählen Sie auf der Seite mit den passenden Workflow-Details die Registerkarte „IDs abgleichen“.

  5. Wählen Sie Match-ID ändern oder generieren aus.

    Anmerkung

    Die Option Match-ID ändern oder generieren ist nur für passende Workflows verfügbar, die den automatischen Verarbeitungsrhythmus verwenden. Wenn Sie den manuellen Verarbeitungsrhythmus ausgewählt haben, wird diese Option als inaktiv angezeigt. Um diese Option zu verwenden, bearbeiten Sie Ihren Arbeitsablauf so, dass der automatische Verarbeitungsrhythmus verwendet wird. Weitere Informationen zum Bearbeiten von Workflows finden Sie unterBearbeitung eines passenden Workflows.

  6. Wählen Sie die AWS Glue Tabelle aus der Dropdownliste aus.

    Wenn der Workflow nur eine AWS Glue Tabelle enthält, ist diese standardmäßig ausgewählt.

  7. Wählen Sie den Verarbeitungstyp.

    • Konsistent — Sie können eine vorhandene Match-ID nachschlagen oder sofort eine neue Match-ID generieren und speichern. Diese Option hat die höchste Genauigkeit und die langsamere Reaktionszeit.

    • Hintergrund (wie EVENTUAL in der API dargestellt) — Sie können eine vorhandene Match-ID nachschlagen oder sofort eine neue Match-ID generieren. Der aktualisierte Datensatz wird im Hintergrund gespeichert. Diese Option reagiert zunächst schnell, und die vollständigen Ergebnisse sind später in S3 verfügbar.

    • Schnelle ID-Generierung (wie EVENTUAL_NO_LOOKUP in der API dargestellt) — Sie können eine neue Match-ID erstellen, ohne nach einer vorhandenen suchen zu müssen. Der aktualisierte Datensatz wird im Hintergrund gespeichert. Diese Option reagiert am schnellsten. Sie wird nur für eindeutige Datensätze empfohlen.

  8. Für Datensatzattribute

    1. Geben Sie den Wert für die eindeutige ID ein.

    2. Geben Sie für jeden Abgleichsschlüssel einen Wert ein, der anhand der in Ihrem Workflow konfigurierten Regeln mit vorhandenen Datensätzen übereinstimmt.

  9. Wählen Sie „Match-ID suchen und Datensatz speichern“.

    Es wird eine Erfolgsmeldung angezeigt, die besagt, dass entweder die Match-ID gefunden wurde oder eine neue Match-ID generiert und der Datensatz gespeichert wurde.

  10. Sehen Sie sich in der Erfolgsmeldung die entsprechende Match-ID und die zugehörige Regel an, die im passenden Workflow gespeichert wurde.

  11. (Optional) Um die Match-ID zu kopieren, wählen Sie Kopieren.

API
Um eine Match-ID mithilfe der API zu ändern oder zu generieren
Anmerkung

Um diese API erfolgreich aufrufen zu können, müssen Sie zunächst einen regelbasierten Matching-Workflow mithilfe der StartMatchingJob API erfolgreich ausgeführt haben.

Eine vollständige Liste der unterstützten Programmiersprachen finden Sie im Abschnitt Siehe auch von. GenerateMatchId

  1. Öffnen Sie ein Terminal oder eine Eingabeaufforderung, um die API-Anfrage zu stellen.

  2. Erstellen Sie eine POST-Anfrage an den folgenden Endpunkt: 

    /matchingworkflows/workflowName/generateMatches

  3. Stellen Sie im Anforderungsheader das Content-type auf ein application/json.

  4. Geben Sie in der Anforderungs-URI Ihre anworkflowName.

    Das workflowName muss:

    • Zwischen 1 und 255 Zeichen lang sein

    • Entspricht dem Muster [a-z A-Z _0-9-] *

  5. Geben Sie für den Anforderungstext den folgenden JSON-Code an: 

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

    Wobei Folgendes gilt:

    • processingType(optional) — Die Standardeinstellung ist. CONSISTENT Wählen Sie einen der folgenden Werte:

      • CONSISTENT- Für höchste Genauigkeit bei langsamerer Reaktionszeit

      • EVENTUAL- Für eine schnellere Erstreaktion mit Hintergrundverarbeitung

      • EVENTUAL_NO_LOOKUP- Für die schnellste Reaktion, wenn bekannt ist, dass Datensätze eindeutig sind

    • records(erforderlich) — Array, das genau ein Datensatzobjekt enthält

  6. Senden Sie die Anforderung .

    Bei Erfolg erhalten Sie eine Antwort mit dem Statuscode 200 und einem JSON-Text, der Folgendes enthält:

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

    Wenn der Anruf nicht erfolgreich ist, erhalten Sie möglicherweise eine der folgenden Fehlermeldungen:

    • 403 — AccessDeniedException wenn Sie nicht über ausreichenden Zugriff verfügen

    • 404 — ResourceNotFoundException wenn die Ressource nicht gefunden werden kann

    • 429 — ThrottlingException wenn die Anfrage gedrosselt wurde

    • 400 — ValidationException wenn die Eingabe die Überprüfung nicht besteht

    • 500 — InternalServerException wenn ein interner Servicefehler vorliegt