[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"blogEntry::post\u002Fkarte-datahub-codatum:ja":3},{"title":4,"slug":5,"description":6,"body":7,"author":8,"category":9,"coverImageUrl":13,"ogImageUrl":14,"createdAt":15,"updatedAt":16,"datePublished":17,"locale":18,"related":19},"KARTE DatahubのデータをCodatumで分析するためのステップ","karte-datahub-codatum","KARTE DatahubにあるイベントデータをCodatumから直接参照するための、サービスアカウントの発行から権限付与、BigQueryコネクションの作成、同期設定までの手順を紹介します。","\u003Cp>KARTEをCodatumに接続することで、有用な顧客データをより効果的に分析することができます。\u003C\u002Fp>\u003Cp>KARTE DatahubにあるイベントデータをCodatumから直接参照するには、KARTE Datahub側でサービスアカウント（SA）を発行し、そのSAに必要な権限を渡した上で、CodatumのBigQueryコネクションに登録する、という手順が必要です。\u003C\u002Fp>\u003Cp>この記事では、その一連の設定を紹介します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch2>\u003Cb>KARTE Datahub側での作業\u003C\u002Fb>\u003C\u002Fh2>\u003Ch3>\u003Cb>サービスアカウントを払い出す\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F4RBPRuDec4TywJ2OaSLjuh\u002F824bba37629b6a3d3ea3b39898481be8\u002F9cc737e2-ee79-492f-9424-0dc1b90f3c9c.png\" alt=\"スクリーンショット 2026-08-13 13.42.30\">\u003C\u002Ffigure>\u003Cp>KARTEを開いたら「すべてのメニュー」から「Datahub」をクリック。\u003C\u002Fp>\u003Cp>KARTE Datahubの管理画面で、「その他の機能」→「データハブ設定」→「サービスアカウント管理」を開きます。\u003C\u002Fp>\u003Cp>「払い出しGoogleサービスアカウント」から「Googleサービスアカウント作成」を押し、ダウンロードするキータイプを選択して保存します。このキーファイルは紛失すると復元できないため、大切に保管してください。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch3>\u003Cb>払い出したSAにジョブ実行権限を付与する\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002FnHy2AdJNQf2tyYn2vMuur\u002Fbd8dd7e5def91fd7634d3b32d2df7f2d\u002F4d1ebd52-c607-44ff-8c0b-25360c022f1e.png\" alt=\"スクリーンショット 2026-08-13 13.57.58\">\u003C\u002Ffigure>\u003Cp>「BQクエリ実行権限付与済みアカウント」から「権限付与」を押し、先ほど作成したSAを入力して権限を付与します。\u003C\u002Fp>\u003Cp>この権限を付与しておくことで、発行したSAを使ってBigQueryのクエリを実行できるようになります。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch3>\u003Cb>データセットにSAの閲覧権限を付与する\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F4f0XxXeuIDL9EodulQLKo9\u002Fd508e7364d220414a97da298fa237231\u002F882f2b92-1e6d-4544-ac4b-81714147a966.png\" alt=\"スクリーンショット 2026-08-13 14.01.06\">\u003C\u002Ffigure>\u003Cp>サイドバーの「データセット」から、Codatumで参照したいデータセットの「...」→「データセットの共有設定」を開きます。\u003C\u002Fp>\u003Cp>「データセットを共有するメンバーを追加」から、作成したSAに閲覧権限を付与します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Cp>ここまでの3つの手順は、\u003Ca href=\"https:\u002F\u002Fdevelopers.karte.io\u002Fdocs\u002Fdatahub-create-service-account\" target=\"_blank\" rel=\"noopener noreferrer\">KARTE Datahubのドキュメント\u003C\u002Fa>でも確認できます。ドキュメント内の「外部サービス」が、ここではCodatumに該当します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch2>\u003Cb>Codatum側での作業\u003C\u002Fb>\u003C\u002Fh2>\u003Ch3>\u003Cb>Codatumにサインアップする\u003C\u002Fb>\u003C\u002Fh3>\u003Cp>まだアカウントがない場合は、\u003Ca href=\"https:\u002F\u002Fapp.codatum.com\u002Fsignup\" target=\"_blank\" rel=\"noopener noreferrer\">こちら\u003C\u002Fa>からCodatumのアカウントとワークスペースを作成します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch3>\u003Cb>コネクションを作成する\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F7nC3WHCj0eV2CQBN90r7Su\u002Fca2f5457dab7421f0c5117222ba93978\u002F1ac2c905-f295-44a7-99fb-3a25fb15b279.png\" alt=\"スクリーンショット 2026-08-13 14.04.46\">\u003C\u002Ffigure>\u003Cp>「ワークスペース設定」の\u003Ca href=\"https:\u002F\u002Fapp.codatum.com\u002Fworkspace\u002Flast-accessed\u002Fsetting\u002Fconnections\" target=\"_blank\" rel=\"noopener noreferrer\">コネクション\u003C\u002Fa>から「+ コネクションを追加」を選び、Google BigQueryを選択します。\u003C\u002Fp>\u003Cp>コネクション名とアクセスレベルを指定し、KARTE Datahubからダウンロードしたキーファイルをアップロードして「保存」を押します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch3>\u003Cb>同期対象を設定する\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F5pGFcOryV01kVPAb0M9JZA\u002F80a2997510a7dec64200779beeb66a4d\u002F7aa7bf3d-27f6-4af6-86c2-1ed578b6260c.png\" alt=\"スクリーンショット 2026-08-13 14.09.07\">\u003C\u002Ffigure>\u003Cp>作成したコネクションを開き、「テーブル同期設定」→「同期対象」→「編集」を押します。\u003C\u002Fp>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F32aD6ZG1DqFPNnXWV6Jl5X\u002F393d58d4131ae3fbe89625020aecea64\u002Fimage__1_.png\" alt=\"image (1)\">\u003C\u002Ffigure>\u003Cp>「Projectを追加」からKARTE Datahubのプロジェクト名（例：\u003Ccode class=\"hljs\">karte-data\u003C\u002Fcode>）を入力し、「datasetを追加」から参照したいデータセット名（例：\u003Ccode class=\"hljs\">karte_stream_[api_key]\u003C\u002Fcode>）を選択して、「保存して同期」を押します。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch3>\u003Cb>SQLブロックで動作確認する\u003C\u002Fb>\u003C\u002Fh3>\u003Cfigure class=\"EmbeddedContent_Wrapper\">\u003Cimg src=\"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F5VByCLMWtjAjqpWWWxM5e7\u002Fd1fd1c2fb0ca4dff0fec758177922389\u002Fimage__2_.png\" alt=\"image (2)\">\u003C\u002Ffigure>\u003Cp>Notebookを開き、本文内で\u003Ccode class=\"hljs\">\u002F\u003C\u002Fcode>と入力してSQLブロックを挿入します。\u003C\u002Fp>\u003Cp>SQLブロックに、Datahubで実行できるSQLを入力してRunボタンを押し、実行が完了することを確認します。このとき、SQLブロックのコネクションを、先ほどアップロードしたSAのコネクションに設定していることを忘れないでください。\u003C\u002Fp>\u003Cp>\u003C\u002Fp>\u003Ch2>\u003Cb>注意点\u003C\u002Fb>\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>払い出したSAによるクエリには、1日5TBの上限があります。\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>払い出したSAによるクエリは、KARTE Datahub側のクエリ消費量に合算されます。\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cpre>\u003Ccode class=\"hljs\">karte-data\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\u003Cp>との連携時に\u003C\u002Fp>\u003Cp>\u003Cpre>\u003Ccode class=\"hljs\">karte-\u003Cspan class=\"hljs-attr\">data\u003C\u002Fspan>: \u003Cspan class=\"hljs-title class_\">Internal\u003C\u002Fspan> \u003Cspan class=\"hljs-title class_\">Server\u003C\u002Fspan> \u003Cspan class=\"hljs-title class_\">Error\u003C\u002Fspan>: \u003Cspan class=\"hljs-title class_\">Error\u003C\u002Fspan> list datasets\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\u003Cp>というエラーが表示されることがあります。これはデータセット数が多いことに起因するエラーで、クエリの実行やカタログの閲覧など、目的の操作自体ができていればそのまま無視して問題ありません。\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>同期設定について、KARTEイベントデータの場合、プロジェクト名は\u003Ccode class=\"hljs\">karte-data\u003C\u002Fcode>、データセット名は\u003Ccode class=\"hljs\">karte_stream_[api_key]\u003C\u002Fcode>、テーブル名は\u003Ccode class=\"hljs\">krt_pockyevent_v1_*\u003C\u002Fcode>になります。 \u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>\u003Cpre>\u003Ccode class=\"hljs\">karte-data\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\u003Cp>はデータセット数が非常に多いため、Projectを追加してからDatasetを追加するボタンが表示されるまで、少し時間がかかることがあります。データセット名を入力するまで同期を進められないので、焦らず待ってください。\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>イベントログの実体となるテーブルは、\u003C\u002Fp>\u003Cp>\u003Cpre>\u003Ccode class=\"hljs\">karte_event\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\u003Cp>ではなく\u003C\u002Fp>\u003Cp>\u003Cpre>\u003Ccode class=\"hljs\">krt_pockyevent_v1_*\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fp>\u003Cp>です。詳しくは\u003C\u002Fp>\u003Cp>\u003Ca href=\"https:\u002F\u002Fdevelopers.karte.io\u002Fdocs\u002Fdatahub-karte_event-table\" target=\"_blank\" rel=\"noopener noreferrer\">KARTE Datahubのドキュメント\u003C\u002Fa>\u003C\u002Fp>\u003Cp>を参照してください。\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>\u003C\u002Fp>\u003Ch2>\u003Cb>まとめ\u003C\u002Fb>\u003C\u002Fh2>\u003Cp>KARTE Datahubのデータは、サービスアカウントを発行し、ジョブ実行権限とデータセットの閲覧権限を渡した上で、そのSAのキーファイルをCodatumのBigQueryコネクションに登録すれば、Notebook上のSQLブロックからそのまま参照できるようになります。\u003C\u002Fp>\u003Cp>クエリ量の上限や\u003Ccode class=\"hljs\">karte-data\u003C\u002Fcode>のデータセット名の扱いなど、いくつか癖のある部分があるので、注意点も合わせて確認しながら進めてください。\u003C\u002Fp>","Codatum Team",{"title":10,"slug":11,"description":12},"Product Guide","product-guide","外部プロダクト・データツールの解説ガイド","https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F5YDut6sVHfsh7W6sgcqckh\u002Ff81015d41ba0b1dda52c57a17fa0a456\u002Fstep.png","https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002FGG7aLGJKXq4AF4c9eWiIx\u002Ffa9bcf9c2a961c036cf6d0e594701310\u002Fstep_og.png","2026-08-31T06:55:55.587Z","2026-08-31T06:57:00.433Z","2026-08-31T00:00+09:00","ja",[20,29,38],{"title":21,"slug":22,"description":23,"author":8,"category":24,"coverImageUrl":25,"ogImageUrl":26,"createdAt":27,"updatedAt":28,"datePublished":17,"locale":18},"BigQueryからVertex AIを呼び出すための接続設定","bigquery-vertex-ai","BigQueryでVertex AIのGeminiモデルを使うには、Google Cloud側で外部接続を作成し、BigQueryとCodatum、それぞれのサービスアカウントに正しい権限を渡しておく必要があります。ML.GENERATE_TEXTなどのAI機能をCodatumから使うための、事前設定の手順を紹介します。",{"title":10,"slug":11,"description":12},"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F7mhxfOO8PCdzX9UZMGZvTv\u002F47c803baa994313fa441b62c8b815d17\u002FVertexAI.png","https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002FK0GVwfyHFA3H6BOYjt4vg\u002Fd65a33711629ee3b1ef958fefd76a41b\u002FVertexAI_og.png","2026-08-31T06:58:52.685Z","2026-08-31T07:56:48.406Z",{"title":30,"slug":31,"description":32,"author":8,"category":33,"coverImageUrl":34,"ogImageUrl":35,"createdAt":36,"updatedAt":37,"datePublished":17,"locale":18},"Signed Embed Lightで、CodatumのノートブックをKARTE Datahubに埋め込む","signed-embed-light-codatum-karte-datahub","Codatumで作成したダッシュボードやノートブックを、KARTEのDatahub上に「Codatum BI」として埋め込むためのSigned Embed Lightのセットアップ方法と、開発者向けのトークン発行・SDK組み込み手順を紹介します。",{"title":10,"slug":11,"description":12},"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F4PMUhWMspP6Tx8Tm1VMTIY\u002Fa016cd86c6fde7c663611421a21b0b72\u002FSignedEmbedLight.png","https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F6Ocarrw0AJS7Y6q7mFU7Pk\u002Ff15041564774d6442a9f72d172a38cb3\u002FSignedEmbedLight_og.png","2026-08-31T06:55:26.836Z","2026-09-01T02:12:18.386Z",{"title":39,"slug":40,"description":41,"author":8,"category":42,"coverImageUrl":43,"ogImageUrl":44,"createdAt":45,"updatedAt":45,"datePublished":46,"locale":18},"2026年版 Power BI 完全ガイド: Microsoft Fabric時代のBI・Copilot・料金を解説","power-bi","Power BI の基本機能、Microsoft Fabric との関係、Copilot、共有・埋め込み、料金、導入前のポイントを、2026年時点の公式情報とレビュー傾向をもとに整理します。",{"title":10,"slug":11,"description":12},"https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F5MBFAxcr4v3DbfX5PwFnjB\u002F421ab4a5514e07340fcc2859c4f80dd1\u002Fcover-blueprint.png","https:\u002F\u002Fimages.ctfassets.net\u002Fggtw2zqmifs5\u002F3enYrNWqCrrxOrqQmCEwRO\u002Fda14db4190267b8c2ba1fdb5618d4a66\u002Fog-blueprint.png","2026-06-23T00:00:10.879Z","2026-06-23T09:00+09:00"]