View a markdown version of this page

Stockez les données des événements par importation par lots - Amazon Fraud Detector

Amazon Fraud Detector n'est plus ouvert aux nouveaux clients depuis le 7 novembre 2025. Pour des fonctionnalités similaires à celles d'Amazon Fraud Detector SageMaker, explorez Amazon AutoGluon, et AWS WAF.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Stockez les données des événements par importation par lots

Grâce à la fonction d'importation par lots, vous pouvez télécharger rapidement et facilement de grands ensembles de données d'événements historiques dans Amazon Fraud Detector à l'aide de la console, de l'API ou du SDK AWS. Pour utiliser l'importation par lots, créez un fichier d'entrée au format CSV contenant toutes les données de votre événement, chargez le fichier CSV dans un compartiment Amazon S3 et lancez une tâche d'importation. Amazon Fraud Detector valide d'abord les données en fonction du type d'événement, puis importe automatiquement l'ensemble de données. Une fois les données importées, elles sont prêtes à être utilisées pour entraîner de nouveaux modèles ou pour réentraîner des modèles existants.

Fichiers d'entrée et de sortie

Le fichier CSV d'entrée doit contenir des en-têtes correspondant aux variables définies dans le type d'événement associé, ainsi que quatre variables obligatoires. Pour plus d’informations, consultez Préparer les données d'événements pour le stockage. La taille maximale du fichier de données d'entrée est de 20 gigaoctets (Go), soit environ 50 millions d'événements. Le nombre d'événements varie en fonction de la taille de votre événement. Si la tâche d'importation a réussi, le fichier de sortie est vide. Si l'importation échoue, le fichier de sortie contient les journaux d'erreurs.

Création d'un fichier CSV

Amazon Fraud Detector importe les données uniquement à partir de fichiers au format CSV (valeurs séparées par des virgules). La première ligne de votre fichier CSV doit contenir des en-têtes de colonne qui correspondent exactement aux variables définies dans le type d'événement associé, ainsi que quatre variables obligatoires : EVENT_ID, EVENT_TIMESTAMP, ENTITY_ID et ENTITY_TYPE. Vous pouvez également inclure EVENT_LABEL et LABEL_TIMESTAMP (LABEL_TIMESTAMP est obligatoire si EVENT_LABEL est inclus).

Définissez les variables obligatoires

Les variables obligatoires sont considérées comme des métadonnées d'événements et doivent être spécifiées en majuscules. Les métadonnées des événements sont automatiquement incluses pour l'entraînement des modèles. Le tableau suivant répertorie les variables obligatoires, la description de chaque variable et le format requis pour la variable.

Nom Description Exigences

IDENTIFIANT DE L'ÉVÉNEMENT

Un identifiant pour l'événement. Par exemple, si votre événement est une transaction en ligne, l'EVENT_ID peut être le numéro de référence de la transaction qui a été fourni à votre client.

  • L'EVENT_ID est obligatoire pour les tâches d'importation par lots.

  • Il doit être unique pour cet événement.

  • Il doit représenter des informations pertinentes pour votre entreprise.

  • Il doit respecter le modèle d'expression régulière (par exemple, ^[0-9a-z_-]+$.)

  • Nous vous déconseillons d'ajouter un horodatage à l'EVENT_ID. Cela peut entraîner des problèmes lors de la mise à jour de l'événement. Ceci parce que vous devez fournir exactement le même EVENT_ID si vous le faites.

HORODATAGE DE L'ÉVÉNEMENT

