Reference

FAQ

このFAQは、Dory のオンボーディング、データベースのセットアップ、AI SQL の生成、MCP エージェントのアクセス、およびセルフホスト型展開中に発生する一般的な質問に答えます。

ドリーとは何ですか?

Dory は、データベースの接続、スキーマの探索、SQL の作成、AI による分析の生成、再利用可能なクエリの保存、および MCP 対応エージェントによる制御されたデータベース コンテキストの提供を行う AI ネイティブの SQL ワークスペースです。

Dory はどのデータベースをサポートしていますか?

Dory のドキュメントでは、ClickHouse、PostgreSQL、Neon、MySQL、MariaDB、SQL Server、Oracle、SQLite、DuckDB、MotherDuck、および互換性のある接続エンドポイントを公開するその他のホストされたデータベースについて説明します。ドライバー固有のガイダンスについては、データベース サポート を参照してください。

Dory は私の BI ツールに代わるものですか?

Dory は、SQL 探索、アドホック分析、AI 支援クエリ、保存されたクエリの再利用、エージェント ワークフローに最も優れています。特に調査やダッシュボードのプロトタイピングの際に、BI ツールを補完できます。

Dory は AI が生成した SQL を自動的に実行しますか?

いいえ、AI 出力をドラフトとして扱います。生成された SQL を実行する前に、特に結合、フィルター、時間枠、集計ロジックを確認してください。

AI はどのようにしてスキーマ コンテキストにアクセスするのでしょうか?

Dory は、接続メタデータ、テーブル、列、選択したクエリ コンテキストを使用して、SQL を生成できます。 AI SQL の品質は、選択したモデル、スキーマの明確さ、テーブル名、コメント、および提供するプロンプトによって異なります。

なぜ AI は無効な SQL を生成したのでしょうか?

一般的な原因としては、あいまいなテーブル名、スキーマ コンテキストの欠落、方言の違い、モデルの制限、またはターゲット データベースを示していないプロンプトが挙げられます。データベースの種類を述べて、PostgreSQL、ClickHouse、MySQL、MariaDB、SQL Server、Oracle、SQLite、または DuckDB の構文を適応させるよう Dory に依頼します。

テーブルが表示されないのはなぜですか?

次の項目を確認してください。

  • データベースユーザーはスキーマを読み取る権限を持っています。
  • 正しい接続とデータベースを選択しました。
  • テーブルが別のスキーマまたはカタログにあります。
  • 新しいテーブルが作成された後、接続が更新されました。
  • ネットワーク ルールにより、ドリーはデータベースにアクセスできます。

クエリが遅いのはなぜですか?

遅いクエリは通常、大規模なスキャン、フィルターの欠落、インデックスの欠落、高価な結合、または高カーディナリティのグループ化によって発生します。時間枠を追加し、選択する列を減らし、探索中にLIMIT を使用し、可能な場合はデータベース実行計画を検査します。

保存されたクエリはどこに保存されますか?

保存されたクエリは Dory に保存され、現在の組織、ユーザー、接続、およびフォルダー構造に関連付けられます。チームメイトが理解して再利用できるように、明確な名前とフォルダーを使用します。

保存したクエリをチームメイトと共有できますか?

Dory ワークスペースと権限により、チームメイトが同じ組織と接続にアクセスできる場合は、はい。保存されたクエリは、チームメイトもデータベースにアクセスできる場合にのみ役立ちます。

MCP はデータベースのパスワードを公開しますか?

いいえ、MCP ツールは、制御されたメタデータと読み取り/分析操作を公開します。データベースのパスワードや接続シークレットは返されません。クライアントごとに 1 つの MCP トークンを使用し、不要になった古いトークンを取り消します。

MCP エージェントはデータベースに書き込むことができますか?

Dory MCP は、読み取り専用の SQL 実行用に設計されています。データベースのアクセス許可が最終的な安全境界であるため、本番接続には読み取り専用のデータベース資格情報を使用する必要があります。

Docker デプロイメントが SQLite または DuckDB ファイルに接続できないのはなぜですか?

コンテナーはファイル パスを認識できる必要があります。データベース ファイルを含むホスト ディレクトリをマウントし、コンテナ内から見えるパスを使用して Dory を構成します。

ログイン リンクまたはリダイレクトが間違ったホストを指しているのはなぜですか?

デプロイメント用に構成されたパブリック・アプリケーションURLを確認してください。プロトコルとホスト名を含め、ブラウザーで開いているURLユーザーと一致する必要があります。

AI プロバイダーはどのように選択すればよいですか?

組織によってすでに承認されているプロバイダーから始めます。標準パスが必要な場合は、Open AI を使用してください。組織が互換性のあるエンドポイントを使用している場合は、Open AI 互換を使用してください。 AI プロバイダー を参照してください。

本番データを接続する前に何をすべきですか?

  • 読み取り専用のデータベース ユーザーを使用します。
  • Dory へのネットワーク アクセスを制限します。
  • SSLの要件を確認します。
  • 小さなクエリ制限から始めます。
  • 実行前に AI が生成した SQL を確認します。
  • 外部エージェント クライアントごとに個別の MCP トークンを作成します。

このガイドは役に立ちましたか?