مقتطفات الاستعلام

غالبا ما يكون تكرار العمل السابق وتعديله أسهل من كتابة شيء ما من البداية. ينطبق هذا بشكل خاص على العبارات الشائعة JOIN أو التعبيرات المعقدة CASE . مع نمو قائمة الاستعلامات، قد يكون من الصعب تذكر الاستعلامات التي تحتوي على العبارة التي تحتاجها. يمكنك أيضا إنشاء مقتطف استعلام يحتوي على نقطة إدراج مع نص نائب يمكن للمستخدم استبداله في وقت التشغيل.

أجزاء الاستعلام هي مقاطع من الاستعلامات التي يمكنك مشاركتها وتشغيلها باستخدام الإكمال التلقائي. استخدم أجزاء الاستعلام ل:

• عبارات متكررة JOIN
• عبارات معقدة مثل WITH أو CASE.
• تنسيق شرطي

فيما يلي أمثلة على القصاصات البرمجية:

--Simple snippet
WHERE fare_amount > 100

--Snippet with an insertion point for a value to be provided at runtime
WHERE fare_amount > ${1:value}

--Snippet with an insertion point for a value to be provided at runtime and containing a default value
WHERE fare_amount > ${1:100}

--Snippet with multiple insertion points
WHERE fare_amount > ${2:min_value} AND fare_amount < ${1:max_value} AND trip_distance < ${0:max_distance}

إنشاء قصاصات استعلام

استخدم الخطوات التالية لإنشاء القصاصات البرمجية باستخدام أمثلة القصاصة البرمجية هذه:

1. انقر فوق اسم المستخدم في الشريط العلوي لمساحة العمل وحدد المستخدم الإعدادات من القائمة المنسدلة.

2. انقر فوق علامة التبويب المطور.

3. إلى جانب قصاصات استعلام SQL، انقر فوق إدارة.

4. انقر فوق إنشاء مقتطف استعلام.

5. في الحقل استبدال ، أدخل اسم القصاصة البرمجية. ستستخدم هذا الاسم عند كتابة استعلام يستخدم القصاصة البرمجية.

6. أدخل وصفا اختياريا.

7. في حقل القصاصة البرمجية، أدخل القصاصة البرمجية.

8. انقر فوق إنشاء.

   

استخدام مقتطف استعلام في استعلام

فيما يلي مثال على استعلام بسيط يمكنك باستخدامه استخدام أجزاء الاستعلام هذه:

--Simple query
SELECT * FROM samples.nyctaxi.trips

استخدم الخطوات التالية لاستخدام مقتطف استعلام مع هذا الاستعلام:

1. افتح محرر SQL.

2. اكتب الاستعلام في جزء استعلام محرر SQL.

3. اكتب الأحرف الثلاثة الأولى من اسم القصاصة البرمجية ثم حدد قصاصة برمجية من نافذة الإكمال التلقائي. يمكنك أيضا فتح النافذة يدويا عن طريق الضغط على Option + Space القصاصة البرمجية وتحديدها.

   

4. تنفيذ الاستعلام باستخدام WHERE عبارة من مقتطف الاستعلام.

   

العمل مع نقاط الإدراج في أجزاء الاستعلام

يمكنك تعيين نقاط الإدراج عن طريق التفاف ترتيب علامة تبويب عدد صحيح بعلامة دولار واحدة وأقواس متعرجة ${}. العنصر النائب للنص يسبقه نقطتان :اختياري ولكنه مفيد للمستخدمين غير معتادين على القصاصة البرمجية الخاصة بك. في مقتطفات الاستعلام مع نقاط الإدراج التي قمت بإنشائها مسبقا، ${1:value} هي نقطة إدراج مع عنصر نائب وهي ${1:100} نقطة إدراج بقيمة افتراضية للعن العنصر النائب الذي يمكنك تجاوزه في وقت التشغيل. عندما يعرض Databricks SQL القصاصة البرمجية، يتم تجريد علامة $ الدولار والأقواس {} المتعرجة ويتم تمييز الكلمة value أو الافتراضي 100 للاستبدال.

عندما تكون هناك نقاط إدراج متعددة، ينتقل قيراط إدراج النص إلى نقطة الإدراج الأولى لمطالبة القيمة المطلوبة. عند الضغط Tabعلى ، ينتقل القيراط إلى نقطة الإدراج التالية للقيمة التالية. عند الضغط Tab مرة أخرى، سينتقل القيراط إلى خط نقطة الإدراج التالي حتى يصل إلى نقطة الإدراج النهائية.

إشعار

نقطة الإدراج من الصفر ${0} هي دائما النقطة الأخيرة في ترتيب الجدولة.

استخدم الخطوات التالية لاستخدام قصاصات استعلام نقطة الإدراج مع الاستعلام:

1. افتح محرر SQL.

2. اكتب الاستعلام في جزء استعلام محرر SQL.

3. اكتب الأحرف الثلاثة الأولى من اسم مقتطف الاستعلام ثم حدد مقتطف استعلام بنقطة الإدراج بدون قيمة افتراضية.

   تتم إضافة مقتطف الاستعلام إلى الاستعلام وينتقل قصاصة إدخال النص إلى نقطة الإدراج.

   

4. أدخل قيمة العبارة WHERE ، مثل 200.

5. اختياريا، قم بتنفيذ الاستعلام باستخدام WHERE عبارة من مقتطف الاستعلام.

6. كرر الخطوات السابقة ولكن حدد مقتطف الاستعلام مع نقطة الإدراج باستخدام قيمة افتراضية.

   

7. كرر الخطوات السابقة ولكن حدد مقتطف الاستعلام مع نقاط إدراج متعددة.

   

8. أدخل قيمة لنقطة الإدراج الأولى، ثم انتقل إلى نقطة الإدراج التالية وأدخل قيمة، ثم انتقل إلى نقطة الإدراج النهائية وأدخل قيمة.