Horodatage de la date à laquelle l'événement s'est produit. L'horodatage doit être conforme à la norme ISO 8601 en UTC.

  • L'EVENT_TIMESTAMP est obligatoire pour les tâches d'importation par lots.

  • Il doit être spécifié dans l'un des formats suivants :

    • %yyyy-%mm-%DDT%Hh : %mm : %sSz (norme ISO 8601 en UTC uniquement, sans millisecondes)

      Exemple : 2019-11-30 T13:01:01Z

    • %aaaa/%mm/%dd %h : %mm : %s () AM/PM

      Exemples : 2019/11 /30 13:01:01 PM, ou /30 13:01:01 2019/11

    • %mm/%j/%aaaa %h : %mm : %s

      Exemples : 11/30 /2019 1:01:01 PM, /2019 13:01:01 11/30

    • %mm/%dd/%yy %h : %mm : %s

      Exemples : 11/30 /19 13:01:01 PM, /19 13:01:01 11/30

  • Amazon Fraud Detector part des hypothèses suivantes lors de l'analyse des date/timestamp formats pour l'horodatage des événements :

    • Si vous utilisez la norme ISO 8601, elle doit correspondre exactement à la spécification précédente

    • Si vous utilisez l'un des autres formats, vous bénéficiez d'une flexibilité supplémentaire :

      • Pour les mois et les jours, vous pouvez fournir un ou deux chiffres. Par exemple, 1/12 /2019 est une date valide.

      • Vous n'avez pas besoin d'inclure hh:mm:ss si vous ne les avez pas (c'est-à-dire que vous pouvez simplement fournir une date). Vous pouvez également fournir un sous-ensemble de l'heure et des minutes uniquement (par exemple, hh:mm). Le simple fait de fournir l'heure n'est pas pris en charge. Les millisecondes ne sont pas non plus prises en charge.

      • Si vous fournissez des AM/PM étiquettes, une horloge de 12 heures est supposée. S'il n'y a aucune AM/PM information, une horloge de 24 heures est supposée.

      • Vous pouvez utiliser «/» ou « - » comme délimiteurs pour les éléments de date. « : » est supposé pour les éléments d'horodatage.

IDENTIFIANT_ENTITÉ

Un identifiant pour l'entité qui réalise l'événement.

  • ENTITY_ID est requis pour les tâches d'importation par lots

  • Il doit suivre le modèle d'expression régulière :^[0-9A-Za-z_.@+-]+$.

  • Si l'identifiant de l'entité n'est pas disponible au moment de l'évaluation, spécifiez-le comme inconnu.

TYPE_D'ENTITÉ

L'entité qui organise l'événement, telle qu'un commerçant ou un client

ENTITY_TYPE est requis pour les tâches d'importation par lots

ÉTIQUET_ÉVÉNEMENT

Classe l'événement comme ou fraudulent legitimate

EVENT_LABEL est obligatoire si LABEL_TIMESTAMP est inclus

LABEL_TIMESTAMP

Horodatage de la dernière saisie ou mise à jour du libellé de l'événement

  • LABEL_TIMESTAMP est obligatoire si EVENT_LABEL est inclus.

  • Il doit respecter le format d'horodatage.

Charger un fichier CSV sur Amazon S3 pour l'importation par lots

Après avoir créé un fichier CSV contenant vos données, chargez-le dans votre compartiment Amazon Simple Storage Service (Amazon S3).

Pour télécharger les données d'événements vers un compartiment Amazon S3
  1. Connectez-vous à Console de gestion AWS et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

  2. Choisissez Créer un compartiment.

    L'Assistant Create bucket (Créer un compartiment) s'ouvre.

  3. Dans Nom du compartiment, entrez DNS-compliant le nom de votre compartiment.

    Le nom du compartiment doit présenter les caractéristiques suivantes :

    • Il doit être unique sur l'ensemble d'Amazon S3.

    • Il doit comporter entre 3 et 63 caractères.

    • Ne contient pas de majuscules.

    • Il doit commencer par une minuscule ou un chiffre.

    Une fois le compartiment créé, vous ne pouvez pas changer son nom. Pour plus d'informations sur la dénomination des compartiments, consultez la section Règles de dénomination des compartiments dans le guide de l'utilisateur d'Amazon Simple Storage Service.

    Important

    Évitez d’inclure des informations sensibles, notamment des numéros de compte, dans le nom du compartiment. Le nom de compartiment est visible dans les URL qui pointent vers les objets du compartiment.

  4. Dans Région, choisissez la AWS région dans laquelle vous souhaitez placer le compartiment. Vous devez sélectionner la même région que celle dans laquelle vous utilisez Amazon Fraud Detector, à savoir USA Est (Virginie du Nord), USA Est (Ohio), USA Ouest (Oregon), Europe (Irlande), Asie-Pacifique (Singapour) ou Asie-Pacifique (Sydney).

  5. Dans Paramètres de compartiment pour Bloquer l'accès public, choisissez les paramètres de blocage de l'accès public que vous souhaitez appliquer au compartiment.

    Nous vous recommandons de laisser tous les paramètres activés. Pour plus d'informations sur le blocage de l'accès public, consultez la section Blocage de l'accès public à votre stockage Amazon S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

  6. Choisissez Créer un compartiment.

  7. Téléchargez le fichier de données d'entraînement dans votre compartiment Amazon S3. Notez le chemin de localisation Amazon S3 pour votre fichier de formation (par exemple, s3 ://bucketname/object.csv).

Importation par lots de données d'événements dans la console Amazon Fraud Detector

Vous pouvez facilement importer un grand nombre de vos ensembles de données d'événements dans la console Amazon Fraud Detector, à l'aide de l'CreateBatchImportJobAPI ou du SDK AWS. Avant de poursuivre, assurez-vous d'avoir suivi les instructions pour préparer votre jeu de données sous forme de fichier CSV. Assurez-vous que vous avez également chargé le fichier CSV dans un compartiment Amazon S3.

Utilisation de la console Amazon Fraud Detector

Pour importer par lots des données d'événements dans la console
  1. Ouvrez la console AWS, connectez-vous à votre compte, puis accédez à Amazon Fraud Detector.

  2. Dans le volet de navigation de gauche, sélectionnez Événements.

  3. Choisissez votre type d'événement.

  4. Sélectionnez l'onglet Événements enregistrés.

  5. Dans le volet Détails des événements stockés, assurez-vous que l'ingestion d'événements est activée.

  6. Dans le volet Importer les données des événements, choisissez Nouvelle importation.

  7. Sur la page d'importation de nouveaux événements, fournissez les informations suivantes :

    • [Recommandé] Laissez Activer la validation des données intelligentes pour cet ensemble de données - nouveau défini sur le paramètre par défaut.

    • Pour le rôle IAM pour les données, sélectionnez le rôle IAM que vous avez créé pour le compartiment Amazon S3 qui contient le fichier CSV que vous prévoyez d'importer.

    • Pour Emplacement des données d'entrée, entrez l'emplacement S3 où se trouve votre fichier CSV.

    • Si vous souhaitez spécifier un emplacement distinct pour stocker les résultats de vos importations, cliquez sur le bouton Emplacement des données distinct pour les entrées et les résultats et indiquez un emplacement de compartiment Amazon S3 valide.

    Important

    Assurez-vous que le rôle IAM que vous avez sélectionné possède des autorisations de lecture sur votre compartiment Amazon S3 d'entrée et des autorisations d'écriture sur votre compartiment Amazon S3 de sortie.

  8. Sélectionnez Démarrer.

  9. La colonne État du volet Importer les données des événements affiche l'état de votre tâche de validation et d'importation. La bannière en haut de la page fournit une description détaillée de l'état de votre jeu de données lors de sa validation, puis de son importation.

  10. Suivez les instructions fournies àSurveillez la progression de la validation de l'ensemble de données et de la tâche d'importation.

Surveillez la progression de la validation de l'ensemble de données et de la tâche d'importation

Si vous utilisez la console Amazon Fraud Detector pour effectuer une tâche d'importation par lots, Amazon Fraud Detector valide par défaut votre ensemble de données avant l'importation. Vous pouvez suivre la progression et l'état des tâches de validation et d'importation sur la page d'importation de nouveaux événements de la console Amazon Fraud Detector. Une bannière en haut de la page fournit une brève description des résultats de validation et de l'état de la tâche d'importation. En fonction des résultats de validation et de l'état de votre tâche d'importation, vous devrez peut-être prendre des mesures pour garantir la réussite de la validation et de l'importation de votre jeu de données.

Le tableau suivant détaille les actions que vous devez effectuer en fonction du résultat des opérations de validation et d'importation.

Message sur la bannière Statut Ce que cela signifie Que dois-je faire
La validation des données a commencé Validation en cours SDV a commencé à valider votre jeu de données Attendez que le statut change
La validation des données ne peut pas avoir lieu en raison d'erreurs dans votre ensemble de données. Corrigez les erreurs dans votre fichier de données et lancez une nouvelle tâche d'importation. Consultez le rapport de validation pour plus d'informations La validation a échoué SDV a identifié des problèmes dans votre fichier de données. Ces problèmes doivent être résolus pour que l'importation de votre jeu de données soit réussie. Dans le volet Importer les données des événements, sélectionnez l'ID de tâche et consultez le rapport de validation. Suivez les recommandations du rapport pour corriger toutes les erreurs répertoriées. Pour de plus amples informations, veuillez consulter Utilisation du rapport de validation.
L'importation des données a commencé. Validation terminée avec succès Importation en cours Votre ensemble de données a passé la validation. L'AFD a commencé à importer votre jeu de données Attendez que le statut change
Validation terminée avec avertissements. L'importation des données a commencé Importation en cours Certaines données de votre jeu de données n'ont pas été validées. Cependant, les données qui ont été validées répondent aux exigences de taille de données minimales pour l'importation. Surveillez le message dans la bannière et attendez que le statut change
Vos données ont été partiellement importées. Certaines données n'ont pas été validées et n'ont pas été importées. Consultez le rapport de validation pour plus d'informations. Importé. L'état affiche une icône d'avertissement. Certaines données de votre fichier de données dont la validation a échoué n'ont pas été importées. Le reste des données validées a été importé. Dans le volet Importer les données des événements, sélectionnez l'ID de tâche et consultez le rapport de validation. Suivez les recommandations du tableau des avertissements relatifs aux niveaux de données pour répondre aux avertissements répertoriés. Il n'est pas nécessaire de répondre à tous les avertissements. Assurez-vous toutefois que plus de 50 % des données de votre jeu de données sont validées pour une importation réussie. Après avoir répondu aux avertissements, lancez une nouvelle tâche d'importation. Pour de plus amples informations, veuillez consulter Utilisation du rapport de validation.
L'importation des données a échoué en raison d'une erreur de traitement. Démarrer une nouvelle tâche d'importation de données Échec de l’importation L'importation a échoué en raison d'une erreur d'exécution transitoire Démarrer une nouvelle tâche d'importation
Les données ont été importées avec succès Importé La validation et l'importation ont été effectuées avec succès Sélectionnez l'ID de tâche de votre tâche d'importation pour afficher les détails, puis passez à la formation sur le modèle
Note

Nous vous recommandons d'attendre 10 minutes après l'importation réussie de l'ensemble de données dans Amazon Fraud Detector pour vous assurer qu'il est entièrement absorbé par le système.

Rapport de validation des données intelligentes

La validation des données intelligentes crée un rapport de validation une fois la validation terminée. Le rapport de validation fournit des informations détaillées sur tous les problèmes identifiés par le SDV dans votre ensemble de données, ainsi que des suggestions d'actions pour résoudre les problèmes les plus importants. Vous pouvez utiliser le rapport de validation pour déterminer quels sont les problèmes, où ils se situent dans l'ensemble de données, leur gravité et comment les résoudre. Le rapport de validation est créé même lorsque la validation est terminée avec succès. Dans ce cas, vous pouvez consulter le rapport pour voir si des problèmes sont répertoriés et, le cas échéant, décider si vous souhaitez les résoudre.

Note

La version actuelle de SDV analyse votre jeu de données à la recherche de problèmes susceptibles d'entraîner l'échec de l'importation par lots. Si la validation et l'importation par lots réussissent, votre jeu de données peut toujours présenter des problèmes susceptibles d'entraîner l'échec de l'apprentissage du modèle. Nous vous recommandons de consulter votre rapport de validation même si la validation et l'importation se sont déroulées avec succès, et de résoudre tous les problèmes répertoriés dans le rapport pour une formation réussie sur les modèles. Après avoir résolu les problèmes, créez une nouvelle tâche d'importation par lots.

Accès au rapport de validation

Vous pouvez accéder au rapport de validation à tout moment une fois la validation terminée en utilisant l'une des options suivantes :

  1. Une fois la validation terminée et pendant que la tâche d'importation est en cours, dans la bannière supérieure, choisissez Afficher le rapport de validation.

  2. Une fois la tâche d'importation terminée, dans le volet Données des événements d'importation, choisissez l'ID de la tâche d'importation qui vient de se terminer.

Utilisation du rapport de validation

La page du rapport de validation de votre tâche d'importation fournit les détails de cette tâche d'importation, une liste des erreurs critiques, le cas échéant, une liste d'avertissements concernant des événements spécifiques (lignes) dans votre jeu de données, et un bref résumé de votre ensemble de données qui inclut des informations telles que les valeurs non valides et les valeurs manquantes pour chaque variable.

  • Importer les détails de la tâche

    Fournit des détails sur la tâche d'importation. Si votre tâche d'importation a échoué ou si votre jeu de données a été partiellement importé, choisissez Accéder au fichier de résultats pour afficher les journaux d'erreurs des événements qui n'ont pas pu être importés.

  • Erreurs critiques

    Fournit des détails sur les problèmes les plus importants identifiés par SDV dans votre ensemble de données. Tous les problèmes répertoriés dans ce volet sont critiques et vous devez les résoudre avant de procéder à l'importation. Si vous essayez d'importer votre jeu de données sans résoudre les problèmes critiques, votre tâche d'importation risque d'échouer.

    Pour résoudre les problèmes critiques, suivez les recommandations fournies pour chaque avertissement. Après avoir résolu tous les problèmes répertoriés dans le volet Erreurs critiques, créez une nouvelle tâche d'importation par lots.

  • Avertissements relatifs au niveau des données

    Fournit un résumé des avertissements relatifs à des événements spécifiques (lignes) de votre jeu de données. Si le volet Avertissements relatifs au niveau des données est rempli, cela signifie que certains événements de votre jeu de données n'ont pas été validés et n'ont pas été importés.

    Pour chaque avertissement, la colonne Description affiche le nombre d'événements présentant le problème. De plus, les exemples d'ID d'événement fournissent une liste partielle d'exemples d'ID d'événement que vous pouvez utiliser comme point de départ pour localiser les autres événements présentant le problème. Utilisez la recommandation fournie pour l'avertissement afin de résoudre le problème. Utilisez également les journaux d'erreurs de votre fichier de sortie pour obtenir des informations supplémentaires sur le problème. Les journaux d'erreurs sont générés pour tous les événements qui ont échoué lors de l'importation par lots. Pour accéder aux journaux d'erreurs, dans le volet Importer les détails de la tâche, choisissez Accéder au fichier de résultats.

    Note

    Si plus de 50 % des événements (lignes) de votre jeu de données n'ont pas été validés, la tâche d'importation échoue également. Dans ce cas, vous devez corriger les données avant de commencer une nouvelle tâche d'importation.

  • Résumé du jeu de données

    Fournit un résumé du rapport de validation de votre jeu de données. Si la colonne Nombre d'avertissements affiche plus de 0 avertissements, décidez si vous devez corriger ces avertissements. Si la colonne Nombre d'avertissements affiche 0, continuez à entraîner votre modèle.

Importation par lots de données d'événements à l'aide du SDK AWS pour Python (Boto3)

L'exemple suivant montre un exemple de demande d'CreateBatchImportJobAPI. Une tâche d'importation par lots doit inclure un JobID, un InputPath, un OutputPath, un événement et un iam. TypeName RoleArn Le JobID ne peut pas contenir le même ID qu'une tâche précédente, sauf si la tâche existe dans l'état CREATE_FAILED. Les champs InputPath et OutputPath doivent être des chemins S3 valides. Vous pouvez choisir de ne pas spécifier le nom du fichier dans OutputPath, mais vous devrez tout de même fournir un emplacement de compartiment S3 valide. L'événement TypeName et l'objectif RoleArn doivent exister. Le rôle IAM doit accorder des autorisations de lecture pour entrer dans le compartiment Amazon S3 et des autorisations d'écriture pour sortir le compartiment 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-*************' )

Annuler la tâche d'importation par lots

Vous pouvez annuler une tâche d'importation par lots en cours à tout moment dans la console Amazon Fraud Detector, à l'aide de l'CancelBatchImportJobAPI ou du SDK AWS.

Pour annuler une tâche d'importation par lots dans la console,
  1. Ouvrez la console AWS, connectez-vous à votre compte, puis accédez à Amazon Fraud Detector.

  2. Dans le volet de navigation de gauche, sélectionnez Événements.

  3. Choisissez votre type d'événement.

  4. Sélectionnez l'onglet Événements enregistrés.

  5. Dans le volet Importer les données des événements, choisissez l'identifiant de la tâche d'importation en cours que vous souhaitez annuler.

  6. Sur la page des tâches relatives à l'événement, cliquez sur Actions et sélectionnez Annuler l'importation des événements.

  7. Choisissez Arrêter l'importation des événements pour annuler la tâche d'importation par lots.

Annulation d'une tâche d'importation par lots à l'aide du kit de développement logiciel AWS pour Python (Boto3)

L'exemple suivant montre un exemple de demande pour l'CancelBatchImportJobAPI. La tâche d'importation annulée doit inclure l'ID de tâche d'une tâche d'importation par lots en cours.

import boto3 fraudDetector = boto3.client('frauddetector') fraudDetector.cancel_batch_import_job ( jobId = 'sample_batch' )