# バッチ予測ジョブの定義

> バッチ予測ジョブの定義 - 作業中のバッチ予測ジョブを送信する方法。予測のタイプに応じて、POSTリクエストペイロードにさまざまな要素を指定する必要があります。

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.261997+00:00` (UTC).

## Primary page

- [バッチ予測ジョブの定義](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/job-definitions.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [ジョブ定義API](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/job-definitions.html.md#job-definitions-api): In-page section heading.
- [ジョブ定義を実行する](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/job-definitions.html.md#execute-a-job-definition): In-page section heading.

## Documentation content

作業中のバッチ予測ジョブを送信するには、必要な予測のタイプに基づいて `POST` リクエストペイロードにさまざまな要素を入力する必要があります。 さらに、特定のジョブに使用される入力および出力アダプターのタイプを考慮する必要があります。

バッチ予測REST APIルートの詳細については、 [DataRobot REST API](https://docs.datarobot.com/ja/docs/api/reference/public-api/batch_predictions.html.md) リファレンスドキュメントをご覧ください。

バッチ予測を行うたびに、予測情報はDataRobotの外部に保存され、予測リクエストごとに再送信されます。詳しくは、 [サンプルユースケースのセクション](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/pred-examples.html.md) を参照してください。 そのようなリクエストの1つとして、次のようなものがあります。

`POST https://app.datarobot.com/api/v2/batchPredictions`

```
{
    "deploymentId": "<deployment_id>",
    "intakeSettings": {
        "type": "dataset",
        "datasetId": "<dataset_ud>"
    },
    "outputSettings": {
        "type": "jdbc",
        "statementType": "insert",
        "credentialId": "<credential_id>",
        "dataStoreId": "<data_store_id>",
        "schema": "public",
        "table": "example_table",
        "createTableIfNotExists": false
    },
    "includeProbabilities": true,
    "includePredictionStatus": true,
    "passthroughColumnsSet": "all"
} 
```

## ジョブ定義API

ユースケースで同じ、またはほぼ同じタイプの予測を複数回実行する必要がある場合、バッチ予測ジョブの ジョブ定義 を作成し、将来的な使用に向けてそれをDataRobot内に保存しておくことができます。

ジョブ定義のAPIは既存の `/batchPredictions/` エンドポイントと同じであり、 `POST` エンドポイントを `/batchPredictionJobDefinitions` に変更することで互換的に使用できます。

`POST https://app.datarobot.com/api/v2/batchPredictionJobDefinitions`

```
{
    "deploymentId": "<deployment_id>",
    "intakeSettings": {
        "type": "dataset",
        "datasetId": "<dataset_ud>"
    },
    "outputSettings": {
        "type": "jdbc",
        "statementType": "insert",
        "credentialId": "<credential_id>",
        "dataStoreId": "<data_store_id>",
        "schema": "public",
        "table": "example_table",
        "createTableIfNotExists": false
    },
    "includeProbabilities": true,
    "includePredictionStatus": true,
    "passthroughColumnsSet": "all"
} 
```

この定義エンドポイントは、DataRobotに定義が正常に保存されたことを確認する、受け入れられたペイロードを返します。

（オプション） `name` パラメーターを入力して識別を容易にすることができます。 入力しなければ、DataRobotが代わりに作成します。

> [!WARNING] 注意
> `name` パラメーターは組織全体で一意である必要があります。 同じ名前で複数の定義を作成しようとすると、リクエストは失敗します。 名前を解放する場合、削除する既存のジョブ定義IDを持つ `DELETE` リクエストを最初に送信する必要があります。

## ジョブ定義を実行する

スコアリングのために保存されたジョブ定義を送信する場合、 [こちら](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/job-scheduling.html.md) に示すようにスケジュールに基づいて送信するか、次のようにして、ペイロードとしての定義IDを持つエンドポイント `/batchPredictions/fromJobDefinition` へ定義IDを手動で送信することができます。

`POST https://app.datarobot.com/api/v2/batchPredictions/fromJobDefinition`

```
{
    "jobDefinitionId": "<job_definition_id>"
} 
```

エンドポイントは通常のCRUD操作、 `GET` 、 `POST` 、 `DELETE` および `PATCH` をサポートします。