ターゲット感情の非同期分析

ターゲット感情のリアルタイム分析の詳細については、「ターゲット感情のリアルタイム分析」を参照してください。

Amazon Comprehend には、非同期のターゲット感情分析を開始および管理するための次の API オペレーションがあります。

• StartTargetedSentimentDetectionJob – ドキュメントのコレクションに対して、非同期ターゲット感情検出ジョブを開始します。

• ListTargetedSentimentDetectionJobs – 送信したターゲット感情検出ジョブのリストを返します。

• DescribeTargetedSentimentDetectionJob – 指定されたターゲット感情検出ジョブに関連付けられたプロパティ (ステータスを含む) を取得します。

• StopTargetedSentimentDetectionJob – 指定された進行中のターゲット感情ジョブを停止します。

開始する前に

このチュートリアルを開始する前に、以下の要件を満たしていることを確認してください。

• 入出力バケット — 入出力に使用する Amazon S3 バケットを指定します。バケットは、呼び出す API と同じリージョンに存在している必要があります。

• IAM サービスロール — 入出力バケットにアクセス許可を持つ IAM サービスロールが必要です。詳細については、「バッチ操作に必要なロールベースのアクセス許可」を参照してください。

AWS CLI を使用したターゲット感情の分析

以下は、AWS CLI での StartTargetedSentimentDetectionJob オペレーションの使用例です。この例では、入力テキストの言語を指定します。

例は、Unix、Linux、および macOS 用にフォーマットされています。Windows の場合は、各行末のバックスラッシュ (\) Unix 連結文字をキャレット (^) に置き換えてください。

aws comprehend start-targeted-sentiment-detection-job \
       --job-name "job name" \
       --language-code "en" \
       --cli-input-json file://path to JSON input file

次の例に示すように、cli-input-json パラメータには、リクエストデータを含む JSON ファイルへのパスを指定します。

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

ジョブの開始リクエストが成功すると、以下のようなレスポンスが返されます。

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