Gemini EnterpriseからSnowflakeのデータを聞ける　権限は利用者のまま、設定7手順

Snowflakeを使っている企業の開発者やデータ担当者は、Gemini Enterpriseのエージェントから、社内データに自然言語で質問できる仕組みを自分たちで組めます。クエリは認証済みユーザーのOAuthセッションとロール権限で実行されるため、権限を考慮したアクセス管理ができます。関係するのは、Google CloudでAIエージェントを開発する人です。

Snowflakeは、企業の売上や顧客データを集めて分析するデータウェアハウス（分析用のデータ倉庫）です。Google Cloud公式ブログの日本語版（原文は米国時間10月28日）は、この倉庫とGemini Enterpriseをつなぐ手順を示しました。

標準の直接接続とは別の、独自開発向けの方法

ブログによると、今回の構成は「高度なカスタム オーケストレーション パターン」にあたります。たとえば、Snowflakeの分析結果を外部の業務ツールと組み合わせる流れや、複数のエージェントが連携する仕組みを作る場合です。

Gemini EnterpriseをSnowflakeに直接つなぐ標準的な使い方には、別の共同ソリューションが案内されています。まずそちらで足りるかを確かめるとよいでしょう。

今回の方法では、Gemini Enterprise側からSnowflakeのデータを呼び出します。Googleの料金ページでは、ADKで構築した独自エージェントの導入は、Standard / Plusエディションの機能として案内されています。

SQLの生成も実行もSnowflake側で行う

質問は、Google Agent Development Kit（ADK、エージェントを作るための開発キット）で作ったエージェントが受け取ります。エージェントはそれをMCP（AIが外部のツールを呼び出すための共通の規格）のサーバー経由で、Snowflake側のCortex Agentに渡します。

Cortex Agentは、質問をSQLに変換します。そのSQLは、認証済みユーザーのOAuthセッションとロール権限で、Snowflake内で直接実行されます。結果は構造化された形でエージェントに返ります。

ブログは、この方式でスキーマのハルシネーション（存在しない表や列を作ってしまう誤り）と、検証されていないSQLの実行のリスクが軽くなると説明しています。変換は、企業が定義したセマンティックビュー（指標や表の意味を定めた層）に基づきます。

設定の7ステップと権限の注意点

手順は次の7つです。

1. Snowflakeで、OAuthの機密クライアントとなるセキュリティインテグレーションを作ります。更新トークンの有効期間は、Snowflakeの上限の90日（7776000秒）に設定します。
2. エージェント専用のロールを作り、最小権限で必要なデータベース、スキーマ、ウェアハウスの利用権を与えます。
3. セマンティックビュー上でCortex Agentを作り、CORTEX_AGENT_RUNのツールとして公開するMCPサーバーを用意します。
4. エージェントとMCPサーバーの利用権を与え、DESCRIBE MCP SERVERでエンドポイントのURLを調べます。
5. PythonでADKのエージェントを書きます。モデルにはgemini-2.5-flashを使っています。
6. 指定のフォルダー構成にして、agents-cli deployで、Agent Platform上のAgent Runtimeにデプロイします。
7. Google CloudコンソールのGemini Enterpriseのページで、カスタムエージェントを登録し、OAuthの情報を設定します。

特に注意が要る点が3つあります。

• セマンティックビューだけに権限を与えても足りません。元の物理テーブルへのSELECT権限がないと、実行時にエラーになります。
• 元のテーブルへの直接アクセスをセキュリティ方針で禁じている場合は、その上にセキュアビューを置き、さらにその上にセマンティックビューを作ります。利用者のロールには、セキュアビューとセマンティックビューへの権限だけを与えます。
• OAuthトークンは、認可した時点のデフォルトのロールとウェアハウスに固定されます。認可の前に、ALTER USERでデフォルトを設定しておく必要があります。認可のあとは、元の設定に戻せます。

SYSTEM_EXECUTE_SQLのような、未加工のSQL実行ツールは外部のクライアントに公開しないよう、ブログは求めています。公開すると、Cortex Agentによる一元管理を迂回できてしまうためです。

日本での提供と料金はどこまで分かる？

• ブログには、Gemini Enterpriseのカスタムエージェント機能の日本での提供については書かれていません。
• この構成で発生する追加料金は、ブログには記載されていません。Googleの日本向け料金ページでは、Gemini EnterpriseのBusinessエディションは1ライセンス月額$21から、ADKで構築した独自エージェントを導入できるStandard / Plusエディションは1ライセンス月額$30からと案内されています。

料金の詳しい比較は Geminiの有料プランは月額￥725から。無料との違いを料金で確認 へ

OAuthの認可名とURIを確認する

OAuthの認可画面の設定では、ADKのコードに書いたAUTH_ID（例はsnowflake_oauth_conn）と同じ名前を、認可名に入力します。Client IDとClient secretは、SYSTEM$SHOW_OAUTH_CLIENT_SECRETSで取得します。Token URIとAuthorization URIは、DESCRIBE SECURITY INTEGRATIONの結果から取ります。

Authorization URIには、認可コードフローに必要なresponse_type=codeを追加します。ほかのパラメータがある場合は「&response_type=code」、ない場合は「?response_type=code」です。

ブログのコードは標準版です。エラー処理や構造化スキーマなどは、自社の要件に合わせて足すことが勧められています。