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

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime

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

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

كلمة أساسية

SELECT

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

الرمز المميز

( )
<  >
.
*
,

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

Clause

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 } [, ...]

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