🧯
デプロイできないときの対応(整合性エラー)
レシピに整合性の問題があると、デプロイができません。
この記事では、「レシピに整合性エラーがあります(デプロイできません)」と表示されたときの確認方法と、エラーごとの対処方法を説明します。
前提
Step 1 エラーの内容を確認する

- レシピ詳細の「データ処理」タブをクリック
- タブの上部に表示されているメッセージを確認
エラーがある場合は「レシピに整合性エラーがあります(デプロイできません)」と表示され、その下に検出された問題が一覧で並びます。
一覧の各行は「セクション名 — メッセージ」の形式で、セクション名には「ソース」「変換」「ターゲット」「実行パラメータ」のいずれかが入ります。
変換のマッピングに関する問題は「マッピング #2: 〜」、実行パラメータに関する問題は「パラメータ名: 〜」のように、対象がメッセージの先頭に付きます。何番目のマッピング・どのパラメータが原因かは、この部分で判断できます。

「デプロイ」をクリックできるのは、次の3つをすべて満たしているときです。
・レシピの編集権限がある
・未デプロイの変更がある
・整合性エラーが1件もない
整合性エラーが1件でもある間は、「デプロイ」はクリックできません。
この判定は保存済みの内容に対して行われます。編集中の内容は反映されないため、修正したら「保存」をクリックしてから表示を確認してください。
エラーと確認事項の違い

検出された問題は、重大度によって「エラー」と「確認事項」に分かれます。
| エラー | 確認事項(警告) |
|---|---|
| 見出しは「レシピに整合性エラーがあります(デプロイできません)」 赤色で表示されます | 見出しは「レシピに確認事項があります」 黄色で表示されます |
| 1件でもあるとデプロイできません | デプロイできます |
| そのままでは実行できない状態です。必ず修正してください | 意図した設定であればそのままで問題ありません |
エラーと確認事項が同時に検出された場合は、見出しは「レシピに整合性エラーがあります(デプロイできません)」になり、一覧には両方が並びます。
問題のあるセクションは、「ソース」「変換」「ターゲット」「実行パラメータ」のタブ名の右に警告アイコンが表示されます。
エラー別の対処
表示されるメッセージごとの原因と対処は以下の通りです。
ソース
| メッセージ | 原因 | 対処 |
|---|---|---|
| ソースのスキーマ(列定義)が未設定です | ソーススキーマに列が1件も定義されていません インポートのレシピで検出されます | ソースタブの「ソーススキーマ」で列を追加します。「サンプルを取得」で自動推定もできます |
| ソース列のキーが重複しています | ソーススキーマの中に、同じキーの列が複数あります | ソースタブの「ソーススキーマ」で、重複しているキーを一意になるよう修正します |
| ソースの HTTP パスが未入力です | ソースの種類が「HTTP API」で、リクエストのパスが空欄です | ソースタブの「リクエスト」でパスを入力します 例) |
変換
| メッセージ | 原因 | 対処 |
|---|---|---|
| 変換のマッピングが未設定です | マッピングが1件も定義されていません | 変換タブでマッピングを追加します |
| 存在しないソース列を参照しているマッピングがあります | マッピングの入力に指定した列が、ソーススキーマに存在しません ソーススキーマの列を削除・改名した後に起こります | メッセージ先頭の「マッピング #N」で対象を特定し、入力列を選び直します または、ソーススキーマ側に該当の列を追加します |
ターゲット
| メッセージ | 原因 | 対処 |
|---|---|---|
| ターゲットのヘッダーマッピングが未設定です | ターゲットの種類が「CSV ファイル」で、出力する列(ヘッダー)が1件も定義されていません | ターゲットタブでヘッダーマッピングを追加します |
| ターゲットの HTTP エンドポイントが未入力です | ターゲットの種類が「HTTP API」で、エンドポイントのパスが空欄です | ターゲットタブでエンドポイントのパスを入力します |
| ターゲットが要求する列が変換で生成されていません | ターゲットが出力対象に指定している列キーが、変換の出力に含まれていません エクスポートのレシピで検出されます | 変換タブで該当の列キーを出力するマッピングを追加します または、ターゲット側の参照を変換の出力に合わせて修正します |
実行パラメータ
| メッセージ | 原因 | 対処 |
|---|---|---|
| 宣言されていない実行パラメータが使用されています | パス・クエリパラメータ・リクエストボディ・ファイル名などで を使っているのに、そのパラメータが実行パラメータタブで宣言されていません 名前の打ち間違いや、宣言の削除で起こります | メッセージ先頭のパラメータ名を確認し、実行パラメータタブで同じ名前のパラメータを宣言します または、参照側の名前を宣言済みのものに修正します |
「デプロイ」はクリックできるのに失敗する場合

接続設定・インポート設定・業務アセットは、レシピの外側で削除されることがあります。これらが実際に存在するかどうかの確認は、上部のアラートには含まれず、デプロイを実行したタイミングで行われます。
そのため「デプロイ」はクリックできますが、実行すると「デプロイに失敗しました」と表示されます。
デプロイを実行すると、ダイアログに「デプロイに失敗しました: デプロイできません。次の問題を解決してください: 接続設定が見つかりません: (対象のID)」のように、見つからない参照先が表示されます。
| デプロイ失敗時に表示されるメッセージ | 原因 | 対処 |
|---|---|---|
| 接続設定が見つかりません: (対象のID) | 参照していた接続設定が削除されています | ソースまたはターゲットの「編集」から、接続設定を選び直します |
| インポート設定が見つかりません: (対象のID) | 参照していたインポート設定が削除されています | ターゲットの「編集」から、インポート設定を選び直します |
| アセットが見つかりません: (対象のID) | 参照していた業務アセットが削除されています | ソースの「編集」から、業務アセットを選び直します |
| ソーススキーマに列が定義されていません | エクスポートのレシピで、ソースが1列も出力しない状態になっています | ソースタブで、出力する列が定義されているかを確認します |
| ソース側スキーマを解決できません: 〜 | ソース側のスキーマを組み立てられません。「: 」に続く部分に詳細が表示されます | 表示された内容を確認し、ソースタブの設定を見直します |
| ターゲット側スキーマを解決できません: 〜 | ターゲット側のスキーマを組み立てられません。「: 」に続く部分に詳細が表示されます | 表示された内容を確認し、ターゲットタブの設定を見直します |
編集中に参照先が削除されていた場合
レシピを編集している間に参照先が削除されていた場合は、「保存」をクリックした時点で次のメッセージが表示され、保存できません。
- 「接続設定が削除されているため保存できません。接続を再設定してください。」
- 「業務アセットが削除されているため保存できません。業務アセットを再設定してください。」
この場合は、ソースまたはターゲットの「編集」から参照先を選び直してから、保存してください。
ターゲットが必須としている項目をソース側が出力していない場合も、デプロイを実行したタイミングで検出されます。この場合は上部のアラートに表示されないため、ソーススキーマと変換のマッピングで、必須項目が漏れていないかを確認してください。(ソーススキーマを設定する)
デプロイ後に接続先の仕様が変わった場合や、レスポンスのルートパスが誤っている場合など、デプロイ時には検出されず実行時に失敗するものもあります。デプロイは成功したのに実行が失敗する場合は、実行履歴から原因を確認してください。(実行時のエラー対応)