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 d'événements à l'aide de l'importation par

Grâce à la fonctionnalité 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, téléchargez le fichier CSV dans le 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 dans son intégralité. 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éparation des 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 est réussie, le fichier de sortie est vide. Si l'importation a échoué, le fichier de sortie contient les journaux d'erreurs.

Création d'un fichier CSV

Amazon Fraud Detector importe des 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 correspondant 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 éventuellement inclure EVENT_LABEL et LABEL_TIMESTAMP (LABEL_TIMESTAMP est requis si EVENT_LABEL est inclus).

Définir 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.

Importer un fichier CSV sur Amazon S3 pour une 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).

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 continuer, assurez-vous d'avoir suivi les instructions pour préparer votre ensemble 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

Surveiller la progression du travail de validation et d'importation de l'ensemble de données

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 le statut des tâches de validation et d'importation sur la page d'importation des 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 ensemble de données.

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

Rapport de validation des données intelligentes

La validation intelligente des données crée un rapport de validation une fois la validation terminée. Le rapport de validation fournit des détails sur tous les problèmes que le SDV a identifiés dans votre ensemble de données, avec 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 le jeu 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.

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 :

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 ensemble de données s'ils sont détectés, 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.

Importation par lots de données d'événements à l'aide du kit 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 et. eventTypeNameiamRoleArn Le JobID ne peut pas contenir le même identifiant qu'une tâche précédente, sauf si la tâche existe dans l'état CREATE_FAILED. Les chemins 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. La eventTypeName terre iamRoleArn doit exister. Le rôle IAM doit accorder des autorisations de lecture pour entrer le compartiment Amazon S3 et des autorisations d'écriture pour le sortir du 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.

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

L'exemple suivant montre un exemple de demande pour l'CancelBatchImportJobAPI. La tâche d'annulation d'importation 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'
)