View a markdown version of this page

Ricerca di un Match ID per un flusso di lavoro di abbinamento basato su regole - AWS Entity Resolution

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ricerca di un Match ID per un flusso di lavoro di abbinamento basato su regole

Dopo aver completato un flusso di lavoro di abbinamento basato su regole, puoi recuperare il Match ID e la regola associata per ogni record elaborato. Queste informazioni consentono di comprendere in che modo i record sono stati abbinati e quali regole sono state applicate. La procedura seguente illustra come accedere a questi dati utilizzando la AWS Entity Resolution console o l'GetMatchIDAPI.

Console
Per cercare un Match ID utilizzando la console

  1. Accedi Console di gestione AWS e apri la AWS Entity Resolution console all'indirizzo https://console.aws.amazon.com/entityresolution/.

  2. Nel riquadro di navigazione a sinistra, in Flussi di lavoro, scegli Corrispondenza.

  3. Scegli il flusso di lavoro di corrispondenza basato su regole che è stato elaborato (lo stato del lavoro è Completato).

  4. Nella pagina dei dettagli del flusso di lavoro corrispondente, scegli la scheda Match IDs.

  5. Scegli Cerca l'ID corrispondente.

    Nota

    L'opzione Look up match ID è disponibile solo per i flussi di lavoro di abbinamento che utilizzano la cadenza di elaborazione automatica. Se hai selezionato la cadenza di elaborazione manuale, questa opzione apparirà inattiva. Per utilizzare questa opzione, modifica il flusso di lavoro per utilizzare la cadenza di elaborazione automatica. Per ulteriori informazioni sulla modifica dei flussi di lavoro, consulta. Modifica di un flusso di lavoro corrispondente

  6. Esegui una delle seguenti operazioni:

    Se... Quindi...
    C'è solo una mappatura dello schema associata a questo flusso di lavoro. Visualizza la mappatura dello schema selezionata per impostazione predefinita.
    Esiste più di una mappatura dello schema associata a questo flusso di lavoro. Scegli la mappatura dello schema dall'elenco a discesa.

  7. Per gli attributi dei record, inserisci il valore per una chiave di corrispondenza esistente per cercare ogni record esistente.

    Suggerimento

    Inserisci il maggior numero possibile di valori per trovare il Match ID.

  8. L'opzione Normalizza dati è selezionata per impostazione predefinita, in modo che gli input dei dati vengano normalizzati prima della corrispondenza. Se non desideri normalizzare i dati, deseleziona l'opzione Normalizza dati.

  9. Se desideri visualizzare le regole di corrispondenza, espandi la finestra Visualizza le regole di corrispondenza.

  10. Scegliere Look up (Cerca).

    Viene visualizzato un messaggio di successo che indica che il Match ID è stato trovato.

  11. Visualizza il Match ID corrispondente e la regola associata che è stata trovata.

API
Per cercare un Match ID utilizzando l'API
Nota

Per chiamare correttamente questa API, devi prima aver eseguito correttamente un flusso di lavoro di corrispondenza basato su regole utilizzando l'StartMatchingJob API.

Per un elenco completo dei linguaggi di programmazione supportati, consulta la sezione Vedi anche dell'API GetMatch ID.

  1. Apri un terminale o un prompt dei comandi per effettuare la richiesta API.

  2. Crea una richiesta POST al seguente endpoint: 

    /matchingworkflows/workflowName/matches

  3. Nell'intestazione della richiesta, imposta su. Content-type application/json

  4. Nell'URI della richiesta, specifica il tuoworkflowName.

    Il workflowName must:

    • Avere una lunghezza compresa tra 1 e 255 caratteri

    • Abbina il modello [a-z A-Z _0-9-] *

  5. Per il corpo della richiesta, fornisci il seguente JSON: 

    {
   "applyNormalization": boolean,
   "record": { 
      "string" : "string" 
   }
}

    Dove:

    applyNormalization(opzionale) - Impostato per true normalizzare gli attributi definiti nello schema

    record(obbligatorio) - Il record per cui recuperare il Match ID

  6. Inviare la richiesta .

    In caso di successo, riceverai una risposta con il codice di stato 200 e un corpo JSON contenente: 

    {
   "matchId": "string",
   "matchRule": "string"
}

    matchIdÈ l'identificatore univoco per questo gruppo di record corrispondenti e matchRule indica a quale regola corrisponde il record.

    Se la chiamata non va a buon fine, potresti ricevere uno dei seguenti errori:

    • 403 - AccessDeniedException se non disponi di un accesso sufficiente

    • 404 - ResourceNotFoundException se la risorsa non può essere trovata

    • 429 - ThrottlingException se la richiesta è stata limitata

    • 400 - ValidationException se l'input fallisce la convalida

    • 500 - InternalServerException se c'è un errore interno del servizio