# exec

> يشغل الأمر stackql exec جملة StackQL واحدة أو برنامجًا نصيًا من الجمل، مع علامات لتنسيق الإخراج والمصادقة وسجل الموفرين.

Source: https://stackql.io/ar/command-line-usage/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، راجع [أوضاع الإخراج](/getting-started/output-modes#otel-output))، مثال: `--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` فستكتب معلومات التسجيل الإضافية هذه في ملف الإخراج مع نتائج الاستعلام|

> راجع [العلامات العامة](/command-line-usage/global-flags) للاطلاع على خيارات إضافية

* * *

### أمثلة

إخراج نتائج الاستعلام إلى وحدة التحكم بتنسيق جدول:
```shell
stackql exec "SHOW services IN google"
```

إخراج نتائج الاستعلام إلى وحدة التحكم بتنسيق json:
```shell
stackql exec "SHOW services IN google" -o json
```

إخراج نتائج الاستعلام إلى ملف بتنسيق json:
```shell
stackql exec "SHOW services IN google" -o json -f services.json
```

تنفيذ استعلام من ملف إدخال (ملف IQL) وإخراج النتائج إلى ملف بتنسيق json:
```shell
stackql exec -i getservices.iql -o json -f services.json
```

* * *

### حالة الخروج

يخرج الأمر `exec` بالحالة `0` بعد معالجة الإدخال؛ وتكتب الأخطاء الناتجة عن الجمل الفردية إلى وحدة التحكم، لذا يجب أن تفحص البرامج النصية الإخراج.  من الإصدار `v1.0`، يخرج الأمر بالحالة `1` عند فشل جملة تكوين [`SET`](/language-spec/set) أو [`UNSET`](/language-spec/unset)، أو عند تمكين [إدارة الوصول](/command-line-usage/access-management) ورفض جملة، أو عندما يبلغ تشغيل IaC في مرحلة المعاينة عن فشل مورد.
