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.

Des prédictions par lots

Vous pouvez utiliser une tâche de prédiction par lots dans Amazon Fraud Detector pour obtenir des prédictions pour un ensemble d'événements ne nécessitant pas de notation en temps réel. Par exemple, vous pouvez créer une tâche de prévision par lots pour effectuer une tâche hors ligne proof-of-concept ou pour évaluer rétrospectivement le risque d'événements sur une base horaire, quotidienne ou hebdomadaire.

Vous pouvez créer une tâche de prédiction par lots à l'aide de la console Amazon Fraud Detector ou en appelant l'opération d'CreateBatchPredictionJobAPI à l'aide de l'interface de ligne de AWS commande (AWS CLI) ou de l'un des Amazon Fraud Detector SDKs.

Comment fonctionnent les prédictions par lots

Le fonctionnement de l'CreateBatchPredictionJobAPI utilise une version de détecteur spécifiée pour effectuer des prédictions sur la base des données fournies dans un fichier CSV d'entrée situé dans un compartiment Amazon S3. L'API renvoie ensuite le fichier CSV obtenu dans un compartiment S3.

Les tâches de prédiction par lots calculent les scores du modèle et les résultats des prédictions de la même manière que l'GetEventPredictionopération. De mêmeGetEventPrediction, pour créer une tâche de prédiction par lots, vous devez d'abord créer un type d'événement, éventuellement entraîner un modèle, puis créer une version de détecteur qui évalue les événements de votre tâche par lots.

La tarification des scores de risque événementiel évalués par les tâches de prédiction par lots est la même que celle des scores créés par l'GetEventPredictionAPI. Pour en savoir plus, consultez les tarifs d'Amazon Fraud Detector.

Vous ne pouvez exécuter qu'une seule tâche de prédiction par lots à la fois.

Fichiers d'entrée et de sortie

Le fichier CSV d'entrée doit contenir des en-têtes correspondant au type d'événement associé à la version de détecteur sélectionnée. La taille maximale du fichier de données d'entrée est de 1 Go. Le nombre d'événements varie en fonction de la taille de votre événement.

Amazon Fraud Detector crée le fichier de sortie dans le même compartiment que le fichier d'entrée, sauf si vous spécifiez un emplacement distinct pour les données de sortie. Le fichier de sortie contient les données d'origine du fichier d'entrée et les colonnes ajoutées suivantes :

Obtenir des prédictions par lots

Les étapes suivantes supposent que vous avez déjà créé un type d'événement, entraîné un modèle à l'aide de ce type d'événement (facultatif) et créé une version du détecteur pour ce type d'événement.

Pour arrêter une tâche de prédiction par lots en cours, accédez à la page détaillée de la tâche de prédiction par lots, choisissez Actions, puis sélectionnez Arrêter la prédiction par lots. Si vous arrêtez une tâche de prédiction par lots, vous ne recevrez aucun résultat pour cette tâche.

Lorsque le statut de la tâche de prédiction par lots passe àComplete, vous pouvez récupérer le résultat de la tâche dans le compartiment de sortie Amazon S3 désigné. Le nom du fichier de sortie est au formatbatch prediction job name_file creation timestamp_output.csv. Par exemple, le fichier de sortie d'une tâche nommée mybatchjob estmybatchjob_ 1611170650_output.csv.

Pour rechercher des événements spécifiques évalués par une tâche de prédiction par lots, dans le volet de navigation gauche de la console Amazon Fraud Detector, choisissez Search past predictions.

Pour supprimer une tâche de prédiction par lots terminée, accédez à la page détaillée de la tâche de prédiction par lots, sélectionnez Actions, puis sélectionnez Supprimer la prédiction par lots.

Conseils sur les rôles IAM

Pour obtenir des prédictions par lots, le rôle IAM qui appelle l'CreateBatchPredictionJobopération doit disposer d'autorisations de lecture sur votre compartiment S3 d'entrée et d'autorisations d'écriture sur votre compartiment S3 de sortie. Pour plus d'informations sur les autorisations de compartiment, consultez les exemples de politiques utilisateur dans le guide de l'utilisateur Amazon S3. Sur la console Amazon Fraud Detector, trois options s'offrent à vous pour sélectionner un rôle IAM pour Batch Predictions :

Si vous recevez une erreur liée à votre rôle IAM, vérifiez les points suivants :

Obtenez des prévisions de fraude par lots à l'aide du AWS SDK pour Python (Boto3)

L'exemple suivant montre un exemple de demande pour l'CreateBatchPredictionJobAPI. Une tâche de prédiction par lots doit inclure les ressources existantes suivantes : détecteur, version du détecteur et nom du type d'événement. L'exemple suivant suppose que vous avez créé un type d'événementsample_registration, un détecteur sample_detector et une version du détecteur1.

import boto3
fraudDetector = boto3.client('frauddetector')

fraudDetector.create_batch_prediction_job (
   jobId = 'sample_batch',
   inputPath = 's3://bucket_name/input_file_name.csv',
   outputPath = 's3://bucket_name/',
   eventTypeName = 'sample_registration',
   detectorName = 'sample_detector',
   detectorVersion = '1',
   iamRoleArn = 'arn:aws:iam::**:role/service-role/AmazonFraudDetector-DataAccessRole-**'
)