トランスフォーメーション > 機械学習トランスフォーメーション > 一括要求の設定
  

一括要求の設定

機械学習トランスフォーメーションが機械学習モデルに送信する1つの要求に複数の要求をまとめることで、最適なパフォーマンスが得られるように一括要求を設定します。一括要求は、オーバーヘッドの処理とモデルとの通信にかかる時間を削減することで、パフォーマンスを向上させることができます。
一括要求を作成するために、機械学習トランスフォーメーションは要求スキーマの最上位の配列フィールドを選択します。一括要求のJSON要求本文で、トランスフォーメーションは、選択した配列フィールドの要素として要求行を結合し、1つのJSON要求本文に複数の要求のデータが含まれるようにします。一括要求オプションを設定して、各一括要求に含まれるデータの量を指定できます。
例えば、要求スキーマの構造は次のようになります。
要求スキーマには、instancesという名前の構造体が含まれています。構造体instancesには、featuresという名前の別のネストされた配列を含むdataというネストされた配列が含まれています。
機械学習トランスフォーメーションは、要求を結合するための最上位の配列フィールドとしてdata配列を選択します。2 MBのデータを機械学習モデルに送信するように各一括要求を設定した場合、機械学習トランスフォーメーションにより、2 MBの要求行のデータを含むようにJSON要求本文のdata配列が設定されます。
最上位の配列に兄弟配列フィールドを含めることはできません。最上位配列にプリミティブデータ型の兄弟フィールドがある場合、兄弟フィールドのデータは結合されません。その代わり、兄弟フィールドのランダムなレコードが機械学習モデルに送信されます。
一括応答を作成するために、機械学習エンドポイントは応答行を応答スキーマの最上位配列の要素としてまとめる必要があります。機械学習トランスフォーメーションは配列を解析し、出力行に結果が表示されます。機械学習トランスフォーメーションが解析するフィールドを確かめるために、一括要求オプションを確認します。
機械学習トランスフォーメーションで一括要求を使用するには、一括要求を受け入れて一括応答を送信するように機械学習エンドポイントを設定する必要があります。

一括要求オプション

一括要求オプションにより、機械学習トランスフォーメーションが要求の結合と応答の解析に使用するフィールドを決定します。また、それぞれの一括要求に含まれるデータの量も決定します。
次の表に、一括要求のオプションを示します。
オプション
説明
フィールドの要求をまとめる
トランスフォーメーションは要求行をこの配列フィールドの要素としてまとめて、1つの要求を機械学習モデルに送信します。このフィールドは要求スキーマによって自動的に決定されます。
要求サイズ
各要求の最大サイズ。サイズを選択するには、機械学習プラットフォームのベストプラクティスを確認してください。
フィールドの要求を解析する
機械学習エンドポイントは応答行をこの配列フィールドの要素としてまとめます。次に、トランスフォーメーションが配列を解析し、出力行に結果が表示されます。このフィールドは応答スキーマによって自動的に決定されます。