• ロジック
  • 検証
  • 修正
  • 人間

AIを活用して生成されたSQLクエリをデバッグする方法

Cube.devをエージェントに接続すれば、生成された生のSQLを確認できます。本番データに反映される前に、ロジックの誤りを未然に防ぎましょう。

このページについてAIに聞く

すぐに答え

AIエージェントが書いたSQLをどうやってデバッグするのか?

エージェントはCube.dev MCPを使用して、データリクエストに対して生成された正確なSQL文字列を取得します。これらのクエリを検証することで、ロジックのどこに問題があるかを特定し、直接実行して結果を確認できます。このプロセスにより、エラーの発見と修正がスムーズになります。

デバッグの成果

デバッグの役割分担

クエリの構築という重労働はAIが行いますが、ロジックの制御は常にあなたが握っています。

ロジック

結合ミスを特定

AIが取得した生のSQLを確認することで、テーブルの結合が間違っていないか、フィルタが漏れていないかをチェックできます。数値がなぜ異なるのか、その理由が明確になります。

検証

実行と確認

疑わしいクエリが見つかったら、そのまま実行して実際のデータ出力を確認できます。AIのロジックが期待通りであるかを即座に判断可能です。

修正

エージェントの修正

AIが誤ったSQLを書いた場合、クエリ内の具体的なエラー箇所を指摘してください。AIはそのフィードバックをもとに、正しいステートメントを書き直します。

人間

手動による管理

AIはCube.devのデータモデル自体を書き換えることはできません。セマンティックレイヤーの管理は引き続きあなたが行い、スキーマの問題は自身で修正する必要があります。

ワークフロー

クエリ要求時にAIが行うプロセス

エージェントは質問の解釈から、コードの生成、テストまでを段階的に進めます。

  1. SQLの抽出

    データリクエストの内容を解析し、Cube.devのセマンティックレイヤーに対応するSQL文字列を生成します。

    get_sql
  2. コードの検証

    実際にデータを取得する前に、生成されたSQLを提示してロジックを確認できるようにします。

    get_sql
  3. 実行テスト

    実際のデータを確認したい場合、エージェントはCube.devインスタンスに対してクエリを実行します。

    execute_cube_sql
  4. 結果の照合

    実行結果をもとに、データが元の質問の意図と一致しているかを確認します。

    execute_cube_sql

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って、データクエリのデバッグを開始しましょう。

出発点

括弧内のテキストを、実際のCube.devのメジャーやディメンションに書き換えて使用してください。

Cube.dev Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_umZADPejupUUQHrfZkQT0lvv7MlK4j1JkrhOJOMy/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Cube.dev capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "cubedev-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_umZADPejupUUQHrfZkQT0lvv7MlK4j1JkrhOJOMy/mcp"
    }
  }
}
チャットにコピー04
  • Cube.devの[total revenue]メジャーに対して生成されたSQLを教えてください。

  • [active users]のSQLが正しくないようです。使用している正確なクエリを見せてください。

  • このSQLをCube.devで実行して、[last month]の結果を教えてください:[ここにSQLを貼り付け]

  • なぜ直前のクエリで[orders]テーブルを[users]テーブルと結合したのですか?SQLを見せてください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

一度接続すれば、あとは聞くだけ

認証情報は一度入力するだけで完了します。接続は暗号化され、安全に保たれます。設定後は、あらゆるMCP対応クライアントからクエリのデバッグを開始できます。

Cube.devをAIに接続する

FAQ

デバッグプロセスの仕組みについて

  • 01

    AIはCube.devのデータモデルを変更できますか?

    いいえ。AIができるのは既存のモデルを読み取り、それに基づいてSQLを生成することだけです。セマンティックレイヤーの更新は手動で行う必要があります。

  • 02

    AIは自動的にクエリを実行しますか?

    いいえ。エージェントは、あなたがデータの実行や検証を明示的に指示したときにのみクエリを実行します。

  • 03

    実行前にSQLを確認することはできますか?

    はい。実行を許可する前に、生成されたSQLを表示するようエージェントに指示できます。

  • 04

    SQLが無効だった場合はどうなりますか?

    エージェントはCube.devからエラーを受け取ります。そのエラーメッセージを利用して、クエリの修正を試みることが可能です。

  • 05

    AIはデータベース内のデータを削除できますか?

    いいえ。このMCPにはSQLの取得とクエリの実行を行うツールのみが含まれています。データの削除や更新を行うことはできません。

  • Cube.devに関するその他の質問 Cube.dev Connectorの全機能を見る

『Cube.dev』を Claude、Cursor、ChatGPT などに接続