こんにちは、廣本です📄。
今回はJSONファイルをSquadbaseに取り込む検証をおこないました。
JSONとは
JSON（JavaScript Object Notation）は、人間にとっての読みやすさと、プログラムでの扱いやすさを兼ね備えたデータ形式です。その利便性から、APIのレスポンスや設定ファイルなどで広く利用されています。
例としては以下のイメージです。
[
{
"id": 1,
"name": "Alice",
"age": 28,
"dept": "Sales",
"tags": ["new", "remote"],
"created_at": "2026-06-20"
},
{
"id": 2,
"name": "Bob",
"age": 35,
"dept": "Engineering",
"tags": ["mentor"],
"created_at": "2026-06-21"
}
]
今回はこのJSONファイルをSquadbaseに取り込む検証を実施しました。
検証内容
サンプルとして作成した、下記のJSONファイルをSquadbaseに取り込み、データとして扱えるか確認したいと思います。
{
"kpi": {
"monthlyRevenue": 4820000,
"orderCount": 234,
"averageOrderValue": 20598,
"newCustomers": 47
},
"monthlySales": [
{ "month": "2025-07", "label": "7月", "sales": 3540000, "yoyChange": -2.5 },
{ "month": "2025-08", "label": "8月", "sales": 3780000, "yoyChange": 4.6 },
{ "month": "2025-09", "label": "9月", "sales": 4100000, "yoyChange": 6.3 },
{ "month": "2025-10", "label": "10月", "sales": 4490000, "yoyChange": 7.2 },
{ "month": "2025-11", "label": "11月", "sales": 5230000, "yoyChange": 15.1 },
{ "month": "2025-12", "label": "12月", "sales": 5980000, "yoyChange": 18.3 },
{ "month": "2026-01", "label": "1月", "sales": 3200000, "yoyChange": 5.2 },
{ "month": "2026-02", "label": "2月", "sales": 2980000, "yoyChange": -1.3 },
{ "month": "2026-03", "label": "3月", "sales": 4150000, "yoyChange": 8.7 },
{ "month": "2026-04", "label": "4月", "sales": 3870000, "yoyChange": 3.1 },
{ "month": "2026-05", "label": "5月", "sales": 4620000, "yoyChange": 12.4 },
{ "month": "2026-06", "label": "6月", "sales": 4820000, "yoyChange": 9.8 }
],
"categorySales": [
{ "category": "電子機器", "sales": 1850000, "ratio": 38.4 },
{ "category": "アパレル", "sales": 1120000, "ratio": 23.2 },
{ "category": "食品・飲料", "sales": 870000, "ratio": 18.1 },
{ "category": "家具・インテリア", "sales": 650000, "ratio": 13.5 },
{ "category": "その他", "sales": 330000, "ratio": 6.8 }
],
"recentOrders": [
{ "orderId": "ORD-0234", "customerCode": "C-081", "category": "電子機器", "amount": 58000, "orderDate": "2026-06-22", "status": "完了" },
{ "orderId": "ORD-0233", "customerCode": "C-047", "category": "アパレル", "amount": 12800, "orderDate": "2026-06-21", "status": "完了" },
{ "orderId": "ORD-0232", "customerCode": "C-115", "category": "食品・飲料", "amount": 6500, "orderDate": "2026-06-21", "status": "処理中" },
{ "orderId": "ORD-0231", "customerCode": "C-033", "category": "家具・インテリア", "amount": 94000, "orderDate": "2026-06-20", "status": "完了" },
{ "orderId": "ORD-0230", "customerCode": "C-092", "category": "電子機器", "amount": 32000, "orderDate": "2026-06-20", "status": "処理中" },
{ "orderId": "ORD-0229", "customerCode": "C-058", "category": "その他", "amount": 4200, "orderDate": "2026-06-19", "status": "完了" },
{ "orderId": "ORD-0228", "customerCode": "C-074", "category": "アパレル", "amount": 21500, "orderDate": "2026-06-19", "status": "キャンセル" },
{ "orderId": "ORD-0227", "customerCode": "C-021", "category": "食品・飲料", "amount": 8900, "orderDate": "2026-06-18", "status": "完了" },
{ "orderId": "ORD-0226", "customerCode": "C-103", "category": "電子機器", "amount": 76000, "orderDate": "2026-06-18", "status": "完了" },
{ "orderId": "ORD-0225", "customerCode": "C-066", "category": "家具・インテリア", "amount": 48000, "orderDate": "2026-06-17", "status": "処理中" }
]
}
Squadbaseへの取り込み手順
取り込み手順は下記になります。
- Newボタンをクリック。
- データソースから「Squadbase DB」を選択。 ※SquadbaseにはJSON用のコネクタは存在しません
- 開発者モードをオンにする。
- 「コード」タブ内の「src」ディレクトリを右クリックし、「ファイルをアップロード」。
- JSONファイルを選択し、ファイルをアップロード。
- 「src」ディレクトリ内にファイルがアップロードされたことを確認。
7. チャット欄にて下記の依頼をする。
src/sample-data.jsonのデータを変換し、Squadbase DBに格納してください。
8. 「データ」タブ内のSquadbase DBにテーブルが作成されていること確認する。
9. Squadbase DBのテーブルを参照してダッシュボードを作成する。
検証結果
検証結果は以下のとおりです。
- JSON用のコネクタは存在しないものの、srcディレクトリにファイルをアップロードし、Squadbase DBへの変換を依頼することで、取り込みは可能。
- しかし、正規の取り込み手順ではないため、特別な理由がない限りは、DBを用意して接続するのが無難。
まとめ
今回はJSONファイルをSquadbaseに取り込む検証をおこないました。SquadbaseではAIと対話しながら柔軟に処理ができるため、専用コネクタのないJSONファイルでも取り込むことができました。公式な手順ではありませんが、柔軟なデータ連携を実現する有効な選択肢の一つとして、ぜひ検討してみてください。
この記事を書いた人
