View a markdown version of this page

Modifica o generazione 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à.

Modifica o generazione di un Match ID per un flusso di lavoro di abbinamento basato su regole

Un Match ID è l'identificatore generato AWS Entity Resolution e applicato a ciascun set di record corrispondenti dopo l'esecuzione di un flusso di lavoro corrispondente. Questo fa parte dei metadati del flusso di lavoro corrispondenti inclusi nell'output.

Quando devi aggiornare i record di un cliente esistente o aggiungere un nuovo cliente al tuo set di dati, puoi utilizzare la AWS Entity Resolution console o l'API. GenerateMatchId La modifica di un match ID esistente aiuta a mantenere la coerenza nell'aggiornamento delle informazioni sui clienti. La generazione di un nuovo match ID è necessaria quando aggiungi clienti precedentemente non identificati al tuo sistema.

Nota

Si applicano costi aggiuntivi, indipendentemente dal fatto che utilizzi la console o l'API. Il tipo di elaborazione scelto influisce sia sulla precisione che sui tempi di risposta dell'operazione.

Real-time requisiti corrispondenti

Per chiamare l'GenerateMatchIdAPI su un flusso di lavoro di corrispondenza avanzato basato su regole, imposta enableRealTimeMatching su. true Per i flussi di lavoro Simple Matching, la corrispondenza in tempo reale è sempre disponibile e non è necessario impostare questo flag.

Non puoi abilitare la corrispondenza in tempo reale nei flussi di lavoro che utilizzano uno dei seguenti elementi:

  • Attributi fuzzy:Cosine,, o Soundex Levenshtein

  • EmptyValues=Ignore

Se enableRealTimeMatching è impostato sutrue, il flusso di lavoro non può essere utilizzato con l'StartMatchingJobAPI per eseguire processi di flusso di lavoro.

Importante

Se revochi AWS Entity Resolution le autorizzazioni al bucket S3 mentre è in corso un lavoro, l'elaborazione AWS Entity Resolution verrà comunque eseguita e addebitata per l'invio dei risultati a S3, ma non sarà possibile fornire i risultati al bucket. Per evitare questo problema, assicurati che AWS Entity Resolution disponga delle autorizzazioni corrette per scrivere nel bucket S3 prima di iniziare un lavoro. Se le autorizzazioni vengono revocate durante l'elaborazione, AWS Entity Resolution tenta di restituire i risultati fino a 30 giorni dopo il completamento del job, una volta ripristinate le autorizzazioni corrette del bucket.

La seguente procedura ti guida attraverso il processo di ricerca o generazione di un Match ID, selezione di un tipo di elaborazione e visualizzazione dei risultati.

Console
Per modificare o generare 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 Modifica o genera l'ID del match.

    Nota

    L'opzione Modifica o genera l'ID di corrispondenza è 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. Seleziona la AWS Glue tabella dall'elenco a discesa.

    Se nel flusso di lavoro è presente una sola AWS Glue tabella, viene selezionata per impostazione predefinita.

  7. Scegli il tipo di elaborazione.

    • Coerente: puoi cercare un Match ID esistente o generare e salvare immediatamente un nuovo Match ID. Questa opzione offre la massima precisione e il tempo di risposta più lento.

    • Sfondo (mostrato come EVENTUAL nell'API): puoi cercare un Match ID esistente o generare immediatamente un nuovo Match ID. Il record aggiornato viene salvato in background. Questa opzione ha una risposta iniziale rapida, con risultati completi disponibili in S3 in un secondo momento.

    • Generazione rapida dell'ID (mostrato come EVENTUAL_NO_LOOKUP nell'API): puoi creare un nuovo match ID senza cercarne uno esistente. Il record aggiornato viene salvato in background. Questa opzione offre la risposta più rapida. È consigliata solo per i record univoci.

  8. Per gli attributi dei record,

    1. Inserire il valore per l'ID univoco.

    2. Inserisci un valore per ogni chiave di corrispondenza che corrisponda ai record esistenti in base alle regole configurate nel flusso di lavoro.

  9. Scegli Trova l'ID della partita e salva il record.

    Viene visualizzato un messaggio che indica che il Match ID è stato trovato o è stato generato un nuovo Match ID e il record è stato salvato.

  10. Visualizza il Match ID corrispondente e la regola associata che è stata salvata nel flusso di lavoro corrispondente nel messaggio di successo.

  11. (Facoltativo) Per copiare l'ID del match, scegli Copia.

API
Per modificare o generare 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 di. GenerateMatchId

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

  2. Crea una richiesta POST al seguente endpoint: 

    /matchingworkflows/workflowName/generateMatches

  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: 

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

    Dove:

    • processingType(opzionale) - Il valore predefinito è. CONSISTENT Scegli uno di questi valori:

      • CONSISTENT- Per la massima precisione con tempi di risposta più lenti

      • EVENTUAL- Per una risposta iniziale più rapida con l'elaborazione in background

      • EVENTUAL_NO_LOOKUP- Per una risposta più rapida quando i record sono noti per essere unici

    • records(obbligatorio) - Matrice contenente esattamente un oggetto record

  6. Inviare la richiesta .

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

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

    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