View a markdown version of this page

Analisi asincrona per il rilevamento degli eventi - Amazon Comprehend
Prima di iniziareRileva gli eventi utilizzando AWS CLIElenca gli eventi utilizzando il AWS CLIDescrivi gli eventi usando il AWS CLIOttieni i risultati del rilevamento degli eventi

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à.

Analisi asincrona per il rilevamento degli eventi

Per rilevare gli eventi in un set di documenti, utilizzare StartEventsDetectionJob to start un job asincrono.

Prima di iniziare

Prima di iniziare, assicurati di avere:

  • Bucket di input e output: identifica i bucket Amazon S3 da utilizzare per l'input e l'output. I bucket devono trovarsi nella stessa regione dell'API che stai chiamando.

  • Ruolo del servizio IAM: è necessario disporre di un ruolo di servizio IAM con autorizzazione per accedere ai bucket di input e output. Per ulteriori informazioni, consulta Role-based autorizzazioni necessarie per le operazioni asincrone.

Rileva gli eventi utilizzando AWS CLI

L'esempio seguente dimostra l'utilizzo dell'StartEventsDetectionJoboperazione con AWS CLI

L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\) al termine di ogni riga con un accento circonflesso (^).

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

Per il cli-input-json parametro si fornisce il percorso di un file JSON che contiene i dati della richiesta, come mostrato nell'esempio seguente.

{
  "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",
  "TargetEventTypes": [
      "BANKRUPTCY",
      "EMPLOYMENT",
      "CORPORATE_ACQUISITION",
      "INVESTMENT_GENERAL",
      "CORPORATE_MERGER",
      "IPO",
      "RIGHTS_ISSUE",
      "SECONDARY_OFFERING",
      "SHELF_OFFERING",
      "TENDER_OFFERING",
      "STOCK_SPLIT"
  ]
}

Se la richiesta di avvio del processo di rilevamento degli eventi è andata a buon fine, riceverai la seguente risposta:

{
  "JobStatus": "SUBMITTED",
  "JobId": "job ID"
}

Elenca gli eventi utilizzando il AWS CLI

Usa l'ListEventsDetectionJobsoperazione per visualizzare un elenco dei lavori di rilevamento degli eventi che hai inviato. L'elenco include informazioni sulle posizioni di input e output utilizzate e sullo stato di ciascuno dei processi di rilevamento. L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\) al termine di ogni riga con un accento circonflesso (^).

aws comprehend list-events-detection-jobs --region region

In risposta otterrai un JSON simile al seguente:

{
 "EventsDetectionJobPropertiesList": [
    {
       "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role",
       "EndTime": timestamp,
       "InputDataConfig": {
          "InputFormat": "ONE_DOC_PER_LINE",
          "S3Uri": "s3://input bucket/input path"
       },
       "JobId": "job ID",
       "JobName": "job name",
       "JobStatus": "COMPLETED",
       "LanguageCode": "en",
       "Message": "message",
       "OutputDataConfig": {
          "S3Uri": "s3://output bucket/ouput path"
       },
       "SubmitTime": timestamp,
       "TargetEventTypes": [
         "BANKRUPTCY",
         "EMPLOYMENT",
         "CORPORATE_ACQUISITION",
         "INVESTMENT_GENERAL",
         "CORPORATE_MERGER",
         "IPO",
         "RIGHTS_ISSUE",
         "SECONDARY_OFFERING",
         "SHELF_OFFERING",
         "TENDER_OFFERING",
         "STOCK_SPLIT"
  ]
    }
 ],
 "NextToken": "next token"
}

Descrivi gli eventi usando il AWS CLI

È possibile utilizzare l'DescribeEventsDetectionJoboperazione per ottenere lo stato di un lavoro esistente. L'esempio è formattato per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\) al termine di ogni riga con un accento circonflesso (^).

aws comprehend describe-events-detection-job \
  --region region \
  --job-id job ID

Riceverai il seguente JSON in risposta:

{
 "EventsDetectionJobProperties": {
    "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role",
    "EndTime": timestamp,
    "InputDataConfig": {
       "InputFormat": "ONE_DOC_PER_LINE",
       "S3Uri": "S3Uri": "s3://input bucket/input path"
    },
    "JobId": "job ID",
    "JobName": "job name",
    "JobStatus": "job status",
    "LanguageCode": "en",
    "Message": "message",
    "OutputDataConfig": {
       "S3Uri": "s3://output bucket/output path"
    },
    "SubmitTime": timestamp,
    "TargetEventTypes": [
      "BANKRUPTCY",
      "EMPLOYMENT",
      "CORPORATE_ACQUISITION",
      "INVESTMENT_GENERAL",
      "CORPORATE_MERGER",
      "IPO",
      "RIGHTS_ISSUE",
      "SECONDARY_OFFERING",
      "SHELF_OFFERING",
      "TENDER_OFFERING",
      "STOCK_SPLIT"
  ]
 }
}

Ottieni i risultati del rilevamento degli eventi

Di seguito è riportato un esempio di file di output di un processo di analisi che ha rilevato eventi nei documenti. Il formato di input è un documento per riga. 

{"Entities": [{"Mentions": [{"BeginOffset": 12, "EndOffset": 27, "GroupScore": 1.0, "Score": 0.916355, "Text": "over a year ago", "Type": "DATE"}]}, {"Mentions": [{"BeginOffset": 33, "EndOffset": 39, "GroupScore": 1.0, "Score": 0.996603, "Text": "Amazon", "Type": "ORGANIZATION"}]}, {"Mentions": [{"BeginOffset": 66, "EndOffset": 77, "GroupScore": 1.0, "Score": 0.999283, "Text": "Whole Foods", "Type": "ORGANIZATION"}]}], "Events": [{"Arguments": [{"EntityIndex": 2, "Role": "INVESTEE", "Score": 0.999283}, {"EntityIndex": 0, "Role": "DATE", "Score": 0.916355}, {"EntityIndex": 1, "Role": "INVESTOR", "Score": 0.996603}], "Triggers": [{"BeginOffset": 373, "EndOffset": 380, "GroupScore": 0.999984, "Score": 0.999955, "Text": "acquire", "Type": "CORPORATE_ACQUISITION"}], "Type": "CORPORATE_ACQUISITION"}, {"Arguments": [{"EntityIndex": 2, "Role": "PARTICIPANT", "Score": 0.999283}], "Triggers": [{"BeginOffset": 115, "EndOffset": 123, "GroupScore": 1.0, "Score": 0.999967, "Text": "combined", "Type": "CORPORATE_MERGER"}], "Type": "CORPORATE_MERGER"}], "File": "doc.txt", "Line": 0}

Per ulteriori informazioni sulla struttura del file di output degli eventi e sui tipi di eventi supportati, vedereEventi.