# バッチ予測ジョブのトラブルシューティング

> バッチ予測ジョブのトラブルシューティング - バッチ予測ジョブで発生する一般的な問題と、それらを解決する方法のリストです。

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

## Primary page

- [バッチ予測ジョブのトラブルシューティング](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [ジョブがINITIALIZINGでスタック](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#a-job-is-stuck-in-initializing): In-page section heading.
- [ジョブがRUNNINGでスタック](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#a-job-is-stuck-in-running): In-page section heading.
- [ジョブがABORTEDの状態である](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#a-job-was-aborted): In-page section heading.
- [ローカルファイル入力にCSVファイルをアップロードする際にHTTP 406が返された](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#http-406-was-returned-when-uploading-a-csv-file-for-local-file-intake): In-page section heading.
- [ローカルファイル入力にCSVファイルをアップロードする際にHTTP 422が返された](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#http-422-was-returned-when-uploading-a-csv-file-for-local-file-intake): In-page section heading.
- [Oracle JDBスコアリングデータでの日付形式の不一致によるIntakeストリームエラー](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#intake-stream-error-due-to-date-format-mismatch-in-oracle-jdbc-scoring-data): In-page section heading.
- [ローカルファイル入力でデータセットをアップロードするときにネットワーク接続の問題が生じた。](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#the-network-connection-broke-while-uploading-a-dataset-for-local-file-intake): In-page section heading.
- [ローカルファイル出力でスコアリングデータをダウンロード中にネットワーク接続が使用できなくなった。](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#the-network-connection-became-unavailable-while-downloading-the-scoring-data-for-local-file-output): In-page section heading.
- [スコアリングデータをダウンロードしようとしているときにHTTP 404が返された。](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#http-404-was-returned-while-trying-to-download-scored-data): In-page section heading.
- [スコアリングデータをダウンロードしようとしているときにHTTP 406が返された。](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#http-406-was-returned-when-trying-to-download-scored-data): In-page section heading.
- [サポートされていない出力列名の形式が原因でCREATE_TABLEのスコアリングに失敗する](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#create_table-scoring-fails-due-to-unsupported-output-column-name-formats): In-page section heading.
- [ジョブ作成時のHTTP 422で考えられる理由](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/batch-pred-tshoot.html.md#possible-causes-for-http-422-on-job-creation): In-page section heading.

## Documentation content

一般的な問題およびその解決方法を以下に示します。

## ジョブがINITIALIZINGでスタック

ローカルファイル入力を使用する場合は、ジョブのスコアリングデータで `PUT` リクエストを最初の `POST` リクエストの後にしていることを確認します。

DataRobotでは、予測インスタンスあたり一度に1つのジョブしか処理されないので、現在のジョブが他のジョブの後にキューに配置されることがあります。 詳細については、以下のジョブログを確認します。

```
curl -X GET https://app.datarobot.com/api/v2/batchPredictions/:id/ \
    -H 'Authorization: Bearer <YOUR_KEY>' 
```

## ジョブがRUNNINGでスタック

ジョブは低速で実行される場合があります、これは、低速モデルまたはスコアリングデータにAPIが特定しようとしているエラーが含まれるといういずれかの理由によるものです。 ジョブの進捗はジョブステータスをリクエストすることでフォローできます。

```
curl -X GET https://app.datarobot.com/api/v2/batchPredictions/:id/ \
    -H 'Authorization: Bearer <YOUR_KEY>' 
```

## ジョブがABORTEDの状態である

ジョブが中断されると、DataRobotは理由をジョブステータスに記録します。 ジョブステータスは、個々のジョブURLから確認できます。

```
curl -X GET https://app.datarobot.com/api/v2/batchPredictions/:id/ \
    -H 'Authorization: Bearer <YOUR_KEY>' 
```

または、すべてのジョブのリストビューから確認できます。

```
curl -X GET https://app.datarobot.com/api/v2/batchPredictions/ \
    -H 'Authorization: Bearer <YOUR_KEY>' 
```

## ローカルファイル入力にCSVファイルをアップロードする際にHTTP 406が返された

`Content-Type: text/csv` ヘッダーがありません。

## ローカルファイル入力にCSVファイルをアップロードする際にHTTP 422が返された

次のいずれかの原因が考えられます。

- このジョブにCSVデータが既にプッシュされている。 新しいデータを送信するには、新しいジョブを作成する。
- データをプッシュする必要のないジョブ（S3入力など）にCSVデータをプッシュしようとした。
- CSVデータをUTF-8文字セットでエンコードせず、 csvSettings でカスタムエンコーディングを指定しなかった。
- 適切なCSV形式でCSVデータをエンコードせず、 csvSettings でカスタム形式を指定しなかった。
- 空のファイルをプッシュしようとした。

上記のいずれの場合も、応答およびジョブログには説明が含まれます。

## Oracle JDBスコアリングデータでの日付形式の不一致によるIntakeストリームエラー

Oracleの日付タイプには、スコア時系列データスコアリングの問題が発生する可能性がある時コンポーネントが含まれています。

日付形式 `yyyy-mm-dd` を使用してトレーニングされたモデルでは、Oracleの日付形式によって、Oracle JDBスコアリングデータがエラーになる可能性があります。

DataRobotがOracleから日付を読み取ると、デフォルトでは形式 `yyyy-mm-dd hh:mm:ss` で日付が返されます。 これは形式が異なることを想定してモデルに渡されるとエラーが発生する可能性があります。

この問題を回避するために、次の回避策のいずれかを使用します。

- Oracleからのスコアリング時の形式が同じになるように、データソースとしてOracleを使用してモデルをトレーニングします。
- SQL関数の使用を許可するため、 table と schema の代わりに query オプションを使用します。 Oracleの TO_CHAR 関数は、データがスコアリングされる前に時刻列を解析するために使用できます。

## ローカルファイル入力でデータセットをアップロードするときにネットワーク接続の問題が生じた。

新しいジョブを作成して、データセットを再度アップロードします。 失敗したアップロードは再開されず、最終的にタイムアウトします。

## ローカルファイル出力でスコアリングデータをダウンロード中にネットワーク接続が使用できなくなった。

ジョブを再度ダウンロードします。 スコアリングされたデータは、マネージドAIプラットフォーム（SaaS）で48時間、セルフマネージドAIプラットフォーム（VPCまたはオンプレミス）で48時間（ただし変更可能）利用できます。

## スコアリングデータをダウンロードしようとしているときにHTTP 404が返された。

次のいずれかの原因が考えられます。

- スコアリングされたデータをダウンロードできないジョブ（S3出力など）でスコアリングデータをダウンロードしようとした。
- ジョブでスコアリングが開始する前にダウンロードを開始した。 その場合、ジョブリンクで download リンクが有効になるまで待ってから再試行してください。

## スコアリングデータをダウンロードしようとしているときにHTTP 406が返された。

クライアントから `Accept` ヘッダーが送信されたが、ヘッダーに `text/csv` が含まれていなかった。 `Accept` ヘッダーを送信しない、またはヘッダーに `text/csv` を含めないのいずれか。

## サポートされていない出力列名の形式が原因でCREATE_TABLEのスコアリングに失敗する

DataRobotで生成される [出力形式](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md) の列名をサポートしない出力アダプターとしてターゲットデータベースが使用されている可能性があります。 時系列モデルをスコアリングするときの `name (actual)_PREDICTION` などの列名は、すべてのデータベースでサポートされているとは限りません。

この問題を回避するには、 [列名の再マッピング](https://docs.datarobot.com/ja/docs/api/reference/batch-prediction-api/output-format.html.md#column-name-remapping) 機能を利用して、出力列名をターゲットデータベースがサポートする形式に書き換えます。

たとえば、列名からスペースを削除する場合は、次のように `columnNamesRemapping` を追加して追加のリクエストを行うことができます。

```
{
   "deploymentId":"<id>",
   "passthroughColumnsSet":"all",
   "includePredictionStatus":true,
   "intakeSettings":{
      "type":"localFile"
   },
   "outputSettings":{
      "type":"jdbc",
      "dataStoreId":"<id>",
      "credentialId":"<id>",
      "table":"table_name_of_database",
      "schema":"dbo",
      "catalog":"test",
      "statementType":"create_table"
   },
   "columnNamesRemapping":{
      "name (actual)_PREDICTION":"name_actual_PREDICTION"
   }
} 
```

## ジョブ作成時のHTTP 422で考えられる理由

以下は、新規バッチ予測ジョブ作成時の `HTTP 422` 返答に対して考えられる理由です。

- 不明なジョブパラメーターを送信した
- 予期しないタイプまたは値のジョブパラメーターを指定した
- 入力または出力設定で、不明な資格情報IDを指定した
- 同じS3/Azure/GCP URL間でスコアリンングしようとしている（サポートされていません）
- AIカタログ からデータを取り込もうとしてるが、アカウントには AIカタログ へのアクセス権がない
- AIカタログ からデータを取り込もうとしてるが、 AIカタログ データセットがスナップショット（予測に必要）されていない、または正常に取り込まれていない
- 時系列カスタムモデルを使用しようとしている（現在、サポートされていません）
- 従来の時系列（ARIMA）モデルを使用しようとしている（現在、サポートされていません）
- 多クラスまたは時系列プロジェクトで予測の説明をリクエストした（現在、サポートされていません）
- 連続値プロジェクト以外のプロジェクトで予測警告をリクエストした（現在は、サポートされていません）
- 予測境界が適切に設定されていないプロジェクトで予測警告をリクエストした
