跳至主要內容
翻譯頁面

本頁面由英文在 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 中的範例: