كيفية قراءة رسم تخطيطي لبناء الجملة

ينطبق على: التحقق من Databricks SQL Databricks Runtime

يصف هذا القسم الأنماط المختلفة لبناء الجملة المستخدمة في مرجع SQL.

المكونات الأساسية

• الكلمه الاساسيه
• الرمز المميز
• شرط
• الوسيطه

الكلمه الاساسيه

SELECT

يتم دائما كتابة الكلمات الأساسية في SQL بأحرف كبيرة في هذا المستند، ولكنها غير حساسة لحالة الأحرف.

الرمز المميز

( )
<  >
.
*
,

تتضمن لغة SQL أقواسا دائرية ((، )) بالإضافة إلى أقواس بزاوية (<، >ونقاط (.)، وفواصل (,)، وعدد قليل من الأحرف الأخرى. عندما تكون هذه الأحرف موجودة في رسم تخطيطي لبناء الجملة، يجب إدخالها كما هي.

شرط

LIMIT clause

SELECT named_expression

named_expression
  expression AS alias

تمثل عبارة قسما فرعيا مسمى من بناء الجملة. يتم وصف عبارة محلية في نفس الرسم التخطيطي لبناء الجملة الذي يستدعيها. إذا كانت العبارة شائعة، فإنها ترتبط بقسم آخر من مرجع Databricks SQL. تعرف بعض العبارات من قبلها الرئيسية keyword ويتم تصويرها بكلمة أساسية كبيرة متبوعة بجملة . العبارات الأخرى هي دائما حالة أقل وتستخدم التسطير السفلي (_) عند الاقتضاء. يتم شرح العبارات المحلية بالكامل في القسم التالي. تحتوي جميع العبارات الأخرى على وصف مختصر مع ارتباط إلى الصفحة الرئيسية.

الوسيطه

mapExpr

يتم تحديد وسيطات الدالات في camelCase. يصف Databricks SQL معنى الوسيطات في قسم الوسيطات.

سلسلة الرموز المميزة

SELECT expr

يجب إدخال المكونات المفصولة بمسافة بيضاء بالترتيب، دون قيد أو شرط، وأن يتم فصلها فقط عن طريق المسافة البيضاء أو التعليقات. يدعم Databricks SQL تعليقات النموذج /* ... */ (نمط C)، و -- ...، الذي يمتد إلى نهاية السطر.

اختيار

تحديد نسخة المستودع في بناء الجملة.

الاختيار الإلزامي

{ INT | INTEGER }

تعني الأقواس المتعرجة { ... } أنه يجب عليك تحديد أحد المكونات المتعددة بالضبط. يتم فصل كل خيار ب |.

اختيار اختياري

[ ASC | DESC ]

تشير الأقواس المربعة [ ... ] إلى أنه يمكنك اختيار أحد المكونات المتعددة على الأكثر. يتم فصل كل خيار ب |.

تجميع

{ SELECT expr }

{ SELECT
 expr }

تحدد الأقواس المتعرجة { ... } أنه يجب توفير جميع المكونات المضمنة. إذا كان رسم تخطيطي لبناء الجملة يمتد عبر أسطر متعددة، يوضح هذا النموذج أنه يصور نفس بناء الجملة.

الخيار

[ NOT NULL ]

تحدد الأقواس [...] المربعة أن المكونات المغلقة اختيارية.

تكرار

col_option [...]

col_alias [, ...]

{ expr [ AS ] col_alias } [, ...]

[...] يشير رمز علامة الحذف إلى أنه يمكنك تكرار المكون السابق مباشرة أو التجميع أو الاختيار عدة مرات. إذا كانت علامة الحذف مسبوقة بحرف آخر، مثل نقطة [. ...]مفصولة أو فاصلة [, ...]، فيجب فصل كل تكرار بهذا الحرف.