تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
exec
أمر يستخدم لتشغيل استعلام StackQL، إما كجملة واحدة أو كدفعة جمل من برنامج نصي بلغة StackQL (ملف IQL).
بناء الجملة
stackql exec [query] [flags]
الوسيطات
| الوسيطة | الوصف | مثال |
|---|---|---|
query | استعلام StackQL المراد إجراؤه أو الأمر المراد تنفيذه | "SELECT * FROM google.compute.instancesWHERE 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 في مرحلة المعاينة عن فشل مورد.