【MCP Server】Gemini CLI からAmazon Athena のデータにリアルタイムで接続する方法
Gemini CLI は、Google のGemini AI モデルへのアクセスを提供するコマンドラインインターフェースツールです。コード生成、テキスト分析、会話型AI 機能を利用できます。コーディングで活用している方も多いのではないでしょうか。CData Connect AI と組み合わせることで、Gemini CLI をAmazon Athena とリアルタイムに連携できるようになります。この記事では、Connect AI を使用したAmazon Athena への接続方法と、Amazon Athena と対話するためのGemini CLI の構成手順をご紹介します。
CData Connect AI は、Amazon Athena のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと Amazon Athenaの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから Amazon Athena のデータの読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に Amazon Athenaへ直接送信します。サーバーサイド処理を活用することで、要求されたAmazon Athena のデータ を迅速に取得できます。
Amazon Athena データ連携について
CData は、Amazon Athena のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- IAM 認証情報、アクセスキー、インスタンスプロファイルなど、さまざまな方法で安全に認証できます。多様なセキュリティニーズに対応し、認証プロセスを簡素化します。
- 詳細なエラーメッセージにより、セットアップを効率化し、問題を迅速に解決できます。
- サーバーサイドでのクエリ実行により、パフォーマンスを向上させ、クライアントリソースへの負荷を最小限に抑えます。
ユーザーは、Tableau、Power BI、Excel などの分析ツールと Athena を統合し、お気に入りのツールから詳細な分析を行うことができます。
CData を使用した Amazon Athena のユニークなユースケースについては、ブログ記事をご覧ください:https://jp.cdata.com/blog/amazon-athena-use-cases
はじめに
ステップ1: Gemini CLI 用の Amazon Athena 接続を構成
それでは早速、Gemini CLI から Amazon Athena への接続を設定していきましょう。Gemini CLI から Amazon Athena と対話するには、まずCData Connect AI でAmazon Athena 接続を作成して構成します。
-
Connect AI にログインし、「Connections」をクリックして「 Add Connection」をクリックします
-
「Add Connection」パネルから「Amazon Athena」を選択します
-
Amazon Athena に接続するために必要な認証情報を入力しましょう。
Amazon Athena 接続プロパティの取得・設定方法
それでは、早速Athena に接続していきましょう。
データに接続するには、以下の接続パラメータを指定します。
- DataSource:接続するAmazon Athena データソース。
- Database:接続するAmazon Athena データベース。
- AWSRegion:Amazon Athena データがホストされているリージョン。
- S3StagingDirectory:クエリの結果を保存するS3 フォルダ。
Database またはDataSource が設定されていない場合、CData 製品はAmazon Athena の利用可能なデータソースからすべてのデータベースのリスト化を試みます。そのため、両方のプロパティを設定することでCData 製品のパフォーマンスが向上します。
Amazon Athena の認証設定
CData 製品は幅広い認証オプションに対応しています。詳しくはヘルプドキュメントの「はじめに」を参照してみてください。
AWS キーを取得
IAM ユーザーの認証情報を取得するには、以下のステップお試しください。
- IAM コンソールにサインインします。
- ナビゲーションペインでユーザーを選択します。
- ユーザーのアクセスキーを作成または管理するには、ユーザーを選択してからセキュリティ認証情報タブに移動します。
AWS ルートアカウントの資格情報を取得するには、以下のステップをお試しください。
- ルートアカウントの認証情報を使用してAWS 管理コンソールにサインインします。
- アカウント名または番号を選択します。
- 表示されたメニューでMy Security Credentials を選択します。
- ルートアカウントのアクセスキーを管理または作成するには、Continue to Security Credentials をクリックし、[Access Keys]セクションを展開します。
その他の認証オプションについては、ヘルプドキュメントの「Amazon Athena への認証」を参照してください。
「Create & Test」をクリックします
-
「Add Amazon Athena Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。
パーソナルアクセストークンを追加する
パーソナルアクセストークン (PAT) は、Gemini CLI からConnect AI への接続を認証するために使用します。アクセスの粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。
- Connect AI アプリの右上にある歯車アイコン () をクリックして、設定ページを開きます。
- 「Settings」ページで、「Access Tokens」セクションに移動し、 「Create PAT」をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の使用のために安全に保管してください。
これで、Gemini CLI からAmazon Athena に接続する準備が整いました!
ステップ 2: CData Connect AI 用に Gemini CLI を構成
それでは、CData Connect AI に接続するための Gemini CLI を構成していきましょう。
-
システムに Gemini CLI がインストールされていることを確認します。インストールされていない場合は、npm を使用してインストールしましょう。
npm install -g @google/gemini-cli
-
Gemini CLI の設定ファイルを見つけましょう。ファイルが存在しない場合は新規作成してください。
- Linux/Unix/Mac: ~/.gemini/settings.json
- Windows: %USERPROFILE%\.gemini\settings.json
-
設定ファイルの「mcpServers」オブジェクトに CData Connect AI を追加します。YOUR_EMAIL とYOUR_PAT を、Connect AI のメールアドレスと先ほど作成したPAT に置き換えてください。
{ "mcpServers": { "cdata-connect-cloud": { "httpUrl": "https://mcp.cloud.cdata.com/mcp", "headers": { "Authorization": "Basic YOUR_EMAIL:YOUR_PAT" } } } }例えば、メールアドレスが [email protected] で、PAT が Uu90pt5vEO... の場合、Authorization ヘッダーは次のようになります:"Authorization": "Basic [email protected]:Uu90pt5vEO..."
- 設定ファイルを保存します。これで、Gemini CLI はデータ操作に CData Connect AI MCP Server を使用するようになります。
ステップ 3: 自然言語でライブの Amazon Athena のデータ をクエリする
Gemini CLI が構成され、CData Connect AI に接続されたので、自然言語クエリを使用して Amazon Athena と対話できるようになりました。MCP 統合により、質問をして Amazon Athena データソースからリアルタイムで応答を受け取ることができます。
Gemini CLI を使ってデータの探索を始めてみましょう:
-
ターミナルを開いて、Gemini CLI セッションを開始します:
gemini
-
これで、自然言語を使って Amazon Athena をクエリできます。例えば:
- 「過去 30 日間のすべての顧客を表示して」
- 「最もパフォーマンスの良い製品は何ですか?」
- 「第 4 四半期の売上トレンドを分析して」
- 「すべてのアクティブなプロジェクトとその現在のステータスをリスト表示して」
- Gemini CLI は、自然言語クエリを適切な SQL クエリに自動的に変換し、CData Connect AI MCP Server を通じて Amazon Athena データに対して実行します。
Gemini CLI の自然言語処理機能と CData Connect AI の堅牢なデータ接続機能を組み合わせることで、複雑な SQL クエリを記述したり、基礎となるデータ構造の深い技術知識を必要とすることなく、Amazon Athena を探索して分析できます。
CData Connect AI を入手する
クラウドアプリケーションから 300 以上の SaaS、ビッグデータ、NoSQL ソースへのライブデータアクセスを取得するには、今すぐ CData Connect AI をお試しください!