DESCRIBE MCP SERVER¶
MCP (モデルコンテキストプロトコル)サーバーのプロパティを記述します。
DESCRIBE は DESC に短縮できます。
- こちらもご参照ください。
構文¶
{ DESC | DESCRIBE } MCP SERVER <name>
パラメーター¶
name記述する MCP サーバーの識別子を指定します。
識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
詳細については、 識別子の要件 をご参照ください。
出力¶
コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。
列 |
説明 |
|---|---|
|
MCP サーバーの名前。 |
|
MCP サーバーを含むデータベース。 |
|
MCP サーバーを含むスキーマ。 |
|
MCP サーバーを所有するロール。 |
|
MCP サーバーのコメント。 |
|
ツール構成を含む MCP サーバー仕様の JSON 表現。 |
|
MCP サーバーが作成された日時。 |
アクセス制御の要件¶
この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
|---|---|
USAGE 、 MODIFY 、または OWNERSHIP |
MCP Server |
スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
このコマンドの出力を後処理するには、 パイプ演算子 (
->>)または RESULT_SCAN 関数。どちらのコンストラクトも、出力を クエリできる結果セットとして扱います。たとえば、パイプ演算子または RESULT_SCAN 関数を使用して、 SHOW コマンド出力から特定の列を選択したり、行をフィルター処理したりできます。
出力列を参照する場合は、列名に 二重引用符で囲まれた識別子 を使用します。たとえば、出力列
typeを選択するには、SELECT "type"を指定します。SHOW コマンドの出力列名は小文字のため、二重引用符で囲まれた識別子を使用する必要があります。二重引用符により、 SELECT リストまたは WHERE 句内の列名が、スキャンされた SHOW コマンド出力内の列名と一致することが保証されます。
server_spec列には、 MCP サーバーが作成され、 JSON としてシリアル化されたときに提供された完全な YAML 仕様が含まれます。
例¶
次の例は、 my_mcp_server という名前の MCP サーバーについて記述しています。
DESCRIBE MCP SERVER my_mcp_server;
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+
| name | database_name | schema_name | owner | comment | server_spec | created_on |
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+
| MY_MCP_SERVER | TEST_DATABASE | TEST_SCHEMA | ACCOUNTADMIN | [NULL] | {"version":1,"tools":[{"name":"product-search","identifier":"db.schema.search_service","type":"CORTEX_SEARCH_SERVICE_QUERY"}]} | Fri, 23 Jun 1967 07:00:00.123000 +0000 |
+-----------------+---------------+-------------+--------------+---------+--------------------------------------------------------------------------------------------------------------------------------+----------------------------------------+