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à. # Creazione di un flusso di lavoro di abbinamento basato su regole con il tipo di regola semplice **Prerequisiti** Prima di creare un flusso di lavoro di abbinamento basato su regole, devi: 1. Creare una mappatura dello schema. Per ulteriori informazioni, consulta [Creazione di una mappatura dello schema](create-schema-mapping.md). 1. Se utilizzi i profili dei clienti Amazon Connect come destinazione di output, assicurati di avere configurato le autorizzazioni appropriate. La procedura seguente mostra come creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Simple** utilizzando la AWS Entity Resolution console o l'API. `CreateMatchingWorkflow` ------ #### [ Console ] **Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **Simple utilizzando la console**** 1. Accedi a Console di gestione AWS e apri la AWS Entity Resolution console all'indirizzo. [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 1. Nel riquadro di navigazione a sinistra, in **Flussi di lavoro**, scegli **Corrispondenza**. 1. Nella pagina **Flussi di lavoro corrispondenti**, nell'angolo in alto a destra, scegli **Crea flusso di lavoro corrispondente**. 1. Per il **passaggio 1: Specificare i dettagli del flusso di lavoro corrispondente**, procedi come segue: 1. Immettete un **nome del flusso di lavoro corrispondente** e una **descrizione** opzionale. 1. Per l'**immissione dei dati **Regione AWS****, scegli un **AWS Glue database**, la **AWS Glue tabella** e quindi la **mappatura dello schema** corrispondente. È possibile aggiungere fino a 19 input di dati. 1. L'opzione **Normalizza 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.** **Nota** **La normalizzazione è supportata solo per i seguenti scenari in Create schema mapping:** **Se i seguenti sottotipi di **nome** sono raggruppati: **Nome, Secondo nome, **Cognome****.** **Se i seguenti sottotipi di **indirizzo** sono raggruppati: **Indirizzo 1**, **Indirizzo 2, Indirizzo** **3**, **Città**, **Stato, **Paese**, Codice** postale.** **Se i seguenti sottotipi **di telefono** sono raggruppati: **Numero di telefono, Prefisso telefonico** del paese.** 1. Per specificare le autorizzazioni **di accesso al servizio**, scegli un'opzione e intraprendi l'azione consigliata. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html) 1. (Facoltativo) Per abilitare i **tag** per la risorsa, scegliete **Aggiungi nuovo tag**, quindi immettete la coppia **Chiave** e **Valore**. 1. Scegli **Next (Successivo)**. 1. Per la **fase 2: Scegli la tecnica di abbinamento**: 1. Per il **metodo di abbinamento**, scegli Abbinamento **basato su regole**. 1. **Per **Tipo di regola**, scegli Semplice.** ![\[Scegli la schermata della tecnica di abbinamento con l'opzione Abbinamento semplice basato su regole selezionata.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/choose-matching-method-rule-based-simple.PNG) 1. Per **Processing cadence**, selezionate una delle seguenti opzioni. + Scegliete **Manuale** per eseguire un flusso di lavoro su richiesta per un aggiornamento collettivo + Scegli **Automatico** per eseguire un flusso di lavoro non appena nuovi dati sono presenti nel tuo bucket S3 **Nota** Se scegli **Automatico**, assicurati di avere EventBridge le notifiche Amazon attivate per il tuo bucket S3. Per istruzioni su come abilitare Amazon EventBridge tramite la console S3, consulta [Enabling Amazon EventBridge nella Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) *S3* User Guide. 1. (Facoltativo) Per **Indicizza solo per la mappatura degli ID**, puoi scegliere di **attivare** la capacità di indicizzare solo i dati e non di generarli. IDs Per impostazione predefinita, il flusso di lavoro corrispondente viene generato IDs dopo l'indicizzazione dei dati. 1. Per **le regole di corrispondenza**, inserisci **il nome di una regola**, quindi scegli i **tasti di corrispondenza** per quella regola. Puoi creare fino a 15 regole e applicare fino a 15 chiavi di abbinamento diverse alle regole per definire i criteri di corrispondenza. ![\[Le regole di corrispondenza si interfacciano con i campi per inserire il nome della regola e selezionare le chiavi di corrispondenza.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/matching-rules.PNG) 1. Per **Tipo di confronto**, scegli una delle seguenti opzioni in base al tuo obiettivo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html) ![\[Opzioni relative al tipo di confronto: campi di input multipli per trovare corrispondenze tra i dati archiviati in più campi o campo di input singolo per limitare il confronto all'interno di un campo.\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/images/comparison-type.PNG) 1. Scegli **Next (Successivo)**. 1. Per la **fase 3: Specificare l'output e il formato dei dati**: 1. **Per **Destinazione e formato di output dei dati**, scegli la **posizione Amazon S3** per l'output dei dati e se il **formato dei dati** sarà Dati **normalizzati o Dati originali**.** 1. Per la **crittografia**, se scegli di **personalizzare le impostazioni di crittografia**, inserisci la **AWS KMS chiave** ARN. 1. Visualizza l'**output generato dal sistema**. 1. Per l'**output dei dati**, decidi quali campi includere, nascondere o mascherare, quindi intraprendi le azioni consigliate in base ai tuoi obiettivi. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/rule-based-mw-simple.html) 1. Scegli **Next (Successivo)**. 1. Per il **passaggio 4: rivedi e crea**: 1. Rivedi le selezioni effettuate per i passaggi precedenti e modificale se necessario. 1. Scegli **Create and run** (Crea ed esegui). Viene visualizzato un messaggio che indica che il flusso di lavoro corrispondente è stato creato e che il processo è iniziato. 1. Nella pagina dei dettagli del flusso di lavoro corrispondente, nella scheda **Metriche**, visualizza quanto segue in **Metriche dell'ultimo lavoro**: + Il **Job ID**. + **Lo **stato** del processo del flusso di lavoro corrispondente: In **coda, **In corso**, Completato****, Non riuscito**** + Il **tempo di completamento** del processo del flusso di lavoro. + Il numero di **record elaborati**. + Il numero di **record non elaborati**. + La **corrispondenza unica IDs generata**. + Il numero di **record di input**. Puoi anche visualizzare le metriche dei job per i job corrispondenti ai job del flusso di lavoro che sono stati eseguiti in precedenza **nella cronologia Job**. 1. Una volta completato il processo del flusso di lavoro corrispondente (**lo stato** è **completato**), puoi andare alla scheda **Data output** e quindi selezionare la tua sede **Amazon S3** per visualizzare i risultati. 1. (Solo tipo di elaborazione **manuale**) Se hai creato un flusso di lavoro di **abbinamento basato su regole** con il tipo di elaborazione **manuale**, puoi eseguire il flusso di lavoro corrispondente in qualsiasi momento selezionando Esegui flusso di lavoro nella pagina dei dettagli del **flusso di lavoro** corrispondente. ------ #### [ API ] **Per creare un flusso di lavoro di abbinamento basato su regole con il tipo di regola **semplice utilizzando l'API**** **Nota** Per impostazione predefinita, il flusso di lavoro utilizza l'elaborazione standard (batch). Per utilizzare l'elaborazione incrementale (automatica), è necessario configurarla in modo esplicito. 1. Apri un terminale o un prompt dei comandi per effettuare la richiesta API. 1. Crea una richiesta POST per il seguente endpoint: ``` /matchingworkflows ``` 1. Nell'intestazione della richiesta, imposta il Content-type su application/json. **Nota** *[Per un elenco completo dei linguaggi di programmazione supportati, consulta l'API Reference.AWS Entity Resolution](https://docs.aws.amazon.com/entityresolution/latest/apireference/Welcome.html)* 1. Per il corpo della richiesta, fornisci i seguenti parametri JSON richiesti: ``` { "description": "string", "incrementalRunConfig": { "incrementalRunType": "string" }, "inputSourceConfig": [ { "applyNormalization": boolean, "inputSourceARN": "string", "schemaName": "string" } ], "outputSourceConfig": [ { "applyNormalization": boolean, "KMSArn": "string", "output": [ { "hashed": boolean, "name": "string" } ], "outputS3Path": "string" } ], "resolutionTechniques": { "providerProperties": { "intermediateSourceConfiguration": { "intermediateS3Path": "string" }, "providerConfiguration": JSON value, "providerServiceArn": "string" }, "resolutionType": "RULE_MATCHING", "ruleBasedProperties": { "attributeMatchingModel": "string", "matchPurpose": "string", "rules": [ { "matchingKeys": [ "string" ], "ruleName": "string" } ] }, "ruleConditionProperties": { "rules": [ { "condition": "string", "ruleName": "string" } ] } }, "roleArn": "string", "tags": { "string" : "string" }, "workflowName": "string" } ``` Dove: + `workflowName`(obbligatorio) — Deve essere univoco e deve contenere da 1 a 255 caratteri e corrispondere allo schema [a-zA-Z\$10-9-] \$1 + `inputSourceConfig`(obbligatorio) — Elenco di 1—20 configurazioni delle sorgenti di ingresso + `outputSourceConfig`(richiesto) — Esattamente una configurazione della sorgente di uscita + `resolutionTechniques`(obbligatorio) — Imposta su «RULE\$1MATCHING» per la corrispondenza basata su regole + `roleArn`(obbligatorio) — Ruolo IAM ARN per l'esecuzione del flusso di lavoro + `ruleConditionProperties`(obbligatorio): elenco delle condizioni della regola e nome della regola corrispondente. I parametri opzionali includono: + `description`— Fino a 255 caratteri + `incrementalRunConfig`— Configurazione incrementale del tipo di esecuzione + `tags`— Fino a 200 coppie chiave-valore 1. (Facoltativo) Per utilizzare l'elaborazione incrementale anziché l'elaborazione standard predefinita (batch), aggiungete il seguente parametro al corpo della richiesta: ``` "incrementalRunConfig": { "incrementalRunType": "AUTOMATIC" } ``` 1. Inviare la richiesta . 1. In caso di successo, riceverai una risposta con il codice di stato 200 e un corpo JSON contenente: ``` { "workflowArn": "string", "workflowName": "string", // Plus all configured workflow details } ``` 1. Se la chiamata non va a buon fine, potresti ricevere uno di questi errori: + 400 — ConflictException se il nome del flusso di lavoro esiste già + 400 — ValidationException se la convalida dell'input non supera + 402 — ExceedsLimitException se i limiti dell'account vengono superati + 403 — AccessDeniedException se non disponi di un accesso sufficiente + 429 — ThrottlingException se la richiesta è stata limitata + 500 — InternalServerException se si verifica un errore interno del servizio ------