# 出力形式

> 出力形式 - DataRobotが列指向のテーブル形式で返す予測について出力形式を確認します。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-27T18:44:30.262650+00:00` (UTC).

## Primary page

- [出力形式](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [連続値モデル](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#regression-models): In-page section heading.
- [二値分類モデル](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#binary-classification-models): In-page section heading.
- [多クラス分類モデル](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#multiclass-classification-models): In-page section heading.
- [時系列モデル](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#time-series-models): In-page section heading.
- [予測ステータス](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#prediction-status): In-page section heading.
- [予測警告](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#prediction-warnings): In-page section heading.
- [デプロイ承認ステータス](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#deployment-approval-status): In-page section heading.
- [予測の説明](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#prediction-explanations): In-page section heading.
- [予測説明の例](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#prediction-explanation-examples): In-page section heading.
- [パススルー列](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#passthrough-columns): In-page section heading.
- [関連付けID](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#association-id): In-page section heading.
- [出力フィルター](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#output-filters): In-page section heading.
- [列名再マッピング](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#column-name-remapping): In-page section heading.

## Documentation content

予測は列テーブル形式で返されます。 各サンプル値の後には、その値が属するデータ型が続きます。 返される列は、次に示すモデルタイプによって決定されます。 The output schema shares the same format for real-time and batch predictions.

> [!NOTE] 備考
> DataRobotでは、文字列の一意のバージョン（たとえば、 `TEXT` と呼ばれる場合もあれば、 `VARCHAR` と呼ばれる場合もある）を持つさまざまなデータベースに予測を出力できます。
> そのため、DataRobotは実装固有のデータ型を提供できません。

## 連続値モデル

| 列名 | <target_name>_PREDICTION |
| データ型 | 数値 |
| サンプル名 | revenue_PREDICTION |
| サンプル値 | 493822.12 |
| 説明 | 予測値 |

## 二値分類モデル

| Positiveラベル |
| --- |
| 列名 |
| データ型 |
| サンプル名 |
| サンプル値 |
| 説明 |

| Negativeラベル |
| --- |
| 列名 |
| データ型 |
| サンプル名 |
| サンプル値 |
| 説明 |

| 列名 | <target_name>_PREDICTION |
| データ型 | テキスト |
| サンプル名 | isbadbuy_PREDICTION |
| サンプル値 | 0 |
| 説明 | 分類の予測ラベル |

| 列名 | THRESHOLD |
| データ型 | 数値 |
| サンプル名 | THRESHOLD |
| サンプル値 | 0.5 |
| 説明 | ラベルを決定するために使用する浮動予測しきい値 |

| Positiveクラスラベル |
| --- |
| 列名 |
| データ型 |
| サンプル名 |
| サンプル値 |
| 説明 |

## 多クラス分類モデル

| 列名 | <target_name>_PREDICTION |
| データ型 | テキスト |
| サンプル名 | species_PREDICTION |
| サンプル値 | lion |
| 説明 | 分類の予測ラベル |

| 列名 | <target_name>_<class_label>_PREDICTION |
| データ型 | 数値 |
| 説明 | 各クラスの浮動小数点での確率 |

| undefined | undefined |
| --- | --- |
| species_cat_PREDICTION | 0.28 |
| species_lion_PREDICTION | 0.24 |
| species_lynx_PREDICTION | 0.48 |

## 時系列モデル

> [!NOTE] 備考
> これらの出力列は、時系列連続値、分類、異常検知モデルで使用できます。

| 時系列モデルの列 | 説明 | データ型 |
| --- | --- | --- |
| <SERIES_ID_COLUMN_NAME> | 行が属する系列IDが含まれます。これはパススルー列として機能し、変更されていない列名とスコアリングデータで提供された値を返します。 | テキスト |
| FORECAST_POINT | 予測ポイントのタイムスタンプが含まれます。過去の時系列予測をリクエストしない限り、出力値は予測ポイントが同じで予測距離が異なるすべての行で同じになります。 | 日付 |
| <TIME_COLUMN_NAME> | 時系列のタイムスタンプが含まれます。これはパススルー列として機能するべきであり、変更されていない列名とスコアリングデータで提供された値を返します。 （これは、時系列モデルによって返されるoriginalFormatTimestampフィールドと同じ値を返します。） | 日付 |
| FORECAST_DISTANCE | 時系列モデルによって返される予測距離の数値が含まれます。 | 数値 |

## 予測ステータス

| 列名 | prediction_status |
| データ型 | テキスト |
| 説明 | 予測が成功しなかった理由を説明する、`OK`または文字列エラーメッセージを含む行ごとのステータス |
| サンプル値 | 日付フィールドをYYYY-MM-DDの日付形式に変換できませんでした |
| サンプル値 | OK |

## 予測警告

ジョブで予測警告が有効になっている場合、追加の列が返されます。

| 列名 | IS_OUTLIER_PREDICTION |
| データ型 | テキスト |
| 説明 | 予測が計算済み予測境界の外側にあるかどうか |

| 列 | サンプル値 |
| --- | --- |
| データ型 | テキスト |
| IS_OUTLIER_PREDICTION | True |
| IS_OUTLIER_PREDICTION | False |

## デプロイ承認ステータス

デプロイの承認ワークフローが有効の場合、出力スキーマにはデプロイ承認ステータスを表示する追加列が含まれます。

| 列名 | DEPLOYMENT_APPROVAL_STATUS |
| データ型 | テキスト |
| 説明 | デプロイが承認されたかどうか |
| サンプル値 | PENDING |

## 予測の説明

`maxExplanations` ジョブパラメーターをゼロ以外の値に設定すると、予測とともに返される予測の説明をリクエストできます。 説明を計算するしきい値も設定できます。 しきい値を設定しないと、DataRobotは各行の説明を計算します。

| ジョブパラメーター | 説明 | サンプル値 | データ型 |
| --- | --- | --- | --- |
| maxExplanations | （オプション）この番号までの説明の計算。 | 10 | 整数 |
| thresholdHigh | （オプション）説明をこのしきい値を超える予測に限定する。 | 0.5 | 浮動小数 |
| thresholdLow | 0.15 | 浮動小数 |  |

予測の説明が必要な場合、各説明で4つの追加列が「EXPLANATION_ _IDENTIFIER」の形式で返されます（nは、1から始まり、リクエストされた説明の最大数までの特徴量の説明インデックスです）。 戻り列は、以下のとおりです。

| 列 | 説明 | データ型 |
| --- | --- | --- |
| EXPLANATION__FEATURE_NAME | この説明で扱う特徴量名。 | テキスト |
| EXPLANATION__STRENGTH | 浮動小数点数で表した特徴量の強さ。 | 数値 |
| EXPLANATION__QUALITATIVE_STRENGTH | 文字列で表した特徴量の強さ。+++から---までのプラスまたはマイナスの指標。 | テキスト |
| EXPLANATION__ACTUAL_VALUE | この説明に関連付けられた特徴量。 | テキスト |

### 予測説明の例

| 名前 | 値 |
| --- | --- |
| EXPLANATION_1_FEATURE_NAME | loan_status |
| EXPLANATION_1_ACTUAL_VALUE | 原価償却済み |
| EXPLANATION_1_STRENGTH | 1.380291221709652 |
| EXPLANATION_1_QUALITATIVE_STRENGTH | +++ |

| 名前 | 値 |
| --- | --- |
| EXPLANATION_1_FEATURE_NAME | loan_status |
| EXPLANATION_1_ACTUAL_VALUE | 原価償却済み |
| EXPLANATION_1_STRENGTH | -1.2145340858375335 |
| EXPLANATION_1_QUALITATIVE_STRENGTH | --- |

## パススルー列

リクエストしたパススルー列がそのまま渡されます。 上記の名前のいずれかと競合する場合、ジョブは拒否されます。

## 関連付けID

デプロイが [精度の関連付けID](https://docs.datarobot.com/ja/docs/classic-ui/mlops/deployment-settings/accuracy-settings.html.md) とともに設定された場合は、すべての結果セットにはソースデータから自動的に通過する列があります。

## 出力フィルター

以下のジョブ設定プロパティーを使用して、特定のクラス確率のみを表示するか、何も表示しないかを制御します。

| ジョブパラメーター | 説明 | サンプル値 | データ型 |
| --- | --- | --- | --- |
| includeProbabilities | （オプション）すべてのクラスの確率を含み、デフォルトはtrueです。 | true | ブーリアン |
| includeProbabilitiesClasses | （オプション）指定アレイにリスト表示された確率のみを含み、デフォルトは空アレイ[]です。 | ['setosa', 'versicolor'] | ブーリアン |
| includePredictionStatus | （オプション）出力のprediction_status列を含み、デフォルトはfalseです。 | true | ブーリアン |

> [!NOTE] 備考
> 二値分類の場合、 `includeProbabilities` は `THRESHOLD` と `>POSITIVE_CLASS` 列も制御します。

## 列名再マッピング

ユースケースにDataRobot出力と一致しない厳格な出力スキーマがある場合は、名前を変えて、 `columnNamesRemapping` ジョブ設定プロパティを使用して出力から任意の列を削除できます。

| ジョブパラメーター | 説明 | サンプル値 |
| --- | --- | --- |
| columnNamesRemapping | （オプション）このジョブからの出力をリマップ（列の名前変更または削除）するアイテムのリストを指定します。列を無視するには、その列のoutputNameをNullまたはFalseに設定します。 | [{'inputName': 'isbadbuy_1_PREDICTION', 'outputName':'prediction'}, {'inputName': 'isbadbuy_0_PREDICTION', 'outputName': null}] |