إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

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 يدعم elicitation ومسجل فيه خادم StackQL MCP:

List the VPC networks in my Google Cloud project my-project
and tell me which ones use auto subnet creation.

إليك مثالًا في Claude Desktop: