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.

Localisation d'entités PII avec des tâches asynchrones (API)

Exécutez un traitement par lots asynchrone pour localiser les informations personnelles dans une collection de documents. Pour exécuter le travail, chargez vos documents sur Amazon S3 et envoyez une StartPiiEntitiesDetectionJob demande.

Avant de commencer

Avant de commencer, assurez-vous que vous disposez des éléments suivants :

Paramètres d’entrée

Dans votre demande, incluez les paramètres obligatoires suivants :

Méthodes de travail asynchrones

StartPiiEntitiesDetectionJobRenvoie un identifiant de tâche, afin que vous puissiez suivre la progression de la tâche et récupérer l'état de la tâche lorsqu'elle est terminée.

Pour suivre la progression d'une tâche d'analyse, indiquez l'ID de la tâche à l'DescribePiiEntitiesDetectionJobopération. Le formulaire de réponse DescribePiiEntitiesDetectionJob contient le JobStatus champ indiquant l'état actuel de la tâche. Une transition professionnelle réussie passe par les états suivants :

SOUMIS -> EN COURS -> TERMINÉ.

Une fois qu'une tâche d'analyse JobStatus est terminée (terminée, échouée ou arrêtée), utilisez DescribePiiEntitiesDetectionJob pour obtenir l'emplacement des résultats. Si le statut de la tâche est définiCOMPLETED, la réponse inclut un OutputDataConfig champ contenant un champ indiquant l'emplacement Amazon S3 du fichier de sortie.

Pour plus d'informations sur les étapes à suivre pour l'analyse asynchrone Amazon Comprehend, consultez. Traitement par lots asynchrone

Format du fichier de sortie

Le fichier de sortie utilise le nom du fichier d'entrée, avec .out ajouté à la fin. Il contient les résultats de l'analyse.

Voici un exemple de fichier de sortie issu d'une tâche d'analyse qui a détecté des entités PII dans des documents. Le format de saisie est d'un document par ligne.

{
  "Entities": [
    {
      "Type": "NAME",
      "BeginOffset": 40,
      "EndOffset": 69,
      "Score": 0.999995
    },
    {
      "Type": "ADDRESS",
      "BeginOffset": 247,
      "EndOffset": 253,
      "Score": 0.998828
    },
    {
      "Type": "BANK_ACCOUNT_NUMBER",
      "BeginOffset": 406,
      "EndOffset": 411,
      "Score": 0.693283
    }
  ],
  "File": "doc.txt",
  "Line": 0
},
{
  "Entities": [
    {
      "Type": "SSN",
      "BeginOffset": 1114,
      "EndOffset": 1124,
      "Score": 0.999999
    },
    {
      "Type": "EMAIL",
      "BeginOffset": 3742,
      "EndOffset": 3775,
      "Score": 0.999993
    },
    {
      "Type": "PIN",
      "BeginOffset": 4098,
      "EndOffset": 4102,
      "Score": 0.999995
    }
  ],
  "File": "doc.txt",
  "Line": 1
 }

Voici un exemple de sortie d'une analyse dont le format d'entrée est un document par fichier.

{
  "Entities": [
    {
      "Type": "NAME",
      "BeginOffset": 40,
      "EndOffset": 69,
      "Score": 0.999995
    },
    {
      "Type": "ADDRESS",
      "BeginOffset": 247,
      "EndOffset": 253,
      "Score": 0.998828
    },
    {
      "Type": "BANK_ROUTING",
      "BeginOffset": 279,
      "EndOffset": 289,
      "Score": 0.999999
    }
  ],
  "File": "doc.txt"
}   

Analyse asynchrone à l'aide du AWS Command Line Interface

L'exemple suivant utilise l'StartPiiEntitiesDetectionJobopération avec le AWS CLI.

L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\), à la fin de chaque ligne par un accent circonflexe (^).

aws comprehend start-pii-entities-detection-job \
    --region region \
    --job-name job name \
    --cli-input-json file://path to JSON input file

Pour le cli-input-json paramètre, vous indiquez le chemin d'accès à un fichier JSON contenant les données de la demande, comme illustré dans l'exemple suivant.

{
  "InputDataConfig": {
      "S3Uri": "s3://input bucket/input path",
      "InputFormat": "ONE_DOC_PER_LINE"
  },
  "OutputDataConfig": {
      "S3Uri": "s3://output bucket/output path"
  },
  "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
  "LanguageCode": "en",
  "Mode": "ONLY_OFFSETS"     
}   

Si la demande de démarrage de la tâche de détection des événements a abouti, vous recevrez une réponse similaire à la suivante :

{
  "JobId": "5d2fbe6e...e2c"
  "JobArn":  "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/5d2fbe6e...e2c" 
  "JobStatus": "SUBMITTED",   
}   

Vous pouvez utiliser cette DescribeEventsDetectionJob opération pour obtenir le statut d'une tâche existante. Si la demande de démarrage de la tâche de détection des événements a abouti, vous recevrez une réponse similaire à la suivante :

aws comprehend describe-pii-entities-detection-job \
    --region region \
    --job-id job ID

Lorsque la tâche est terminée avec succès, vous recevez une réponse similaire à la suivante :

{
    "PiiEntitiesDetectionJobProperties": {
  "JobId": "5d2fbe6e...e2c"
  "JobArn":  "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/5d2fbe6e...e2c" 
  "JobName": "piiCLItest3",
  "JobStatus": "COMPLETED",
  "SubmitTime": "2022-05-05T14:54:06.169000-07:00",
  "EndTime": "2022-05-05T15:00:17.007000-07:00",
  "InputDataConfig": {
       (identical to the input data that you provided with the request)
    }
}