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 record corrispondente impostato 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'GenerateMatchIDAPI. La modifica di un Match ID esistente aiuta a mantenere la coerenza nell'aggiornamento delle informazioni sui clienti, mentre la generazione di un nuovo Match ID è necessaria per aggiungere clienti precedentemente non identificati al sistema.
Si applicano costi aggiuntivi, indipendentemente dal fatto che si utilizzi la console o l'API. Il tipo di elaborazione scelto influisce sia sulla precisione che sul tempo di risposta dell'operazione.
Se revochi AWS Entity Resolution le autorizzazioni per il tuo bucket S3 mentre un lavoro è in corso, AWS Entity Resolution procederà comunque all'elaborazione e all'addebito dei costi per l'invio dei risultati a S3, ma non sarà in grado di consegnare i risultati al tuo bucket. Per evitare questo problema, assicurati di disporre delle autorizzazioni corrette per scrivere nel AWS Entity Resolution tuo bucket S3 prima di iniziare un lavoro. Se le autorizzazioni vengono revocate durante l'elaborazione, AWS Entity Resolution
tenta di fornire nuovamente i risultati fino a 30 giorni dopo il completamento del lavoro, una volta ripristinate le autorizzazioni corrette per il bucket.
La procedura seguente guida l'utente attraverso il processo di ricerca o generazione di un Match ID, la selezione di un tipo di elaborazione e la visualizzazione dei risultati.
- Console
-
Per modificare o generare un Match ID utilizzando la console
-
Accedi a AWS Management Console e apri la AWS Entity Resolution console all'indirizzo https://console.aws.amazon.com/entityresolution/.
-
Nel riquadro di navigazione a sinistra, in Flussi di lavoro, scegli Corrispondenza.
-
Scegli il flusso di lavoro corrispondente basato su regole che è stato elaborato (lo stato del Job è Completato).
-
Nella pagina dei dettagli del flusso di lavoro corrispondente, scegli la scheda IDsCorrispondenza.
-
Scegli Modifica o genera l'ID della partita.
L'opzione Modifica o genera l'ID di corrispondenza è disponibile solo per i flussi di lavoro corrispondenti che utilizzano la cadenza di elaborazione automatica. Se hai selezionato l'opzione Cadenza di elaborazione manuale, questa opzione risulterà inattiva. Per utilizzare questa opzione, modifica il flusso di lavoro in modo da utilizzare la cadenza di elaborazione automatica. Per ulteriori informazioni sulla modifica dei flussi di lavoro, consulta. Modifica di un flusso di lavoro corrispondente
-
Seleziona la AWS Glue tabella dall'elenco a discesa.
Se nel flusso di lavoro è presente una sola AWS Glue tabella, questa è selezionata per impostazione predefinita.
-
Scegli il tipo di elaborazione.
-
Coerente: puoi cercare un ID di corrispondenza esistente o generare e salvare immediatamente un nuovo ID di corrispondenza. Questa opzione offre la massima precisione e il tempo di risposta più lento.
-
Sfondo (mostrato come EVENTUAL nell'API): puoi cercare un ID di corrispondenza esistente o generare immediatamente un nuovo ID di corrispondenza. Il record aggiornato viene salvato in background. Questa opzione offre una risposta iniziale rapida, con risultati completi disponibili successivamente in S3.
-
Generazione rapida di ID (mostrata 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 record univoci.
-
Per gli attributi Record,
-
Immettere il valore per l'ID univoco.
-
Inserisci un valore per ogni chiave Match che corrisponderà ai record esistenti in base alle regole configurate nel flusso di lavoro.
-
Scegli Find match ID e salva il record.
Viene visualizzato un messaggio di successo, che indica che il Match ID è stato trovato o che è stato generato un nuovo Match ID e il record è stato salvato.
-
Visualizza il Match ID corrispondente e la regola associata che è stata salvata nel workflow corrispondente nel messaggio di successo.
-
(Facoltativo) Per copiare l'ID della partita, scegli Copia.
- API
-
Per modificare o generare un Match ID utilizzando l'API
-
Apri un terminale o un prompt dei comandi per effettuare la richiesta API.
-
Crea una richiesta POST per il seguente endpoint:
/matchingworkflows/workflowName/generateMatches
-
Nell'intestazione della richiesta, imposta il Content-type su application/json.
-
Nell'URI della richiesta, specifica il tuo. workflowName
Il workflowName must:
-
Per il corpo della richiesta, fornisci il seguente codice JSON:
{
"processingType": "string",
"records": [
{
"inputSourceARN": "string",
"recordAttributeMap": {
"string" : "string"
},
"uniqueId": "string"
}
]
}
Dove:
-
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 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 - in InternalServerException caso di errore interno del servizio
