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 ti aiutano a capire in che modo i record sono stati abbinati e quali regole sono state applicate. La procedura seguente mostra 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 a AWS Management Console 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 corrispondente basato su regole che è stato elaborato (lo stato del Job è Completato).

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

  5. Scegli Cerca l'ID della corrispondenza.

  6. Esegui una di queste operazioni:

    Se... Allora...
    Esiste 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 Record, inserisci la chiave Value for an existing Match per cercare ogni record esistente.

    Suggerimento

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

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

  9. Se desideri visualizzare le regole di corrispondenza, espandi 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 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 abbinamento basato su regole utilizzando l'StartMatchingJob API.

Per un elenco completo dei linguaggi di programmazione supportati, consulta la sezione Vedere anche dell'API GetMatchID.

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

  2. Crea una richiesta POST per il seguente endpoint: 

    /matchingworkflows/workflowName/matches

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

  4. Nell'URI della richiesta, specifica il tuo. workflowName

    Il workflowName must:

    • avere una lunghezza compresa tra 1 e 255 caratteri

    • Corrisponde allo schema [a-zA-Z_0-9-] *

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

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

    Dove:

    applyNormalization(opzionale) - Imposta su true per 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 di questi 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 si verifica un errore interno del servizio