ADminiのデータ結合でつまずいたときの対処ガイド｜JOIN 0件・型変換リスク・部分カバレッジ警告の読み方
複数の広告媒体のデータを1つの表にまとめようとして、結合のプレビュー画面で止まった。赤いバナーが出て保存ボタンが押せない、あるいは警告は出ているが放置していいのか判断がつかない。データ結合を初めて使うときによく起きる状況です。結論から言うと、ADminiの結合画面が出す警告はどれも「保存する前に気づけるように」設計されたもので、内容を読み分ければ原因はほぼその場で特定できます。逆に、警告の意味を知らないまま無視して進めると、集計結果が静かに間違ったまま毎朝更新され続けることになります。以下では、横結合と縦結合それぞれで出る警告の意味と、対処の順序を整理します。
横結合が0件になるとき、何が起きているのか
赤バナーが出たら、まず結合キーの型を疑う
横結合（JOIN）のプレビューで一致行が0件になると、プレビュー領域に赤いバナーが表示され、保存ボタンが無効になります。これは仕様であって不具合ではありません。一致0件の結合を保存しても、出力される表は空になるだけだからです。
0件になる原因のうち、実務で最も多いのは結合キーの型の不一致です。片方の日付列が日付型で、もう片方が文字列として取り込まれている。あるいは片方のIDが数値型で、もう片方は先頭に0が付いた文字列になっている。見た目には同じ値が並んでいるのに、内部の型が違うと一致は成立しません。ADminiの結合画面では結合キーごとに型変換を指定でき、VARCHAR・INTEGER・DATEの3種類から選べます。日付をキーにする場合はDATE、IDや管理番号のように桁揃えのゼロが意味を持つ列はVARCHARに揃えるのが基本です。
型を揃えても0件のままなら、次に疑うのは値そのものの粒度です。片方が日別、もう片方が週別で集計されていれば、日付をキーにしても当然一致しません。「結合できない」の多くは、結合の設定ではなく、結合しようとしている2つの表の作りが揃っていないという問題です。結合機能そのものの基本的な使い方はADminiのデータ結合機能の使い方にまとめています。
一致件数以外の2つの数字を見る
プレビューが返すのは一致行数だけではありません。左側にしか存在しない行数と、右側にしか存在しない行数も同時に表示されます。この3つを並べると、結合が意図どおりかどうかが一目で判断できます。
| 状態 | 読み取れること | 対処 |
|---|---|---|
| 一致0件 | キーの型か粒度が揃っていない | 型変換を指定するか、集計単位を揃える |
| 一致はあるが左のみが大量 | 右側のデータ期間が不足している | 右側の取得開始日を確認する |
| 一致はあるが右のみが大量 | 左側に存在しないキーが右にある | JOIN種別をLEFTからFULLへ見直す |
| 3つともバランスが取れている | 意図どおりに結合できている | 保存して問題ない |
一致件数がゼロでなければ保存はできてしまうので、ここは自分で確認する必要があります。100行と5行が一致している状態でも保存は通ります。RIGHT結合やFULL結合を使う場合、右側にしか存在しない行でも結合キーの列は補完されて表示されるため、キー列が空欄になって混乱することはありません。
縦結合の3つの警告の読み方
部分カバレッジは「その列が一部のデータソースにしかない」合図
部分カバレッジの警告は、ある出力列が一部のデータソースにしかマッピングされていない状態を指します。縦結合（UNION ALL）は2つ以上のデータソースを縦に積み上げる機能で、媒体ごとに取得したデータを1つの表にまとめるときに使います。プレビュー時に返る警告は3種類あり、それぞれ意味が違います。
- 部分カバレッジ：ある出力列が一部のデータソースにしかマッピングされていない状態。該当しない媒体の行はその列が空になります
- 型変換リスク：積み上げようとしている列の型が揃っておらず、変換が必要な状態
- ソースカラムの重複マッピング：同じ元カラムを複数の出力列に割り当てている状態
部分カバレッジは、必ずしも間違いではありません。Meta広告にしかない指標をGoogle広告と縦に積めば、当然Google側の行は空になります。問題は、その空欄を「値がゼロ」として集計してしまう場合です。平均を取ると分母が変わり、実際より良い数値が出ます。空欄を許容するのか、その列を出力から外すのかを、警告を見た時点で決めてください。
型変換リスクと重複マッピングは、集計後に効いてくる
型変換リスクの警告は、たとえば片方の媒体でコストが数値、もう片方が「1,200」のようなカンマ入り文字列で入っているときに出ます。変換自体は行われますが、変換できなかった値がどう扱われるかは元データ次第です。この警告が出たら、縦結合を直す前に、元のデータソース側で列の型を確認するほうが確実です。データ品質の確認手順はADminiのデータ品質確認ガイドで扱っています。
重複マッピングは、自動マッピングやAIスマート配置を使った直後に出やすい警告です。列名が似ている場合、意味的な類似度で候補が提示される仕組みなので、1つの元カラムが2か所に配置されることがあります。自動マッピングは提案であって、確定ではありません。マトリクス上で対応関係を目視し、意図しない配置だけ手で直すという使い方が前提になります。なお、出力されるカラム名は40文字を上限に正規化され、名前が衝突する場合はサフィックスが付いて一意化されます。長い媒体名を含む列名を使っていると、想定と違う名前で出てくることがあるのはこのためです。
ADminiのデータ結合なら、複数媒体のデータを全媒体合算ビューとして1つの表にまとめられます。ADminiなら無料で始められます。無料で試してみる →
自動更新後に結合が壊れたときの挙動
0行になった結合は更新失敗として扱われ、前日のデータが残る
結合は一度作れば終わりではなく、毎朝の自動更新で再生成されます。ここで問題になるのが、元データの側が変わったときです。片方の媒体で配信が止まって行が消えた、列名が変わった、といった変化が起きると、結合結果が0行になることがあります。
この場合、ADminiは0行の結果で上書きしません。旧データを保持したまま、該当の結合データソースを更新失敗として扱います。ダッシュボードが突然空になる事故は防げますが、代わりに「数字は出ているのに中身が前日のまま」という状態が起こり得ます。更新状況の表示を確認する習慣がないと、これは気づきにくい部類の異常です。
壊れる前に気づくには、結合前のデータソース側を見る
結合が壊れる原因は、ほぼ例外なく結合の手前にあります。したがって監視すべきは結合後の表ではなく、元になっているデータソースの行数と更新状況です。媒体ごとの取得が正常に終わっているか、行数が前日から大きく変わっていないか。この2点を毎朝の確認項目に入れておけば、結合が壊れる前に手前で気づけます。
ADmini（アドミニ）は、Google広告・LINEヤフー広告・Meta広告・GA4のデータを毎朝自動で取得し、結合まで含めて1つの分析環境として保つBIツールです。とはいえ、自動更新が拾えるのは取得と再生成の成否までで、「取れているが値がおかしい」類の異常は人が見るしかありません。媒体横断で分析環境を組む全体像は広告データの媒体横断分析の記事に、初期設定からの流れはADminiの始め方と基本的な使い方にまとめています。
まとめ
データ結合は、料理でいえば下ごしらえに当たります。素材の切り方が揃っていない状態で火を入れても、味は整いません。結合のプレビューで出る警告は、火を入れる前に「この素材、大きさが揃っていませんよ」と教えてくれるものだと考えると、扱い方が見えてきます。保存ボタンが押せないのは邪魔をされているのではなく、空の表を作る手前で止められているということです。
まず今週やることを1つ挙げるなら、すでに作ってある結合データソースを開いて、プレビューの一致件数と左右のみの行数を確認してください。作ったときは正しくても、データが増えた今も同じとは限りません。3つの数字のバランスが崩れていたら、そこが直近の集計のずれの原因です。ADminiのAI日次レポートを使えば、結合後の全媒体合算データをもとにしたレポートを毎朝受け取れます。ADminiなら無料で始められます。無料で試してみる →
よくある質問
ADminiの横結合で一致行が0件になり、保存ボタンが押せません
一致0件の結合は空の表しか生まないため、意図的に保存を無効化しています。原因で最も多いのは結合キーの型の不一致です。ADminiでは結合キーごとにVARCHAR・INTEGER・DATEの型変換を指定できるので、日付はDATE、先頭のゼロが意味を持つIDはVARCHARに揃えてください。型を揃えても0件なら、日別と週別のように集計の粒度が違っている可能性が高いです。
縦結合の「部分カバレッジ」警告は無視しても問題ありませんか？
意図した状態であれば問題ありませんが、集計方法によっては結果がずれます。部分カバレッジは、ある出力列が一部のデータソースにしかマッピングされていない状態を指し、該当しない媒体の行はその列が空になります。空欄をゼロとして平均を取ると分母が変わり、実際より良い数値が出ます。空欄を許容するのか、その列を出力から外すのかを警告を見た時点で決めてください。
自動マッピングやAIスマート配置の結果は、そのまま使っていいですか？
提案として扱い、必ず目視で確認してください。列名の意味的な類似度で候補が提示される仕組みのため、1つの元カラムが複数の出力列に割り当てられ、重複マッピングの警告が出ることがあります。マッピングマトリクス上で対応関係を確認し、意図しない配置だけ手で直す使い方が前提です。出力カラム名は40文字上限で正規化され、衝突時はサフィックスが付きます。
自動更新のあとに結合結果が0行になった場合はどうなりますか？
0行の結果では上書きされず、旧データを保持したまま該当の結合データソースが更新失敗として扱われます。ダッシュボードが突然空になることは防げますが、「数字は出ているが中身が前日のまま」という状態が起こり得ます。結合が壊れる原因はほぼ結合の手前にあるため、元データソースの行数と更新状況を毎朝の確認項目に入れておくと、手前で気づけます。