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

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

exec

أمر يستخدم لتشغيل استعلام StackQL، إما كجملة واحدة أو كدفعة جمل من برنامج نصي بلغة StackQL (ملف IQL).


بناء الجملة​

stackql exec [query] [flags]


الوسيطات​

الوسيطةالوصفمثال
queryاستعلام StackQL المراد إجراؤه
أو الأمر المراد تنفيذه
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
لاحظ أنه يجب وضع الاستعلام بين علامتي اقتباس مفردتين أو مزدوجتين

العلامات​

العلامةالوصف
-o
--output
وضع الإخراج، وتشمل القيم الصالحة: table (افتراضي) وjson وjsonl (JSON مفصول بأسطر جديدة، ويُقبل ndjson كاسم مستعار) وcsv وtext وotel (إدخالات سجل OpenTelemetry، راجع أوضاع الإخراج)، مثال: --output jsonl
-i
--infile
تشغيل الاستعلام من الملف المحدد عند الحاجة، وعند تحديد هذه العلامة يتم تجاهل أي استعلام مقدم كوسيطة، مثال: --infile myquery.iql
-q
--iqldata
بيانات المصدر للأمر باستخدام ملف json أو jsonnet، مثال: --iqldata vars.jsonnet
--dryrunعلامة التشغيل التجريبي؛ يعمل المعالج المسبق فقط ويعاد الإخراج
--varمتغيرات خارجية (من متغيرات البيئة أو الأسرار) تحملها ملفات jsonnet المحددة باستخدام العلامة --iqldata، مثال --var region=${AWS_REGION}
-f
--outfile
الملف الذي تكتب فيه النتائج عند الحاجة (السلوك الافتراضي هو إخراج النتائج إلى وحدة التحكم فقط)، مثال --outfile myoutput.csv
-h
--help
طباعة معلومات التعليمات
-v
--verbose
تشغيل الاستعلامات في الوضع المفصل مع إرسال إخراج إضافي إلى stdout، وإذا تم تحديد الخيار -f فستكتب معلومات التسجيل الإضافية هذه في ملف الإخراج مع نتائج الاستعلام


راجع العلامات العامة للاطلاع على خيارات إضافية


أمثلة​

إخراج نتائج الاستعلام إلى وحدة التحكم بتنسيق جدول:

stackql exec "SHOW services IN google"

إخراج نتائج الاستعلام إلى وحدة التحكم بتنسيق json:

stackql exec "SHOW services IN google" -o json

إخراج نتائج الاستعلام إلى ملف بتنسيق json:

stackql exec "SHOW services IN google" -o json -f services.json

تنفيذ استعلام من ملف إدخال (ملف IQL) وإخراج النتائج إلى ملف بتنسيق json:

stackql exec -i getservices.iql -o json -f services.json

حالة الخروج​

يخرج الأمر exec بالحالة 0 بعد معالجة الإدخال؛ وتكتب الأخطاء الناتجة عن الجمل الفردية إلى وحدة التحكم، لذا يجب أن تفحص البرامج النصية الإخراج. من الإصدار v1.0، يخرج الأمر بالحالة 1 عند فشل جملة تكوين SET أو UNSET، أو عند تمكين إدارة الوصول ورفض جملة، أو عندما يبلغ تشغيل IaC في مرحلة المعاينة عن فشل مورد.