翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
run_select_query
對已設定的 Provider 執行 SELECT 陳述式,並傳回結果資料列。唯讀:不接受變更與生命週期作業;這些請使用 run_mutation_query 或 run_lifecycle_operation。
結果資料列會傳回給用戶端,但會刻意排除在稽核記錄之外。
另請參閱:
[ MCP 概觀 ] [ validate_select_query ] [ list_methods ] [ SELECT 語言規格 ]
輸入
| 引數 | 必要 | 描述 |
|---|---|---|
sql | 是 | SELECT 陳述式。中繼資料陳述式(SHOW、DESCRIBE、DESC、EXPLAIN)會被政策閘道歸類為唯讀,因此也會被接受;從 v0.12.732 起的 StackQL 發行版本可辨識 DESC。 |
row_limit | 否 | 傳回給用戶端的資料列數上限。0(預設)表示沒有用戶端側上限。 |
source | 否 | SQL 來自 query_library_get 時的 Query Library 項目 ID。僅用於標示出處;不會改變執行方式或核准。 |
format | 否 | 文字轉譯格式:markdown 或 json。省略時,會使用伺服器的轉譯設定。 |
輸出
| 轉譯器 | 結構 |
|---|---|
| 表格 | {rows: [...]}:每個資料列一個物件,以資料行名稱為鍵 |
管控
當承載中的每個陳述式都是唯讀時,在所有伺服器模式(read_only、safe、delete_safe、full_access)中皆允許。從 v1.0 起,此工具在所有模式(包括 full_access)中都會拒絕 INSERT、UPDATE、REPLACE、DELETE 與 EXEC,並傳回指出 run_mutation_query 或 run_lifecycle_operation 的錯誤。包含多個陳述式的承載會依其中權限最高的陳述式歸類,因此位於開頭 SELECT 之後的變更也會以相同方式遭到拒絕。此工具宣告 destructiveHint: false 與 openWorldHint: true。
範例
請在任何支援徵詢(elicitation)且已註冊 StackQL MCP 伺服器的 MCP 用戶端中試用以下提示詞:
List the VPC networks in my Google Cloud project my-project
and tell me which ones use auto subnet creation.
以下是在 Claude Desktop 中的範例: