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

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

البنية المعجمية

راجع أيضًا:
[ التسلسل الهرمي لموارد StackQL ] [ الكلمات الأساسية ] [ أنواع البيانات ] [ DESCRIBE ]

تستند البنية المعجمية وقواعد اللغة في StackQL إلى تنفيذ لغة MySQL (وهو تكييف لمعيار ANSI SQL-92) مع بعض الإضافات. تُستخدم جمل StackQL للاستعلام عن الموارد السحابية (باستخدام قواعد SELECT) أو لإنشاء البنية التحتية أو تعديلها أو حذفها باستخدام جمل لغة معالجة البيانات (DML) القياسية مثل INSERT وUPDATE وREPLACE وDELETE. بالإضافة إلى ذلك، تُنفذ العمليات غير التابعة لـ DML، مثل بدء تشغيل مثيل أو الحصول على كائن من حاوية في AWS S3 أو وضعه فيها، كإجراءات موفر مدمجة (على غرار الإجراءات المخزنة في نظام إدارة قواعد البيانات DBMS). تُستدعى إجراءات الموفر المدمجة باستخدام جملة EXEC.

تتيح لغة SQL الخاصة بالمجال في StackQL برمجة البنية التحتية برمجة تصريحية وإجرائية على حد سواء.


بناء الجملة​

تتكون عمليات StackQL من جملة واحدة أو أكثر تنتهي كل منها بفاصلة منقوطة (;). تتضمن الجمل كلمات أساسية ومعرفات ومعلمات وقيمًا، وفيما يلي مثال على جملة StackQL تُستخدم لإنشاء قرص بسعة 10GB في GCP:

INSERT INTO google.compute.disks (project, zone, name, sizeGb)
SELECT 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10;

في المثال أعلاه، تمثل INSERT و INTO و SELECT كلمات أساسية، ويمثل google.compute.disks معرفًا، وتمثل project، zone، name، sizeGb معلمات، وتمثل 'myProject'، 'australia-southeast1-a'، 'my10GbDisk'، 10 قيمًا.

الكلمات الأساسية​

الكلمات الأساسية غير حساسة لحالة الأحرف، أي أن INSERT وinsert تُعاملان بشكل متكافئ، إلا أنها تُكتب غالبًا بأحرف كبيرة وفقًا للعرف المتبع. يمكنك العثور على قائمة كاملة بالكلمات الأساسية في قسم الكلمات الأساسية.

المعرفات​

المعرفات رموز تمثل كائنات في التسلسل الهرمي لموارد مزود الخدمات السحابية. تتكون المعرفات من عدة أجزاء، ويمكنك العثور على مزيد من المعلومات حول المعرفات في موضوع التسلسل الهرمي لموارد StackQL.

المعلمات والقيم​

يحدد المورد المعلمات؛ ويمكنك العثور عليها باستخدام جملة DESCRIBE لمورد معين من موارد مزود الخدمات السحابية. القيم كائنات محددة النوع، عددية أو مركبة، تقابل المعلمات. لمزيد من المعلومات حول المعلمات والقيم، راجع موضوعي DESCRIBE وأنواع البيانات.

المتغيرات​

يلغي المعرف المسبوق بعلامة الدولار، مثل $region، مرجعية متغير جلسة تم تعيينه باستخدام SET؛ ويُستبدل بقيمة المتغير ذات النوع المحدد قبل تخطيط الجملة. أما '$region' بين علامتي اقتباس مفردتين فهو قيمة حرفية نصية. في عبارة FROM، يُحل $variable إلى اسم علاقة، ويُحل IDENTIFIER($variable) إلى اسم عمود في مواضع التعبيرات. والمسار المسبوق بعلامة الدولار بين علامتي اقتباس مزدوجتين، مثل "$.auth.aws.password"، هو هدف تكوين لوقت التشغيل تقبله SET وUNSET. متغيرات الجلسة متاحة في StackQL من الإصدار v1.0 فصاعدًا، راجع متغيرات الجلسة.

العوامل​

|| هو عامل دمج السلاسل النصية، وأسبقيته أعلى من عوامل المقارنة. OR هو الفصل المنطقي. كانت إصدارات StackQL قبل v1.0 تتعامل مع || كوحدة معجمية OR.

التعليقات​

يدعم StackQL التعليقات متعددة الأسطر وتعليقات السطر الواحد داخل جمل StackQL، وفيما يلي أمثلة على التعليقات:

/* This
Is a
Multiline
Comment
*/

--This is an inline comment