事前作成およびカスタム・ツール
データベース・ツールのMCPツールセットについて学習します。
次の表に、データベース・ツールのMCPツールセット・タイプ、ツールが事前作成済かカスタムか、特定のツール名、およびそれらを使用するために必要なデフォルトの許可ロールの概要を示します。
表5-1ツールセット
| ツールセット・タイプ | ツール・タイプ | ツール名 | 摘要 | デフォルト許可ロール |
|---|---|---|---|---|
| カスタムSQL | カスタム | カスタマイズされたツール名 | このツールは、定義する場合に使用します。 | MCP_オペレータ |
| 組込みSQL | 事前ビルド | SQL実行 |
接続されているOracleデータベースでSQL問合せを実行します。アクティブな接続が存在しない場合、ユーザーは接続を確立するように求められます。問合せ結果はCSV形式で返されます。 |
MCP_オペレータMCP_管理者 |
| スキーマ_情報 | 実行された問合せから収集されたメタデータを調査および拡張することで、データベース・スキーマに関する詳細なインサイトを生成します。 | MCP_ユーザー MCP_オペレータMCP_管理者 | ||
| request_status | 現在のステータスを取得し、使用可能な場合は、以前に送信された非同期ツール・コールの最終結果を取得します。このツールは、別のツールが最終結果ではなくtoolRequestIdを返す場合に使用します。このツールをtoolRequestIdとともにコールして、リクエストが完了するまでポーリングします。考えられる結果は次のとおりです。
|
MCP_ユーザー MCP_オペレータMCP_管理者 | ||
| カスタマイズ可能なレポートツール | 事前ビルド |
レポート_リスト |
このツールを使用して、存在するレポートを検出し、そのメタデータ(レポートID (SQLレポートのID)、表示名、説明、目的および使用手順など)を取得します。report_executeまたはreport_sqlをコールする場合、返されるreportId値が必要です。 | MCP_ユーザー MCP_オペレータMCP_管理者 |
|
report_execute |
実行するレポートのreportIdを、必要な変数値とともに指定します。レポートで定義された変数のプレースホルダは、実行時に指定された引数に置き換えられます。結果セットはCSV形式のコンテンツとして返されるため、プログラムによる消費やユーザーへの表示が容易になります。このツールをコールする前に、report_listを使用して正しいreportIdを識別します。 |
MCP_ユーザー MCP_オペレータMCP_管理者 | ||
| レポート_sql |
このツールは、レポートで使用されるSQLを検査、理解またはカスタマイズする必要がある場合に使用します。戻されたSQLは、report_executeを使用して直接変更および実行できます。このツールには、report_listから取得できる有効なreportIdが必要です。 |
MCP_オペレータ | ||
| 生成AI SQL Assistant | 事前ビルド | dbtools_translate_natural_language_query_to_sql | このツールを使用して、自然言語問合せを検証済のSQL文に変換します。 | MCP_ユーザー MCP_オペレータMCP_管理者 |