Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
run_select_query
Виконує інструкцію SELECT для налаштованих провайдерів і повертає рядки результату. Лише читання - інструмент не приймає змінення даних та операції життєвого циклу; для них використовуйте run_mutation_query або run_lifecycle_operation.
Інструмент повертає рядки результату клієнтові, але навмисно не записує їх у журнал аудиту.
Див. також:
[ Огляд MCP ] [ validate_select_query ] [ list_methods ] [ SELECT у специфікації мови ]
Вхідні дані
| Аргумент | Обов'язковий | Опис |
|---|---|---|
sql | Так | Інструкція SELECT. Механізм контролю політик класифікує інструкції метаданих (SHOW, DESCRIBE, DESC, EXPLAIN) як інструкції лише для читання, тож інструмент приймає і їх; DESC розпізнається в StackQL v0.12.732 і новіших версіях. |
row_limit | Ні | Обмеження кількості рядків, які повертаються клієнтові. 0 (за замовчуванням) означає відсутність обмеження на боці клієнта. |
source | Ні | Ідентифікатор запису Query Library, якщо SQL отримано за допомогою query_library_get. Лише для атрибуції; не впливає на виконання та схвалення. |
format | Ні | Формат текстового відображення: markdown або json. Якщо аргумент не вказано, сервер використовує власне налаштування відображення. |
Вихідні дані
| Засіб відображення | Форма |
|---|---|
| Таблиця | {rows: [...]} - один об'єкт на кожен рядок з іменами стовпців як ключами |
Контроль
Дозволено в усіх режимах сервера (read_only, safe, delete_safe, full_access), якщо кожна інструкція в корисному навантаженні призначена лише для читання. Починаючи з v1.0, цей інструмент відхиляє INSERT, UPDATE, REPLACE, DELETE та EXEC в усіх режимах, зокрема в режимі full_access, з помилкою, яка називає run_mutation_query або run_lifecycle_operation. Корисне навантаження з кількома інструкціями класифікується за інструкцією з найвищими привілеями, тому змінення даних після початкової інструкції SELECT відхиляється так само. Інструмент оголошує destructiveHint: false і openWorldHint: true.
Приклад
Спробуйте цей промпт у будь-якому клієнті MCP, у якому зареєстровано сервер MCP StackQL:
List the VPC networks in my Google Cloud project my-project
and tell me which ones use auto subnet creation.
Ось приклад у Claude Desktop: