Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

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: