ForHosting KIT · データ変換・整形

2つのCSVをキーで結合し未一致行を確認

一方の表を主データ、もう一方を関連項目の追加データとして、共通キーで2つのCSVファイルを結合できます。2つのCSVテキストを貼り付け、共通の見出し名を指定するだけで、データベースや一時スクリプトを用意せずに再現可能な左外部結合結果を取得できます。左右それぞれの未一致レコードも別々に返されるため、欠落の確認が容易です。引用符付きの値、重複キー、見出し名の衝突、一般的な改行形式にも決定的な処理で対応します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

信頼できる共通キーを持つ2つのCSVをご用意ください

最初に、customer_id、order_number、sku、emailなど、両方のファイルで同じ対象を表す列を特定してください。指定するキーと見出し名は、大文字と小文字、空白も含めて完全に一致する必要があります。ほかの見出し名は異なっていても構いません。左側のCSVが主テーブルとなり、右側に一致するレコードがなくても、その全レコードが結合結果に残ります。右側のCSVは、キーが一致したときに追加列を提供します。可能であれば安定した識別子をご利用ください。名前や説明は変更されたり、空白が不統一だったり、重複したりするため、システム識別子のほうが通常は安全です。パーサーは引用符付きフィールド、エスケープされた二重引用符、引用符内のコンマ、埋め込み改行、CRLFファイル、先頭のUTF-8バイトオーダーマークに対応します。コンマ以外を使う場合は、両ファイルで共通する1文字の区切り文字をご指定ください。空または重複した列名は、結果オブジェクトが曖昧になるため受け付けません。どちらかのCSVにキー見出しがない場合も、誤解を招く結果を返さず、明確な入力エラーを返します。

左外部結合と重複キーの動作をご確認ください

左側CSVの各レコードについて、右側CSVからキー文字列が完全に同じレコードを検索します。1件一致すれば、1件の結合レコードを生成します。一致がなくても結合行は生成され、左側の元の項目を保持したまま、右側から追加される項目を空文字列にします。右側に同じキーのレコードが複数ある場合は、一致した件数分だけ左側レコードを展開します。この1対多の動作は、1人の顧客に複数の契約を結び付けたり、1商品に複数倉庫の在庫を結び付けたりする際に便利ですが、出力行数が増える点にご注意ください。左側の重複キーは別々に処理され、元の順序を保ちます。行と一致候補も入力順を維持するため、結果は常に再現可能です。共通キーは結合オブジェクトに1回だけ現れます。キー以外の右側見出しが左側と衝突する場合は、値を上書きしないようright_接頭辞を付けます。必要ならさらに接頭辞を追加して一意にします。columns配列で、joined_rowsをご利用になる前に最終的な列順と名称をご確認いただけます。

未一致レポートでデータを安全に照合できます

unmatched_left配列には、右側に同じキーがなかった左側の元レコードが入ります。左外部結合のため、これらもjoined_rowsには残りますが、別配列を使えば修正、補完、確認の対象として簡単に振り分けられます。unmatched_right配列には、どの左側行からも使われなかった右側の元レコードが入ります。結合表には現れませんが、古い参照データ、想定外の新しい識別子、対象期間が異なるファイルなどを発見する手掛かりになります。件数情報には、両入力の行数、展開後の結合行数、左右の未一致件数が含まれるため、自動品質検査も容易です。たとえばunmatched_leftがゼロより大きい場合にインポートを中止したり、unmatched_rightが基準値を超えた場合に通知したりできます。照合は完全一致であり、空白の除去、大文字小文字の統一、数値の再解釈は行いません。そのため、001、1、末尾に空白がある1は別の値です。この慎重な仕様により、意図しない関連付けを防ぎます。業務ルール上で同一視できる場合のみ、事前にキーを正規化してください。APIでは1リクエスト$0.002で、定期インポートにも単発調査にも組み込めます。

活用例

顧客エクスポートの情報を補完

参照CSVからプラン、地域、担当者を追加しながら、主データの全顧客を保持できます。

注文と支払いを照合

注文番号で取引を結合し、未払い注文や不明な注文に紐付いた支払いを確認できます。

商品カタログの網羅性を監査

SKUマスターと仕入先データを結合し、詳細がない商品や未使用の仕入先行を検出できます。

よくある質問

キー列がない場合はどうなりますか？

入力エラーとなり、左側と右側のどちらのCSVにキーがないかが示されます。

左側の行はすべて保持されますか？

はい。常に左外部結合を行い、未一致行では右側から追加する項目を空文字列にします。

重複キーはどのように処理されますか？

左側の各レコードを一致する右側の全レコードと結合するため、複数行になる場合があります。

両ファイルに同名の列がある場合はどうなりますか？

左側の列名を維持し、右側にはright_接頭辞を付けます。必要に応じて接頭辞を追加します。

照合前にキーを整形しますか？

いいえ。空白、大文字小文字、先頭のゼロを保持して完全一致で比較します。必要なら事前に正規化してください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/data/merge-csv-on-key

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/data/merge-csv-on-key \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"left_csv":"id,name\n1,Ada\n2,Linus\n3,Grace","right_csv":"id,team\n1,Research\n2,Platform\n4,Support","key":"id"}'

const res = await fetch("https://api.kit.forhosting.com/data/merge-csv-on-key", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "left_csv": "id,name\n1,Ada\n2,Linus\n3,Grace",
    "right_csv": "id,team\n1,Research\n2,Platform\n4,Support",
    "key": "id"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/merge-csv-on-key",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "left_csv": "id,name\n1,Ada\n2,Linus\n3,Grace",
    "right_csv": "id,team\n1,Research\n2,Platform\n4,Support",
    "key": "id"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/merge-csv-on-key", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"left_csv":"id,name\\n1,Ada\\n2,Linus\\n3,Grace","right_csv":"id,team\\n1,Research\\n2,Platform\\n4,Support","key":"id"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"left_csv":"id,name\n1,Ada\n2,Linus\n3,Grace","right_csv":"id,team\n1,Research\n2,Platform\n4,Support","key":"id"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/merge-csv-on-key", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "left_csv": "id,name\n1,Ada\n2,Linus\n3,Grace",
  "right_csv": "id,team\n1,Research\n2,Platform\n4,Support",
  "key": "id"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.merge_csv_on_key",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

max_mb 25

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →