Amazon Fraud Detector non è più aperto a nuovi clienti a partire dal 7 novembre 2025. Per funzionalità simili a Amazon Fraud Detector, esplora Amazon SageMaker, e AutoGluon. AWS WAF 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à. # Archivia i dati degli eventi utilizzando l'importazione in batch Con la funzionalità di importazione in batch, puoi caricare rapidamente e facilmente set di dati storici di eventi di grandi dimensioni in Amazon Fraud Detector utilizzando la console, l'API o l'SDK AWS. Per utilizzare l'importazione in batch, crea un file di input in formato CSV che contenga tutti i dati degli eventi, carica il file CSV nel bucket Amazon S3 e avvia un processo di importazione. * * Amazon Fraud Detector prima convalida i dati in base al tipo di evento, quindi importa automaticamente l'intero set di dati. Una volta importati, i dati sono pronti per essere utilizzati per l'addestramento di nuovi modelli o per il riaddestramento di modelli esistenti. ## File di input e output Il file CSV di input deve contenere intestazioni che corrispondano alle variabili definite nel tipo di evento associato più quattro variabili obbligatorie. Per ulteriori informazioni, consulta [Prepara i dati degli eventi per l'archiviazione](prepare-storage-event-data.md). La dimensione massima del file di dati di input è di 20 Gigabyte (GB), ovvero circa 50 milioni di eventi. Il numero di eventi varierà in base alla dimensione dell'evento. Se il processo di importazione è andato a buon fine, il file di output è vuoto. Se l'importazione non è riuscita, il file di output contiene i log degli errori. ## Crea un file CSV Amazon Fraud Detector importa i dati solo da file in formato CSV (valori separati da virgole). La prima riga del file CSV deve contenere intestazioni di colonna che corrispondano esattamente alle variabili definite nel tipo di evento associato più quattro variabili obbligatorie: EVENT\_ID, EVENT\_TIMESTAMP, ENTITY\_ID e ENTITY\_TYPE. Puoi anche includere facoltativamente EVENT\_LABEL e LABEL\_TIMESTAMP (LABEL\_TIMESTAMP è obbligatorio se EVENT\_LABEL è incluso). **Definire le variabili obbligatorie ** Le variabili obbligatorie sono considerate metadati degli eventi e devono essere specificate in lettere maiuscole. I metadati degli eventi vengono inclusi automaticamente per l'addestramento del modello. La tabella seguente elenca le variabili obbligatorie, la descrizione di ciascuna variabile e il formato richiesto per la variabile. | Nome | Description | Requisiti | | --- | --- | --- | | EVENT\_ID | Un identificatore per l'evento. Ad esempio, se il tuo evento è una transazione online, EVENT\_ID potrebbe essere il numero di riferimento della transazione fornito al cliente. | + L'EVENT\_ID è obbligatorio per i processi di importazione in batch.
+ Deve essere univoco per quell'evento.
+ Dovrebbe rappresentare informazioni significative per la tua attività.
+ Deve soddisfare il modello delle espressioni regolari (ad esempio `^[0-9a-z_-]+$.)`
+ Non è consigliabile aggiungere un timestamp a EVENT\_ID. Questa operazione potrebbe causare problemi durante l'aggiornamento dell'evento. Questo perché in questo caso devi fornire esattamente lo stesso EVENT\_ID. | | EVENT\_TIMESTAMP | Il timestamp di quando si è verificato l'evento. Il timestamp deve essere conforme allo standard ISO 8601 in UTC. | + L'EVENT\_TIMESTAMP è richiesto per i processi di importazione in batch.
+ Deve essere specificato in uno dei seguenti formati: %YYYY-%MM-%DDT%HH: %mm: %ssZ (standard ISO 8601 in UTC solo senza millisecondi)
Esempio: 2019-11-30 T13:01:01Z %aaaa/%mm/%dd %hh: %mm: %ss () AM/PM
Esempi 2019/11: /30 1:01:01 PM o /30 13:01:01 2019/11 %mm/%dd/%yyyy %hh: %mm: %ss
Esempi: /2019 1:01:01 PM, /2019 11/30 13:01:01 11/30 %mm/%dd/%yy %hh: %mm: %s
Esempi: /19 1:01:01 PM, /19 11/30 13:01:01 11/30
+ Amazon Fraud Detector formula le seguenti ipotesi durante l'analisi dei formati per i timestamp degli eventi: date/timestamp Se utilizzi lo standard ISO 8601, deve corrispondere esattamente alla specifica precedente Se si utilizza uno degli altri formati, c'è un'ulteriore flessibilità: Per mesi e giorni, puoi fornire cifre singole o doppie. Ad esempio, 1/12 /2019 è una data valida. Non è necessario includere hh:mm:ss se non li hai (ovvero, puoi semplicemente fornire una data). Puoi anche fornire un sottoinsieme delle sole ore e minuti (ad esempio, hh:mm). La semplice indicazione delle ore non è supportata. Inoltre, i millisecondi non sono supportati. Se si forniscono AM/PM etichette, si presume un orologio a 12 ore. Se non ci sono AM/PM informazioni, si presume un orologio a 24 ore. È possibile utilizzare «/» o «-» come delimitatori per gli elementi di data. Si presume «:» per gli elementi timestamp. | | ENTITY\_ID | Un identificatore per l'entità che esegue l'evento. | + ENTITY\_ID è richiesto per i processi di importazione in batch
+ Deve seguire lo schema delle espressioni regolari:. `^[0-9A-Za-z_.@+-]+$`
+ Se l'id dell'entità non è disponibile al momento della valutazione, specifica l'id dell'entità come * sconosciuto*. | | TIPO\_DI\_ENTITÀ | L'entità che esegue l'evento, ad esempio un commerciante o un cliente | ENTITY\_TYPE è obbligatorio per i processi di importazione in batch | | EVENT\_LABEL | Classifica l'evento come o `fraudulent` `legitimate` | EVENT\_LABEL è obbligatorio se LABEL\_TIMESTAMP è incluso | | LABEL\_TIMESTAMP | Il timestamp dell'ultima volta che l'etichetta dell'evento è stata compilata o aggiornata | + LABEL\_TIMESTAMP è obbligatorio se EVENT\_LABEL è incluso.
+ Deve seguire il formato timestamp. | ## Carica il file CSV su Amazon S3 per l'importazione in batch Dopo aver creato un file CSV con i tuoi dati, carica il file nel tuo bucket Amazon Simple Storage Service (Amazon S3). **Per caricare i dati degli eventi in un bucket Amazon S3** 1. Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [ https://console.aws.amazon.com/s3/ ](https://console.aws.amazon.com/s3/) 1. Scegliere **Create bucket (Crea bucket)**. Si apre la procedura guidata **Create bucket (Crea bucket)**. 1. In Nome ** bucket**, inserisci un DNS-compliant nome per il tuo bucket. Il nome del bucket deve: + Essere univoco in tutto Amazon S3. + Deve contenere da 3 a 63 caratteri + Non contiene caratteri maiuscoli. + Iniziare con una lettera minuscola o un numero. Una volta creato il bucket, non è possibile modificarne il nome. Per informazioni sulla denominazione dei bucket, consulta le regole di denominazione dei [ bucket ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) nella * Amazon Simple Storage Service User Guide. * **Importante** Evitare di includere informazioni riservate, ad esempio numeri di account, nel nome del bucket. Il nome bucket è visibile nell'URL che punta agli oggetti nel bucket. 1. In ** Regione**, scegli la AWS regione in cui desideri che il bucket risieda. Devi selezionare la stessa regione in cui stai utilizzando Amazon Fraud Detector, ovvero Stati Uniti orientali (Virginia settentrionale), Stati Uniti orientali (Ohio), Stati Uniti occidentali (Oregon), Europa (Irlanda), Asia Pacifico (Singapore) o Asia Pacifico (Sydney). 1. In **Bucket settings for Block Public Access (Impostazioni bucket per blocco dell'accesso pubblico)**, scegliere le impostazioni del blocco dell'accesso pubblico che si desidera applicare al bucket. Ti consigliamo di lasciare tutte le impostazioni abilitate. Per ulteriori informazioni sul blocco dell'accesso pubblico, consulta [ Bloccare l'accesso pubblico allo storage Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html) nella * Amazon Simple Storage Service User Guide*. 1. Seleziona **Crea bucket**. 1. Carica il file dei dati di formazione nel tuo bucket Amazon S3. Annota il percorso di localizzazione di Amazon S3 per il tuo file di training (ad esempio, s3://.csv). bucketname/object ## Importazione in batch dei dati degli eventi nella console Amazon Fraud Detector Puoi importare facilmente un gran numero di set di dati sugli eventi nella console Amazon Fraud Detector, utilizzando l'`CreateBatchImportJob`API o l'SDK AWS. Prima di procedere, assicurati di aver seguito le istruzioni per preparare il set di dati come file CSV. Assicurati di aver caricato anche il file CSV in un bucket Amazon S3. **Utilizzo della console Amazon Fraud Detector ** **Per importare in batch i dati degli eventi nella console** 1. Apri la Console AWS, accedi al tuo account e accedi ad Amazon Fraud Detector. 1. Nel riquadro di navigazione a sinistra, scegli ** Eventi**. 1. Scegli il tipo di evento. 1. Seleziona la ** scheda Eventi ** memorizzati. 1. Nel ** riquadro dei dettagli degli eventi ** memorizzati, assicurati che l'**inserimento degli eventi ** sia ** attivo. ** 1. Nel ** riquadro dati ** Importa eventi, scegli ** Nuova importazione. ** 1. Nella ** pagina di importazione di ** nuovi eventi, fornisci le seguenti informazioni: + [Consigliato] Lascia ** Abilita Smart Data Validation per questo set di dati: nuovo ** set alle impostazioni predefinite. + Per il ruolo ** IAM per i dati**, seleziona il ruolo IAM che hai creato per il bucket Amazon S3 che contiene il file CSV che intendi importare. + Per la posizione dei dati ** di input**, inserisci la posizione S3 in cui hai il tuo file CSV. + Se desideri specificare una posizione separata in cui archiviare i risultati dell'importazione, fai clic sul ** pulsante Posizione dati ** separata per input e risultati e fornisci una posizione del bucket Amazon S3 valida. **Importante** Assicurati che il ruolo IAM selezionato disponga delle autorizzazioni di lettura per il bucket Amazon S3 di input e delle autorizzazioni di scrittura per il bucket Amazon S3 di output. 1. Scegli **Avvia**. 1. La ** colonna ** Status nel ** riquadro dati ** Import events mostra lo stato del processo di convalida e importazione. Il banner in alto fornisce una descrizione di alto livello dello stato man mano che il set di dati viene prima convalidato e poi importato. 1. Segui le indicazioni fornite a. [Monitora lo stato di avanzamento della convalida e del processo di importazione dei set di dati](#monitor-progress-sdv) ### Monitora lo stato di avanzamento della convalida e del processo di importazione dei set di dati Se utilizzi la console Amazon Fraud Detector per eseguire un processo di importazione in batch, per impostazione predefinita, Amazon Fraud Detector convalida il set di dati prima dell'importazione. Puoi monitorare l'avanzamento e lo stato dei processi di convalida e importazione nella ** pagina di importazione di ** nuovi eventi della console Amazon Fraud Detector. Un banner nella parte superiore della pagina fornisce una breve descrizione dei risultati della convalida e dello stato del processo di importazione. A seconda dei risultati della convalida e dello stato del processo di importazione, potrebbe essere necessario intraprendere azioni per garantire la corretta convalida e importazione del set di dati. La tabella seguente fornisce i dettagli delle azioni da intraprendere in base all'esito delle operazioni di convalida e importazione. | Messaggio banner | Stato | Significato | Cosa devo fare | | --- | --- | --- | --- | | La convalida dei dati è iniziata | Convalida in corso | SDV ha iniziato a convalidare il tuo set di dati | Attendi che lo stato cambi | | La convalida dei dati non può procedere a causa di errori nel set di dati. Correggi gli errori nel file di dati e avvia un nuovo processo di importazione. Per ulteriori informazioni, consulta il rapporto di convalida | Convalida non riuscita | SDV ha identificato dei problemi nel tuo file di dati. Questi problemi devono essere risolti per una corretta importazione del set di dati. | Nel riquadro dei dati degli eventi di importazione, seleziona il Job Id e visualizza il rapporto di convalida. Segui i consigli contenuti nel rapporto per risolvere tutti gli errori elencati. Per ulteriori informazioni, consulta [Utilizzo del rapporto di convalida](#using-sdv-validation-report). | | L'importazione dei dati è iniziata. La convalida è stata completata con successo | Importazione in corso | Il tuo set di dati ha superato la convalida. AFD ha iniziato a importare il tuo set di dati | Attendi che lo stato cambi | | Convalida completata con avvisi. L'importazione dei dati è iniziata | Importazione in corso | La convalida di alcuni dati del set di dati non è riuscita. Tuttavia, i dati che hanno superato la convalida soddisfano i requisiti di dimensione minima dei dati per l'importazione. | Monitora il messaggio nel banner e attendi che lo stato cambi | | I tuoi dati sono stati importati parzialmente. Alcuni dati non sono stati convalidati e non sono stati importati. Per ulteriori informazioni, consulta il rapporto di convalida. | Importato. Lo stato mostra un'icona di avviso. | Alcuni dei dati del file di dati la cui convalida non è stata completata non sono stati importati. Il resto dei dati che hanno superato la convalida è stato importato. | Nel riquadro dati Importa eventi, seleziona il Job Id e visualizza il rapporto di convalida. Segui i consigli nella tabella degli avvisi a livello di dati per risolvere gli avvisi elencati. Non è necessario rispondere a tutti gli avvisi. Tuttavia, assicurati che il tuo set di dati contenga più del 50% di dati che superino la convalida per un'importazione corretta. Dopo aver risolto gli avvisi, avvia un nuovo processo di importazione. Per ulteriori informazioni, consulta [Utilizzo del rapporto di convalida](#using-sdv-validation-report). | | Importazione dei dati non riuscita a causa di un errore di elaborazione. Inizia un nuovo processo di importazione dei dati | Importazione non riuscita | L'importazione non è riuscita a causa di un errore transitorio in fase di esecuzione | Inizia un nuovo processo di importazione | | I dati sono stati importati con successo | Importato | La convalida e l'importazione sono state completate correttamente | Selezionate il Job Id del processo di importazione per visualizzarne i dettagli, quindi procedete con l'addestramento del modello | **Nota** Ti consigliamo di attendere 10 minuti dopo che il set di dati è stato importato correttamente in Amazon Fraud Detector per assicurarti che sia stato completamente inserito dal sistema. ### Rapporto di convalida dei dati intelligenti Lo Smart Data Validation crea un rapporto di convalida al termine della convalida. Il rapporto di convalida fornisce dettagli su tutti i problemi che l'SDV ha identificato nel set di dati, con azioni suggerite per risolvere i problemi di maggiore impatto. È possibile utilizzare il rapporto di convalida per determinare quali sono i problemi, dove si trovano nel set di dati, la gravità dei problemi e come risolverli. Il rapporto di convalida viene creato anche quando la convalida viene completata con successo. In questo caso, puoi visualizzare il rapporto per vedere se sono elencati dei problemi e, se ce ne sono, decidere se vuoi risolverli. **Nota** La versione corrente di SDV analizza il set di dati per individuare eventuali problemi che potrebbero causare il fallimento dell'importazione in batch. Se la convalida e l'importazione in batch hanno esito positivo, il set di dati può ancora presentare problemi che potrebbero causare il fallimento dell'addestramento del modello. Ti consigliamo di visualizzare il rapporto di convalida anche se la convalida e l'importazione sono andate a buon fine e di risolvere eventuali problemi elencati nel rapporto per una corretta formazione del modello. Dopo aver risolto i problemi, create un nuovo processo di importazione in batch. **Accesso al rapporto di convalida ** È possibile accedere al rapporto di convalida in qualsiasi momento dopo il completamento della convalida utilizzando una delle seguenti opzioni: 1. Al termine della convalida e mentre il processo di importazione è in corso, nel banner in alto, scegli Visualizza rapporto di convalida. ** ** 1. Al termine del processo di importazione, nel ** riquadro dati ** Importa eventi, scegli l'ID del processo di importazione appena completato. #### Utilizzo del rapporto di convalida La pagina del rapporto di convalida del processo di importazione fornisce i dettagli di questo processo di importazione, un elenco degli eventuali errori critici, un elenco di avvisi su eventi specifici (righe) nel set di dati, se trovati, e un breve riepilogo del set di dati che include informazioni quali valori non validi e valori mancanti per ogni variabile. + **Dettagli del processo di importazione ** Fornisce i dettagli del processo di importazione. Se il processo di importazione non è riuscito o il set di dati è stato importato parzialmente, scegli ** Vai al file dei risultati ** per visualizzare i log degli errori degli eventi che non sono stati importati. + **Errori critici ** Fornisce dettagli sui problemi più importanti nel set di dati identificato da SDV. Tutti i problemi elencati in questo riquadro sono critici ed è necessario risolverli prima di procedere con l'importazione. Se si tenta di importare il set di dati senza risolvere i problemi critici, il processo di importazione potrebbe fallire. Per risolvere i problemi critici, segui i consigli forniti per ogni avviso. Dopo aver risolto tutti i problemi elencati nel riquadro Errori critici, crea un nuovo processo di importazione in batch. + **Avvisi a livello di dati ** Fornisce un riepilogo degli avvisi per eventi specifici (righe) nel set di dati. Se il riquadro Avvisi a livello di dati è popolato, alcuni eventi del set di dati non sono stati convalidati e non sono stati importati. Per ogni avviso, la ** colonna ** Descrizione mostra il numero di eventi che presentano il problema. Inoltre, gli ID di evento di esempio ** forniscono un elenco parziale di ID evento di esempio che puoi utilizzare come punto di partenza per individuare gli altri eventi che presentano il problema. ** Utilizza la ** raccomandazione ** fornita per l'avviso per risolvere il problema. Utilizza anche i log degli errori del file di output per ulteriori informazioni sul problema. I log degli errori vengono generati per tutti gli eventi che non sono riusciti a importare in batch. Per accedere ai log degli errori, nel ** riquadro dei dettagli del processo di ** importazione, scegli ** Vai al file dei risultati**. **Nota** Se più del 50% degli eventi (righe) nel set di dati non è stato convalidato, anche il processo di importazione ha esito negativo. In questo caso, è necessario correggere i dati prima di iniziare un nuovo processo di importazione. + **Riepilogo del set di dati ** Fornisce un riepilogo del rapporto di convalida del set di dati. Se la colonna Numero di avvisi mostra più di 0 avvisi, decidi se devi correggerli. Se la ** colonna ** Numero di avvisi mostra 0, continua ad addestrare il tuo modello. ## Importazione in batch dei dati degli eventi utilizzando l'SDK AWS per Python (Boto3) L'esempio seguente mostra un esempio di richiesta di API. [ CreateBatchImportJob ](https://docs.aws.amazon.com/frauddetector/latest/api/API_CreateBatchImportJob.html) Un processo di importazione in batch deve includere ** JobID**, ** inputPath, ** outputPath**, event ** e iam. ** TypeName ** ** RoleArn ** Il JobID non può contenere lo stesso ID di un lavoro precedente, a meno che il lavoro non esista nello stato CREATE\_FAILED. InputPath e outputPath devono essere percorsi S3 validi. Puoi scegliere di non specificare il nome del file in outputPath, tuttavia, dovrai comunque fornire una posizione del bucket S3 valida. L'evento e iam devono esistereTypeName . RoleArn Il ruolo IAM deve concedere i permessi di lettura per l'input del bucket Amazon S3 e i permessi di scrittura per l'output del bucket Amazon S3. ``` import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.create_batch_import_job ( jobId = 'sample_batch_import', inputPath = 's3://bucket_name/input_file_name.csv', outputPath = 's3://bucket_name/', eventTypeName = 'sample_registration', iamRoleArn: 'arn:aws:iam::************:role/service-role/AmazonFraudDetector-DataAccessRole-*************' ) ``` ## Annulla il processo di importazione in batch Puoi annullare un processo di importazione in batch in corso in qualsiasi momento nella console Amazon Fraud Detector, utilizzando l'`CancelBatchImportJob`API o l'SDK AWS. **Per annullare un processo di importazione in batch nella console,** 1. Apri la Console AWS, accedi al tuo account e accedi ad Amazon Fraud Detector. 1. Nel riquadro di navigazione a sinistra, scegli ** Eventi**. 1. Scegli il tipo di evento. 1. Seleziona la ** scheda Eventi ** memorizzati. 1. Nel ** riquadro dati ** Importa eventi, scegli l'ID del processo di importazione in corso che desideri annullare. 1. Nella pagina del processo dell'evento, fai clic su ** Azioni ** e seleziona ** Annulla importazione ** eventi. 1. Scegli ** Interrompi l'importazione degli eventi ** per annullare il processo di importazione in batch. ### Annullamento del processo di importazione in batch utilizzando l'SDK AWS per Python (Boto3) L'esempio seguente mostra un esempio di richiesta per l'API. `CancelBatchImportJob` L'operazione di annullamento dell'importazione deve includere l'ID del processo di importazione in batch in corso. ``` import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.cancel_batch_import_job ( jobId = 'sample_batch' ) ```