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. 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. |
|
|
EVENT_TIMESTAMP |
Il timestamp di quando si è verificato l'evento. Il timestamp deve essere conforme allo standard ISO 8601 in UTC. |
|
|
ENTITY_ID |
Un identificatore per l'entità che esegue l'evento. |
|
|
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 |
EVENT_LABEL è obbligatorio se LABEL_TIMESTAMP è incluso |
|
LABEL_TIMESTAMP |
Il timestamp dell'ultima volta che l'etichetta dell'evento è stata compilata o aggiornata |
|
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
Accedi Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/
-
Scegliere Create bucket (Crea bucket).
Si apre la procedura guidata Create bucket (Crea bucket).
-
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 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.
-
-
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).
-
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 nella Amazon Simple Storage Service User Guide.
-
Seleziona Crea bucket.
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'CreateBatchImportJobAPI 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
-
Apri la Console AWS, accedi al tuo account e accedi ad Amazon Fraud Detector.
-
Nel riquadro di navigazione a sinistra, scegli Eventi.
-
Scegli il tipo di evento.
-
Seleziona la scheda Eventi memorizzati.
-
Nel riquadro dei dettagli degli eventi memorizzati, assicurati che l'inserimento degli eventi sia attivo.
-
Nel riquadro dati Importa eventi, scegli Nuova importazione.
-
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.
-
-
Scegli Avvia.
-
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.
-
Segui le indicazioni fornite a. Monitora lo stato di avanzamento della convalida e del processo di importazione dei set di dati
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. |
| 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. |
| 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:
-
Al termine della convalida e mentre il processo di importazione è in corso, nel banner in alto, scegli Visualizza rapporto di convalida.
-
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 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'CancelBatchImportJobAPI o l'SDK AWS.
Per annullare un processo di importazione in batch nella console,
-
Apri la Console AWS, accedi al tuo account e accedi ad Amazon Fraud Detector.
-
Nel riquadro di navigazione a sinistra, scegli Eventi.
-
Scegli il tipo di evento.
-
Seleziona la scheda Eventi memorizzati.
-
Nel riquadro dati Importa eventi, scegli l'ID del processo di importazione in corso che desideri annullare.
-
Nella pagina del processo dell'evento, fai clic su Azioni e seleziona Annulla importazione eventi.
-
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' )
