複数ドキュメントの同期処理

処理したいドキュメントが複数ある場合は、Batch*一度に複数のドキュメントを Amazon Comprehend に送信するオペレーションです。リクエストごとに最大 25 件のドキュメントを送信できます。Amazon Comprehend は、リクエスト内のドキュメントごとに 1 つずつ、レスポンスのリストを返します。

次の操作を使用して、1 つのリクエストで複数のドキュメントを処理できます。これらのオペレーションで行われたリクエストは同期しています。アプリケーションは、オペレーションを呼び出し、サービスからの応答を待ちます。

• BatchDetectDominantLanguage

• BatchDetectEntities

• BatchDetectKeyPhrases

• BatchDetectSentiment

• BatchDetectSyntax

の使用Batch*オペレーションは、リクエスト内の各ドキュメントに対して単一のドキュメント API を呼び出すことと同じです。これらの API を使用すると、アプリケーションのパフォーマンスが向上します。

各 API への入力は、処理するドキュメントを含む JSON 構造です。を除くすべての操作の場合BatchDetectDominantLanguageでは、入力言語を設定する必要があります。各リクエストに設定できる入力言語は 1 つのみです。例えば、次は、BatchDetectEntitiesオペレーション. 2つの文書が含まれており、英語です。

{
   "LanguageCode": "en",
   "TextList": [
      "I have been living in Seattle for almost 4 years",
      "It is raining today in Seattle"
   ]
}

からのレスポンスは次のとおりです。Batch*オペレーションには 2 つのリストが含まれています。ResultListとErrorList。-ResultList正常に処理されたドキュメントごとに 1 つのレコードが含まれます。リクエスト内の各ドキュメントの結果は、ドキュメントに対して 1 回のドキュメント操作を実行した場合に得られる結果と同じです。各ドキュメントの結果には、入力ファイル内のドキュメントの順序に基づいてインデックスが割り当てられます。からのレスポンスは次のとおりです。BatchDetectEntities操作は次のとおりです。

{
   "ResultList"  : [
      {
         "Index": 0,
         "Entities": [
            {
               "Text": "Seattle", 
               "Score": 0.95, 
               "Type": "LOCATION", 
               "BeginOffset": 22, 
               "EndOffset": 29
            },
            {
               "Text": "almost 4 years", 
               "Score": 0.89, 
               "Type": "QUANTITY", 
               "BeginOffset": 34, 
               "EndOffset": 48
            }
         ]
      },
      {
         "Index": 1,
         "Entities": [
            {
              "Text": "today",
              "Score": 0.87,
              "Type": "DATE",
              "BeginOffset": 14,
              "EndOffset": 19
            },
            {
               "Text": "Seattle",
               "Score": 0.96,
               "Type": "LOCATION",
               "BeginOffset": 23,
               "EndOffset": 30
            }
         ]
      }
   ],
   "ErrorList": []
}

リクエストでエラーが発生すると、レスポンスにはErrorListこれは、エラーを含むドキュメントを識別します。ドキュメントは、入力リスト内のインデックスで識別されます。たとえば、次の入力はBatchDetectLanguageオペレーションには、処理できないドキュメントが含まれています。

{
   "TextList": [
     "hello friend", 
     "$$$$$$",
     "hola amigo"
   ]       
}

Amazon Comprehend からの応答には、エラーを含むドキュメントを識別するエラーリストが含まれています。

{
    "ResultList": [
        {
          "Index": 0,
          "Languages":[
            {
              "LanguageCode":"en",
              "Score": 0.99
            }
          ]
        },
        {
          "Index": 2
          "Languages":[
            {
              "LanguageCode":"es",
              "Score": 0.82
            }
          ]
        }
    ],
    "ErrorList": [
      {
        "Index": 1,
        "ErrorCode": "InternalServerException",
        "ErrorMessage": "Unexpected Server Error. Please try again."
      }
    ]
}