kintone×BigQuery 連携|読み込みで止まる所と、サブテーブルの集計の間違い
kintone の応答をスキーマの自動検出でそのまま BigQuery に読み込むと止まります。架空の見積30件を当社の検証環境で試し、止まる所、試した2つの入れ方、サブテーブルで金額を二重に数える間違い、BI 用の表を確かめました。
目次 クリックで開く
この記事の要点
- kintone の REST API の応答を、スキーマの自動検出でそのまま BigQuery に読み込むと、
$idという名前が列名に使えず止まります。名前を変えれば自動検出で入りますが、値は type と value の入れ子、サブテーブルは繰り返しの列になります。 - サブテーブルを UNNEST で明細の行に展開したあとに親の合計を足すと、明細の行数だけ金額が重なります。当社の検証では、受注の 2,990,000 円が 8,600,000 円になりました。
- BI には明細1行を1行にした表を作って渡し、親の合計と明細の合計を突き合わせてから使います。取り出しは1回500件までで、1日の回数にはアプリごとに上限があります。
kintone から BigQuery へ:当社の検証で通った道
展開したあとに親の合計を足すと、受注 2,990,000 円が 8,600,000 円になった
出典:当社の検証(2026年10月14日、検証用 kintone の架空の見積アプリ30件・明細70行、BigQuery 東京リージョン)
kintone の REST API で取り出したレコードを、スキーマの自動検出でそのまま BigQuery に読み込むと止まります。応答に入っている $id というキーが、BigQuery の列名に使えないためです。キーの名前を変えれば読み込めます。ただし、値は「type と value」の入れ子のまま入り、サブテーブル(kintone の画面では「テーブル」)は1つの列の中に明細が繰り返し入ります。この形のまま集計すると、金額を二重に数える間違いが起きます。
当社は、kintone の業務アプリづくりを手伝い、BigQuery を中心にしたデータ基盤の設計・構築も支援しています。この記事では、当社の検証用 kintone に架空の見積アプリを作って試した結果を載せます(2026年10月14日)。REST API で取り出したレコードを、当社の検証用の Google Cloud プロジェクトの BigQuery(東京リージョン)に読み込み、集計まで進めました。レコードは30件、明細の行は合わせて70行で、会社名などはすべて架空です。kintone の API の上限や連携ツールの機能は、それぞれの公式の資料で確かめた範囲で書きます。BigQuery から kintone への書き戻し、添付ファイル、機械学習は扱いません。
kintone の REST API は、レコードをこの形で返す
試したアプリには、見積番号(quote_no)、会社名(company)、見積日(quote_date)、状態(status:提出前・提出済・受注・失注のドロップダウン)、明細のサブテーブル(lines:品名 item・数量 qty・単価 unit_price・金額 line_amount)、合計(total:明細の金額を足す計算フィールド)を置きました。フィールドコードは英字です。レコードを一括で取る API(GET /k/v1/records.json)の応答(作成者・更新者を伏せたもの)から1件を、並びを入れ替えて短くすると次のとおりです(… は省略)。
{
"$id": {"type": "__ID__", "value": "1"},
"$revision": {"type": "__REVISION__", "value": "1"},
"quote_no": {"type": "SINGLE_LINE_TEXT", "value": "Q-0001"},
"total": {"type": "CALC", "value": "200000"},
"lines": {"type": "SUBTABLE", "value": [
{"id": "1083384", "value": {
"item": {"type": "SINGLE_LINE_TEXT", "value": "帳票作成"},
"qty": {"type": "NUMBER", "value": "1"},
"unit_price": {"type": "NUMBER", "value": "40000"},
"line_amount": {"type": "CALC", "value": "40000"}}},
{"id": "1083385", "value": {"item": …, "qty": …}}
]},
"作成日時": {"type": "CREATED_TIME", "value": "2026-10-13T15:04:00Z"}
}
BigQuery に入れるときに効いてくるのは、次の3点です(cybozu developer network「フィールド形式」)。
- 1つのフィールドが type(種類)と value(値)の組で返ります。数値フィールドも計算フィールドも、value は “1” や “200000” のような文字列です。計算フィールドの value の形式は、表示書式の設定で変わります。
- サブテーブルの value は行の配列で、行ごとに id(行の ID)が付きます。明細の行を後から特定するキーになります。
- レコード ID の
$id、版の番号の$revision、レコード番号・作成者・作成日時などが一緒に返ります。作成者の value は code と name を持つオブジェクト、日時は末尾に Z の付いた UTC の文字列です。
日本時間の日付で数えるときは、BigQuery の側で DATE(作成日時.value, 'Asia/Tokyo') のように時刻帯を指定します。指定しないと UTC の日付になります(BigQuery の日付関数)。
取り出す側の決まり:1回500件、offset は1万まで、回数はアプリごと
検証では、query に order by レコード番号 asc limit 500 を付けた1回のリクエストで、30件すべてが返りました。件数が増えると、kintone の側の決まりが効いてきます。公式の資料で確かめた値は次のとおりです。
| 決まり | 値 | 連携で気にすること |
|---|---|---|
| 1回で取れる件数 | 最大500件(limit を書かないと100件) | 500件ずつなら、回数は件数÷500で済む |
| offset | 最大10,000 | 1万件を超えるアプリは offset だけでは読み切れない |
| カーソル API | 1回1〜500件。期限は最後のリクエストから10分。有効なカーソルは1ドメイン10個まで。limit・offset は書けない | 並行して動く連携が多いと足りなくなる |
| 同時に実行できる REST API | 1ドメイン100まで。超えると HTTP 429 | ドメイン全体の REST API がエラーになる |
| 1日の API リクエスト数 | アプリごと。スタンダードコース1万、ワイドコース10万。数えるのはアプリを1つ指定する API だけで、bulkRequest は中の API を1つずつ数える。毎日午前9時にリセット | 超えてもエラーにならず、翌日9時ごろストアの管理者に警告メールが届く |
| API トークン | 1アプリ20個まで。操作は Administrator の操作として扱われる | 取り出すだけなら権限はレコードの閲覧で足りる |
出典:レコードを一括取得する、クエリの書き方、カーソルを作成する、kintone ヘルプ「制限値一覧」、kintoneの性能Vol.2、kintone 料金、kintone REST APIの認証。料金ページによると、API による外部サービスとの連携はスタンダードコース以上の機能です。
1万件のアプリを毎日全件取り直しても、500件ずつなら1回の転送で20リクエストです。上限に近づくのは、同じアプリを短い間隔で何度も取りに行く場合や、ほかのカスタマイズと回数を分け合う場合です。1万件を超えるアプリでは、cybozu developer network が挙げる次の取り方を選びます(30件の検証では試していません)。
1万件を超えるアプリの取り出し方
offset で順に取る
limit と offset を足しながら
- 書き方が単純
- 1万件を超えないと見込めるときだけ使う
- 並び順や件数で取得の時間が変わる
レコード ID で区切って取る
前回の最後の $id より大きいものを order by $id asc で
- 取得の時間が件数に比例し、速く取れる
- 並べ替えの条件が要らないときに向く
- 複数のフィールドで並べたいときは条件が複雑になる
カーソル API
カーソルを作る → 取る → 削除する
- 並び順や件数に関係なく時間が安定する
- 1ドメインで有効なカーソルは10個まで
- 数を見積もれるバッチ処理に向く
出典:cybozu developer network「offsetの制限値を考慮したkintoneのレコード一括取得について」、「カーソルを作成する」
変わった分だけを取るなら、クエリで 更新日時 >= "2026-10-13T00:00:00Z" order by 更新日時 asc のように、前回の最後の更新日時を含めて絞り込みます(クエリの書き方)。kintone の REST API の共通仕様では、日時に秒を付けて登録・更新しても秒は無視されます(kintone REST APIの共通仕様)。前回の最後と同じ分のうちに更新されたレコードを > で比べると、取りこぼすことがあります。そのため >= で比べ、同じ $id が2度入ったら、$revision の大きい方を残して重複を除きます。この取り方では、削除されたレコードが出てきません。その扱いは「動き始めてから止まる・ずれる所」の節で書きます。
自動検出でそのまま読み込むと「$id」で止まる
取り出した30件を、作成者・更新者を伏せたうえで1レコード1行の JSON(改行区切り JSON)のファイルにして、スキーマの自動検出をオンにして BigQuery に読み込みました。読み込みは失敗し、次のエラーが返りました(末尾の表の内部名は省いています)。
Invalid field name "$id". Fields must contain the allowed characters, and be at most 300 characters long. For allowed characters, please refer to https://cloud.google.com/bigquery/docs/schemas#column_names
BigQuery の列名に使える文字は、標準では英字・数字・アンダースコアです。日本語や一部の記号を使える「柔軟な列名」でも、$ は使えない記号に入っています(BigQuery「スキーマを指定する」の列名の節)。取り出すフィールドを指定せずに取ると応答に $id と $revision が入るので、そのまま自動検出で読み込む方法は通りません。当社は、ここから先へ進む方法を2つ試しました。次の2つの節で順に書きます。
キーの名前を変えると自動検出で入るが、入れ子のまま
読み込む前に、各行の $id を kintone_id、$revision を kintone_revision に名前を変えただけで、同じ自動検出の読み込みが通りました(30行)。推定されたスキーマの一部は次のとおりです。
| 列 | 推定された型 | kintone での値 |
|---|---|---|
total.value | INTEGER | 計算フィールド。文字列の “200000” |
quote_date.value | DATE | 日付。”2026-10-06″ |
作成日時.value | TIMESTAMP | “2026-10-13T15:04:00Z” |
lines.value | RECORD の REPEATED(繰り返し) | サブテーブルの行の配列 |
lines.value.id | INTEGER | 明細の行の ID |
lines.value.value.qty.value | INTEGER | 数値フィールド。文字列の “2” |
各フィールドは type と value の2列を持つ RECORD になり、使うのは value の側です。文字列で来た数値・日付・日時は、この30件では INTEGER・DATE・TIMESTAMP に推定されました。日本語のフィールドコード(レコード番号・作成日時など)は、そのまま列名になりました。
ただし、型の推定はデータ次第です。BigQuery の自動検出は、先頭の最大500行をサンプルとして読んで型を決め、サンプルの中で値がすべて空の列は STRING にします(BigQuery「スキーマの自動検出を使用する」)。kintone の計算フィールドは表示書式で value の形が変わるので、推定は変わり得ます。毎日の読み込みで型が変わると、前日までの表に追記できなくなります。そのため本番では、自動検出の結果を出発点にして、スキーマを決めて読み込むことをお勧めします。
もう1つの入れ方:1行を文字列のまま入れ、SQL で取り出す
前処理も省きたい場合は、応答の1行を1つの文字列として読み込みます。読み込みは CSV 形式で、区切り文字にデータに出てこない制御文字(U+0001)を指定し、引用符を無しにしました。入れる先は、STRING の列 raw を1本だけ持つ表です。30行・38,263バイトで入り、$id も元の JSON のまま残っています。値は SQL の JSON 関数で取り出し、$ のようにパスに使えない文字を含むキーは二重引用符で囲みます(BigQuery「JSON 関数」)。
SELECT
JSON_VALUE(raw, '$.quote_no.value') AS quote_no,
JSON_VALUE(raw, '$."$id".value') AS kintone_id,
SAFE_CAST(JSON_VALUE(raw, '$.total.value') AS INT64) AS total,
ARRAY_LENGTH(JSON_QUERY_ARRAY(raw, '$.lines.value')) AS line_rows
FROM `your-project.blog_demo.kintone_quotes_raw`
ORDER BY SAFE_CAST(kintone_id AS INT64)
LIMIT 5
| quote_no | kintone_id | total | line_rows |
|---|---|---|---|
| Q-0001 | 1 | 200000 | 2 |
| Q-0002 | 2 | 140000 | 2 |
| Q-0003 | 3 | 400000 | 3 |
| Q-0004 | 4 | 450000 | 1 |
| Q-0005 | 5 | 320000 | 4 |
型と列名を SQL の側で決められるので、kintone にフィールドを足したときも、元の形から表を作り直せます。代わりに、取り出しの SQL を自分で書いて保守します。JSON_VALUE は指した値がオブジェクトや配列だと NULL を返すので、サブテーブルは JSON_QUERY_ARRAY で取り出します。
2つの入れ方の違い
名前を変えて自動検出
$id・$revision の名前だけ変える
- フィールドごとに type と value の RECORD
- サブテーブルは繰り返しの列
- 型はサンプル次第。本番はスキーマを決める
1行を文字列で入れる
raw の1列に元の JSON をそのまま
- 前処理が要らない。$id も残る
- 型と列名は SQL で決める
- 取り出しの SQL を自分で書いて保守する
出典:当社の検証(架空データ。条件は冒頭)、BigQuery「JSON 関数」
サブテーブルを UNNEST で明細に展開したあとに親の合計を足すと、当社の検証では約2.9倍になった
自動検出で入れた表で、親(見積)の行だけを WHERE status.value = '受注' で数えると、受注は9件・合計2,990,000円です。品名ごとの金額を出すには、UNNEST で lines.value を明細の行に展開して、明細の金額(line_amount)を品名ごとに足します。
SELECT l.value.item.value AS item,
COUNT(*) AS line_count,
SUM(l.value.line_amount.value) AS amount
FROM `your-project.blog_demo.kintone_quotes_auto` q,
UNNEST(q.lines.value) AS l
WHERE q.status.value = '受注'
GROUP BY item
ORDER BY amount DESC
受注の明細を品名ごとに足した金額
5つの合計は2,990,000円で、親の行で数えた受注の合計と一致
出典:当社の検証(架空データ。条件は冒頭)
当社の検証では、展開した表のまま親の合計を足したところで金額が合わなくなりました。展開した結果は「明細1行が1行」なので、親の列(total)は明細の行数だけ繰り返されます。展開したまま SUM(q.total.value) を取ると、受注の明細24行分の total を足すことになり、8,600,000円になりました。正しい2,990,000円の約2.9倍です。
SELECT SUM(q.total.value) AS total_after_unnest,
COUNT(*) AS rows_after_unnest
FROM `your-project.blog_demo.kintone_quotes_auto` q,
UNNEST(q.lines.value) AS l
WHERE q.status.value = '受注'
-- 結果:total_after_unnest 8600000 / rows_after_unnest 24
同じ受注9件の金額を、3通りに足した結果
3つ目は、明細の行数だけ親の金額が重なった
出典:当社の検証(架空データ。条件は冒頭)
展開したあとに足すのは明細の側の列だけ、親の列は展開する前に足す、と決めておきます。あわせて、親の合計と明細の合計のずれを数えておくと、計算フィールドの設定や取り込みの抜けにも気づけます。今回の30件では、ずれは0件でした。
SELECT COUNTIF(diff != 0) AS mismatched, COUNT(*) AS quotes
FROM (SELECT q.total.value - (SELECT SUM(l.value.line_amount.value)
FROM UNNEST(q.lines.value) l) AS diff
FROM `your-project.blog_demo.kintone_quotes_auto` q)
-- 結果:mismatched 0 / quotes 30
もう1つ、カンマや INNER JOIN で UNNEST すると、配列が空か NULL の行は結果から除かれます。明細が1行も無い見積も件数に入れたいなら、LEFT JOIN UNNEST(q.lines.value) AS l と書きます(BigQuery「配列の操作」)。今回のデータには明細の無い見積が無かったので、この違いは試していません。
BI には明細の表を作って渡す
BI ツールで毎回 UNNEST を書かずに済むよう、明細1行を1行にした表を作りました。親から見積番号・見積日・状態を、明細から行の ID・品名・数量・単価・金額を持たせ、kintone のレコード ID も残しています。
CREATE OR REPLACE TABLE `your-project.blog_demo.kintone_quote_lines` AS
SELECT q.kintone_id.value AS record_id,
q.quote_no.value AS quote_no,
q.quote_date.value AS quote_date,
q.status.value AS status,
l.id AS line_id,
l.value.item.value AS item,
l.value.qty.value AS qty,
l.value.unit_price.value AS unit_price,
l.value.line_amount.value AS line_amount
FROM `your-project.blog_demo.kintone_quotes_auto` q,
UNNEST(q.lines.value) AS l
できた表は70行・30レコード分で、金額の合計は10,460,000円と、kintone の30件の合計と一致しました。この表なら、BI で品名別・月別に足しても親の金額は重なりません。見積の件数は COUNT(DISTINCT record_id) で数えます。line_id は kintone の明細の行の ID なので、元の行をたどれます。親と明細の持ち方にはほかの形もありますが、「どの列をどこで足すか」の決まりは変わりません。
| 持ち方 | 中身 | 気をつけること |
|---|---|---|
| 入れ子のまま(今回の自動検出の表) | 1見積1行。明細は繰り返しの列 | BI の側では、展開しないと明細が見えない |
| 親の表と明細の表に分ける | 見積の表と、レコード ID を持つ明細の表 | 2つを結合したら、親の列は足さない |
| 明細に親の項目を写した1枚の表(今回の kintone_quote_lines) | 明細1行が1行。見積番号・状態を各行に持つ | 親の合計の列は持たせない。持たせるなら足さない |
BI は、Google のデータポータル(英語名 Data Studio)から BigQuery に直接つなげます(Google Cloud「データポータル」)。データポータルは旧 Looker Studio で、2026年4月に名前が戻りました。作り方はデータポータルの記事に書いています。
毎日動かす仕組み:自作か、連携ツールか
この流れを毎日動かす仕組みは、自作するか、連携ツールを使うかです。今回の検証は自作の形で、連携ツールは試していません。各社の公式の資料で確かめられた範囲で並べます。
| 方法 | kintone からの取り出し | 料金(公式に載っているもの) |
|---|---|---|
| 自作(REST API と BigQuery の読み込み) | 上の決まりに沿って自分で書く。offset・カーソル・429 の再試行、フィールドの変更への追従も自分で引き受ける | バッチ読み込みは共有のスロットを使う限り無料。かかるのはクエリとストレージ(BigQuery の料金) |
| TROCCO | 転送元に kintone を選べる。カーソル API で取るので、クエリに limit・offset を書くとエラーになる。テーブルは既定で行単位に展開して転送する(ドキュメント) | Starter 月7.5万円・Essential 月15万円・Advanced 月30万円(税抜)。処理時間は月30・250・600時間までで、超えると20時間単位の追加料金がかかる。Free は月2時間までで、超えても追加料金はかからず、ジョブの実行が制限される(料金プラン)。kintone がどのプランで使えるかは料金ページに記載が無い |
| CData Sync | 連携のページで、増分の更新とスキーマの自動複製をうたう。サブテーブルと削除の扱いは記載が無い(連携のページ) | 標準プラン 年128万円(月1億レコードまで)、2コネクション限定プラン 年64万円。税込か税抜かの記載は無い(価格のページ) |
| Fivetran | kintone のコネクタは、ドキュメントの見出しに「Kintone Lite In Dev」と表示されている(ドキュメント) | — |
ツールを使っても、親の金額をどこで足すかは、受け取った側の SQL と BI の設計で決まります。明細の行単位に展開して送る設定なら、受け取った表は前の節の「明細の表」と同じ形なので、親の合計の列を足さないようにします。ETL ツール全般の選び方はデータ統合ツールの選び方の記事にまとめています。自作でもツールでも、用意するものは同じです。
連携を動かす前に用意するもの
1
取り出すアプリとフィールド
- 分析に使うフィールドを選ぶ
- 使わない長い文章のフィールドは外す
2
kintone の API トークン
- アプリごとに作る(1アプリ20個まで)
- 取り出すだけなら権限はレコードの閲覧
- IP 制限があるなら接続の方法を決める(下の段落)
3
Google Cloud プロジェクト
- 新しいプロジェクトでは BigQuery API が自動で有効になる
- 既存のプロジェクトは API が有効かを確かめる(有効にするにはサービス使用状況管理者のロールが要る)
4
BigQuery のデータセット
- ロケーションを決める(検証は東京 asia-northeast1)
5
サービスアカウント
- BigQuery データ編集者:表を作る・更新する
- BigQuery ジョブユーザー:読み込みとクエリのジョブを動かす
6
連携ツールへの登録(使う場合)
- kintone と BigQuery の接続情報をツールに登録する
- 少ない件数で一度転送し、件数と合計を kintone と比べる
7
頻度と、全件か差分か
- 毎回入れ替えるか、更新日時で差分を取るか
- 削除の扱いと一緒に決める(次の節)
出典:kintone REST APIの認証、kintone ヘルプ「制限値一覧」、BigQuery「IAM でのアクセス制御」、BigQuery「Google Cloud コンソールで BigQuery を詳しく見る」、TROCCO「転送元 – kintone」
IP アドレスで接続元を制限している kintone では、実行する環境の IP アドレスを許可する、Basic 認証のヘッダーを付ける、クライアント証明書を使う、のどれかが要ります(kintone REST APIの認証)。定時を待たずに送りたいなら、kintone の Webhook で、レコードの追加・編集・削除などを外部へ通知できます(cybozu developer network「kintone Webhook」)。ただし、通知されない操作があります(次の節)。この記事は定時の転送を前提にしています。REST API そのものの使い方はkintone REST API 連携の記事に書いています。
動き始めてから止まる・ずれる所
連携を動かし始めてから起きることを、症状から引ける表にしました。当社の検証は30件の1回の取り込みなので、ここの現象は試していません。公式の資料にある仕様から書いています。
| 症状 | 原因 | 対処 |
|---|---|---|
| kintone で消したレコードが BigQuery に残る | 更新日時で差分だけを取ると、削除されたレコードは結果に出てこない | 定期的に全件の $id だけを取って BigQuery の表と突き合わせ、kintone に無いものを消す。Webhook の削除の通知だけに頼らないのは、一括の操作など通知されない操作があるため(下の段落) |
| 読み込みが失敗する、列が増える | フィールドコードやフィールドの種類が変わり、列名や型が変わった | フィールドを変える前に連携の担当へ知らせる決まりを作る。文字列で入れる形なら SQL を直して作り直す |
| 取引先の名前などが古いまま | ルックアップでコピーした値は、参照先を更新しても自動では変わらない(cybozu developer network) | 参照先のアプリも BigQuery に入れて、ID で結合して名前を取る |
| ほかのアプリの連携までエラーになる | 同時実行が1ドメイン100を超えると HTTP 429。ドメイン全体の REST API がエラーになる | 並列の数を抑え、429 のときは間を空けて再試行する |
| 1日の上限の警告メールが届く | アプリごとの1日の回数を超えた(エラーにはならない) | 1回500件で取る、差分にする、間隔を空ける |
| 転送が失敗していたことに後から気づく。失敗した日の分が抜ける | 失敗を知らせる仕組みが無いと、表が更新されていないことに気づきにくい | 転送ごとに成否と最後に取り込んだ更新日時を記録し、失敗したら担当に知らせる。記録があれば、抜けた期間を更新日時で決めて取り直せる。BigQuery の読み込みジョブの記録は INFORMATION_SCHEMA.JOBS でも見られる |
| クエリの費用が読めない | 処理したバイト数で課金。小さな表でも1本ごとに最低10 MB | 1日の処理量に上限を置く。選ぶ列を絞る |
Webhook の削除の通知について補足します。Webhook を使って動く kintone コネクタ(Power Automate)の資料では、画面からのレコードの一括削除、REST API での一括登録・一括更新・削除、ファイルの読み込みは対象外とされています。通知はドメイン全体で1分間に60回までです。61回目以降の操作は通知されず、エラーのときの再送もありません(cybozu developer network「kintoneコネクタ(Microsoft Power Automate)を使う前に知っておきたいこと」)。削除を確実に反映するには、全件の $id と突き合わせる方法を併せて用意することをお勧めします。通知が届かなかった削除も、突き合わせなら見つけられるためです。
費用:小さな表でも1本10 MB から数える
検証のクエリは、処理した量が1本あたり531バイトから38,263バイトでしたが、課金の対象の量はどれも最低の10 MB(記録では10,485,760バイト)でした。オンデマンドの料金は、クエリが参照する表ごと・クエリごとに最低10 MBで数え、毎月1 TiB までは無料です。バッチ読み込みは共有のスロットを使う限り無料です。ストレージは毎月10 GiB まで無料で、90日続けて変更の無い表やパーティションは料金が自動で約50%下がります。表が大きくなったら、パーティションとクラスタで1本のクエリが読む量を減らせます(BigQuery の料金)。単価と見積もりの考え方はBigQuery でデータ統合基盤を構築する費用に書いています。
使いすぎを止めるには、カスタム割り当てで1日の処理量に上限を置きます。上限は、プロジェクト全体(QueryUsagePerDay)か、ユーザーごと(QueryUsagePerUserPerDay)に置けます。カスタム割り当てが効くのは、オンデマンドの料金のクエリだけです。超えたクエリは「Custom quota exceeded」のエラーで止まりますが、割り当ては概算なので、少し超えて動くクエリもあります(BigQuery「カスタム クエリ割り当て」)。
権限:BigQuery に入ったら、kintone のアクセス権は効かない
API トークンでの操作は、Administrator の操作として扱われます。また、BigQuery に入ったデータには、kintone のアクセス権が及びません。誰が見られるかは BigQuery の側で決め直します。分析に使わない個人の情報は取り込む段階で外し、見せる人を絞りたい列(利益率など)はポリシータグで読める人を限ります。権限の無い人が SELECT * を実行するとエラーになるので、その列を EXCEPT で外して書き直します(BigQuery「列レベルのアクセス制御」)。誰がいつどのクエリを実行したかは、監査ログと INFORMATION_SCHEMA.JOBS で確かめられます(BigQuery「ワークロードの監査」)。
最初の1本は、明細の表と突き合わせまで作る
連携ツールを選ぶ前に決めておくのは、明細の表の形と、親の合計と明細の合計の突き合わせです。最初の1アプリは、応答を文字列のまま入れ、JSON 関数と UNNEST で明細の表を作ってください。そして、kintone の画面の合計と BigQuery の合計が一致するかを確かめるところまで進めてください。そのあとで、件数と頻度に合わせて、自作かツールかを決めます。
kintone のフィールドコードやサブテーブルの持ち方から、BigQuery の表と BI の設計まで一緒に考えたい場合は、当社のデータ分析・活用の支援で承ります。kintone とつなぐ先の全体はkintone の SaaS 連携の記事にまとめています。
検証の数字は、当社の検証用 kintone と検証用の Google Cloud プロジェクト(東京リージョン)で2026年10月14日に動かした結果で、データはすべて架空です。kintone・BigQuery・各ツールの仕様と料金は、同じ日に各社の公式の資料で確かめたものです。
kintone導入・内製化支援
kintoneを現場の業務に合わせて設計・構築し、Excelや紙業務の置き換え、他システムとのデータ連携、社内メンバー自身が改修・運用できる内製化までを支援します。





