مقتطفات الاستعلام
غالبا ما يكون تكرار العمل السابق وتعديله أسهل من كتابة شيء ما من البداية. ينطبق هذا بشكل خاص على العبارات الشائعة 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}
إنشاء قصاصات استعلام
استخدم الخطوات التالية لإنشاء القصاصات البرمجية باستخدام أمثلة القصاصة البرمجية هذه:
انقر فوق اسم المستخدم في الشريط العلوي لمساحة العمل وحدد الإعدادات من القائمة المنسدلة.
انقر فوق علامة التبويب المطور.
إلى جانب قصاصات استعلام SQL، انقر فوق إدارة.
انقر فوق إنشاء مقتطف استعلام.
في الحقل استبدال ، أدخل اسم القصاصة البرمجية. ستستخدم هذا الاسم عند كتابة استعلام يستخدم القصاصة البرمجية.
أدخل وصفا اختياريا.
في حقل القصاصة البرمجية، أدخل القصاصة البرمجية.
انقر فوق Create.
استخدام مقتطف استعلام في استعلام
فيما يلي مثال على استعلام بسيط يمكنك باستخدامه استخدام أجزاء الاستعلام هذه:
--Simple query
SELECT * FROM samples.nyctaxi.trips
استخدم الخطوات التالية لاستخدام مقتطف استعلام مع هذا الاستعلام:
افتح محرر SQL.
اكتب الاستعلام في جزء استعلام محرر SQL.
اكتب الأحرف الثلاثة الأولى من اسم القصاصة البرمجية ثم حدد قصاصة برمجية من نافذة الإكمال التلقائي. يمكنك أيضا فتح النافذة يدويا عن طريق الضغط على
Option
+Space
القصاصة البرمجية وتحديدها.تنفيذ الاستعلام باستخدام
WHERE
عبارة من مقتطف الاستعلام.
العمل مع نقاط الإدراج في أجزاء الاستعلام
يمكنك تعيين نقاط الإدراج عن طريق التفاف ترتيب علامة تبويب عدد صحيح بعلامة دولار واحدة وأقواس متعرجة ${}
. العنصر النائب للنص يسبقه نقطتان :
اختياري ولكنه مفيد للمستخدمين غير معتادين على القصاصة البرمجية الخاصة بك. في مقتطفات الاستعلام مع نقاط الإدراج التي قمت بإنشائها مسبقا، ${1:value}
هي نقطة إدراج مع عنصر نائب وهي ${1:100}
نقطة إدراج بقيمة افتراضية للعن العنصر النائب الذي يمكنك تجاوزه في وقت التشغيل. عندما يعرض Databricks SQL القصاصة البرمجية، يتم تجريد علامة $
الدولار والأقواس {}
المتعرجة ويتم تمييز الكلمة value
أو الافتراضي 100
للاستبدال.
عندما تكون هناك نقاط إدراج متعددة، ينتقل قيراط إدراج النص إلى نقطة الإدراج الأولى لمطالبة القيمة المطلوبة. عند الضغط Tab
على ، ينتقل القيراط إلى نقطة الإدراج التالية للقيمة التالية. عند الضغط Tab
مرة أخرى، سينتقل القيراط إلى خط نقطة الإدراج التالي حتى يصل إلى نقطة الإدراج النهائية.
إشعار
نقطة الإدراج من الصفر ${0}
هي دائما النقطة الأخيرة في ترتيب الجدولة.
استخدم الخطوات التالية لاستخدام قصاصات استعلام نقطة الإدراج مع الاستعلام:
افتح محرر SQL.
اكتب الاستعلام في جزء استعلام محرر SQL.
اكتب الأحرف الثلاثة الأولى من اسم مقتطف الاستعلام ثم حدد مقتطف استعلام بنقطة الإدراج بدون قيمة افتراضية.
تتم إضافة مقتطف الاستعلام إلى الاستعلام وينتقل قصاصة إدخال النص إلى نقطة الإدراج.
أدخل قيمة العبارة
WHERE
، مثل200
.اختياريا، قم بتنفيذ الاستعلام باستخدام
WHERE
عبارة من مقتطف الاستعلام.كرر الخطوات السابقة ولكن حدد مقتطف الاستعلام مع نقطة الإدراج باستخدام قيمة افتراضية.
كرر الخطوات السابقة ولكن حدد مقتطف الاستعلام مع نقاط إدراج متعددة.
أدخل قيمة لنقطة الإدراج الأولى، ثم انتقل إلى نقطة الإدراج التالية وأدخل قيمة، ثم انتقل إلى نقطة الإدراج النهائية وأدخل قيمة.