تُعد SQL Console أسرع وأسهل طريقة لاستكشاف قواعد بياناتك وتنفيذ الاستعلامات عليها في ClickHouse Cloud. يمكنك استخدام SQL Console من أجل:
- الاتصال بخدمات ClickHouse Cloud الخاصة بك
- عرض بيانات الجداول وتصفيتها وفرزها
- تنفيذ الاستعلامات وتصور بيانات النتائج ببضع نقرات فقط
- مشاركة الاستعلامات مع أعضاء الفريق والتعاون بفعالية أكبر.
عرض قائمة الجداول ومعلومات المخطط
إنشاء استعلام من عوامل التصفية وخيارات الفرز
عوامل التصفية وخيارات الفرز ليست مطلوبة عند استخدام ميزة ‘Create Query’.
- انقر على زر ’+” في شريط علامات التبويب
- حدِّد زر ‘New Query’ من قائمة الاستعلامات في الشريط الجانبي الأيسر
لتشغيل استعلام، اكتب أمر SQL أو الأوامر داخل SQL Editor وانقر على زر ‘Run’ أو استخدم الاختصار cmd / ctrl + enter. ولكتابة عدة أوامر وتشغيلها بالتسلسل، تأكد من إضافة فاصلة منقوطة بعد كل أمر.
خيارات تنفيذ الاستعلام
افتراضيًا، سيؤدي النقر على زر ‘Run’ إلى تشغيل جميع الأوامر الموجودة في SQL Editor. يدعم SQL Console خيارين آخرين لتنفيذ الاستعلام:
- تشغيل الأوامر المحددة
- تشغيل الأمر عند المؤشر
لتشغيل الأوامر المحددة، ظلّل الأمر المطلوب أو مجموعة الأوامر المطلوبة ثم انقر على زر ‘Run’ (أو استخدم الاختصار cmd / ctrl + enter). ويمكنك أيضًا اختيار ‘Run selected’ من القائمة السياقية في SQL Editor (التي تُفتح بالنقر بزر الماوس الأيمن في أي مكان داخل المحرر) عند وجود تحديد.
يمكن تشغيل الأمر عند موضع المؤشر الحالي بطريقتين:
- اختر ‘At Cursor’ من قائمة خيارات التشغيل الموسعة (أو استخدم اختصار لوحة المفاتيح المقابل
cmd / ctrl + shift + enter
- اختر ‘Run at cursor’ من القائمة السياقية في SQL Editor
سيومض الأمر الموجود عند موضع المؤشر باللون الأصفر عند تنفيذه.
Esc لإلغاء الاستعلام. ملاحظة: ستظل أي نتائج أُعيدت بالفعل متاحة بعد الإلغاء.
إذا لم يكن الاستعلام قد سُمّي مسبقًا، فسيكون اسمه “Untitled Query”. انقر على اسم الاستعلام لتغييره. تؤدي إعادة تسمية الاستعلام إلى حفظه.
يمكنك أيضًا استخدام زر الحفظ أو اختصار لوحة المفاتيح cmd / ctrl + s لحفظ الاستعلام.
استخدام GenAI لإدارة الاستعلامات
-
افتح خدمة ClickHouse Cloud.
-
أنشئ استعلامًا جديدًا بالنقر على أيقونة +.
-
الصق الشيفرة التالية ثم شغّلها:
CREATE TABLE uk_price_paid
(
price UInt32,
date Date,
postcode1 LowCardinality(String),
postcode2 LowCardinality(String),
type Enum8('terraced' = 1, 'semi-detached' = 2, 'detached' = 3, 'flat' = 4, 'other' = 0),
is_new UInt8,
duration Enum8('freehold' = 1, 'leasehold' = 2, 'unknown' = 0),
addr1 String,
addr2 String,
street LowCardinality(String),
locality LowCardinality(String),
town LowCardinality(String),
district LowCardinality(String),
county LowCardinality(String)
)
ENGINE = MergeTree
ORDER BY (postcode1, postcode2, addr1, addr2);
uk_price_paid.
-
أنشئ استعلامًا جديدًا والصق الاستعلام التالي:
INSERT INTO uk_price_paid
WITH
splitByChar(' ', postcode) AS p
SELECT
toUInt32(price_string) AS price,
parseDateTimeBestEffortUS(time) AS date,
p[1] AS postcode1,
p[2] AS postcode2,
transform(a, ['T', 'S', 'D', 'F', 'O'], ['terraced', 'semi-detached', 'detached', 'flat', 'other']) AS type,
b = 'Y' AS is_new,
transform(c, ['F', 'L', 'U'], ['freehold', 'leasehold', 'unknown']) AS duration,
addr1,
addr2,
street,
locality,
town,
district,
county
FROM url(
'http://prod.publicdata.landregistry.gov.uk.s3-website-eu-west-1.amazonaws.com/pp-complete.csv',
'CSV',
'uuid_string String,
price_string String,
time String,
postcode String,
a String,
b String,
c String,
addr1 String,
addr2 String,
street String,
locality String,
town String,
district String,
county String,
d String,
e String'
) SETTINGS max_http_get_redirects=10;
يستورد هذا الاستعلام مجموعة البيانات من موقع gov.uk. يبلغ حجم هذا الملف حوالي 4GB، لذا سيستغرق اكتمال هذا الاستعلام بضع دقائق. وبعد أن ينتهي ClickHouse من معالجة الاستعلام، ينبغي أن تكون مجموعة البيانات كاملة داخل جدول uk_price_paid.
لننشئ استعلامًا باستخدام اللغة الطبيعية.
-
حدِّد الجدول uk_price_paid، ثم انقر على Create Query.
-
انقر على Generate SQL. قد يُطلب منك الموافقة على إرسال استعلاماتك إلى Chat-GPT. يجب أن تحدد I agree للمتابعة.
-
يمكنك الآن استخدام هذا الـ prompt لإدخال استعلام باللغة الطبيعية وجعل ChatGPT يحوّله إلى استعلام SQL. في هذا المثال، سندخل:
اعرض لي إجمالي السعر وإجمالي عدد جميع معاملات uk_price_paid حسب السنة.
-
سيُنشئ Console الاستعلام المطلوب ويعرضه في علامة تبويب جديدة. في مثالنا، أنشأ GenAI الاستعلام التالي:
-- اعرض لي إجمالي السعر وإجمالي عدد جميع معاملات uk_price_paid حسب السنة.
SELECT year(date), sum(price) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
بعد التأكد من صحة الاستعلام، انقر على Run لتنفيذه.
الآن، لنختبر إمكانات تصحيح أخطاء الاستعلامات في GenAI.
-
أنشئ استعلامًا جديدًا بالنقر على أيقونة + ثم الصق الشيفرة التالية:
-- اعرض لي إجمالي السعر وإجمالي عدد جميع معاملات uk_price_paid حسب السنة.
SELECT year(date), sum(pricee) as total_price, Count(*) as total_transactions
FROM uk_price_paid
GROUP BY year(date)
-
انقر على Run. سيفشل الاستعلام لأننا نحاول جلب قيم من
pricee بدلًا من price.
-
انقر على Fix Query.
-
سيحاول GenAI إصلاح الاستعلام. في هذه الحالة، غيّر
pricee إلى price. كما أدرك أن toYear دالة أفضل للاستخدام في هذا السيناريو.
-
حدِّد Apply لإضافة التغييرات المقترحة إلى استعلامك، ثم انقر على Run.
ضع في اعتبارك أن GenAI ميزة تجريبية. توخَّ الحذر عند تشغيل الاستعلامات التي ينشئها GenAI على أي مجموعة بيانات.
بعد تنفيذ الاستعلام، يمكنك البحث بسرعة في مجموعة النتائج المُعادة باستخدام حقل البحث في جزء النتائج. تساعد هذه الميزة في معاينة نتائج عبارة WHERE إضافية، أو ببساطة التحقق من أن بيانات محددة مُضمَّنة في مجموعة النتائج. بعد إدخال قيمة في حقل البحث، سيُحدَّث جزء النتائج ويعرض السجلات التي تحتوي على قيمة تطابق القيمة المُدخلة. في هذا المثال، سنبحث عن جميع حالات breakfast في جدول hackernews ضمن التعليقات التي تحتوي على ClickHouse (دون تمييز حالة الأحرف):
ملاحظة: سيُعاد أي سجل يطابق فيه أي حقل القيمة المُدخلة. على سبيل المثال، السجل الثالث في لقطة الشاشة أعلاه لا يطابق ‘breakfast’ في الحقل by، لكن الحقل text يطابقها:
بشكل افتراضي، تعرض جزء النتائج جميع سجلات النتائج في صفحة واحدة. وبالنسبة إلى مجموعات النتائج الأكبر، قد يكون من الأفضل تقسيم النتائج على صفحات لتسهيل عرضها. ويمكن إجراء ذلك باستخدام مُحدِّد ترقيم الصفحات في الزاوية السفلية اليمنى من جزء النتائج:
سيؤدي تحديد حجم الصفحة إلى تطبيق ترقيم الصفحات فورًا على مجموعة النتائج، وستظهر خيارات التنقل في منتصف تذييل جزء النتائج
تصدير بيانات نتائج الاستعلام
••• في الجانب الأيمن من شريط أدوات جزء النتائج، ثم اختر ‘تنزيل بتنسيق CSV’.
يمكن فهم بعض البيانات بسهولة أكبر عند عرضها في صورة مخطط. يمكنك إنشاء تصورات بسرعة من بيانات نتيجة الاستعلام مباشرةً من SQL Console ببضع نقرات فقط. على سبيل المثال، سنستخدم استعلامًا يحسب الإحصاءات الأسبوعية لرحلات سيارات الأجرة في NYC:
SELECT
toStartOfWeek(pickup_datetime) AS week,
sum(total_amount) AS fare_total,
sum(trip_distance) AS distance_total,
count(*) AS trip_total
FROM
nyc_taxi
GROUP BY
1
ORDER BY
1 ASC
trip_total حسب week. ولتنفيذ ذلك، سنسحب الحقل week إلى المحور السيني، والحقل trip_total إلى المحور الصادي:
تدعم معظم أنواع المخططات إضافة عدة حقول إلى المحاور الرقمية. وللتوضيح، سنسحب الحقل fare_total إلى المحور الصادي:
يدعم SQL Console عشرة أنواع من المخططات يمكن اختيارها من محدد نوع المخطط في لوحة إعدادات المخطط. على سبيل المثال، يمكننا بسهولة تغيير نوع المخطط السابق من مخطط أعمدة إلى مخطط مساحي:
تتوافق عناوين المخططات مع اسم الاستعلام الذي يوفّر البيانات. وسيؤدي تحديث اسم الاستعلام إلى تحديث عنوان المخطط أيضًا:
يمكن أيضًا ضبط عدد من خصائص المخطط الأكثر تقدمًا في قسم ‘Advanced’ من لوحة إعدادات المخطط. وللبدء، سنضبط الإعدادات التالية:
- العنوان الفرعي
- عناوين المحاور
- اتجاه التسميات على المحور السيني
سيُحدَّث مخططنا وفقًا لذلك:
في بعض الحالات، قد يكون من الضروري ضبط مقياس كل محور لكل حقل على حدة. ويمكن أيضًا تنفيذ ذلك في قسم ‘Advanced’ من لوحة إعدادات المخطط، وذلك بتحديد القيمتين الصغرى والكبرى لنطاق المحور. على سبيل المثال، يبدو المخطط أعلاه جيدًا، ولكن لتوضيح الارتباط بين الحقلين trip_total وfare_total، تحتاج نطاقات المحاور إلى بعض الضبط:
يُمكّنك SQL Console من مشاركة الاستعلامات مع فريقك. وعند مشاركة استعلام، يمكن لجميع أعضاء الفريق رؤيته وتحريره. وتُعد الاستعلامات المشتركة وسيلة فعّالة للتعاون مع فريقك.
لمشاركة استعلام، انقر على الزر ‘Share’ في شريط أدوات الاستعلام.
سيفتح مربع حوار يتيح لك مشاركة الاستعلام مع جميع أعضاء الفريق. وإذا كان لديك عدة فرق، يمكنك اختيار الفريق الذي تريد مشاركة الاستعلام معه.
في بعض الحالات، قد يكون من الضروري ضبط مقاييس المحاور لكل حقل بشكل مستقل. ويمكن أيضًا تنفيذ ذلك من قسم ‘Advanced’ في لوحة إعدادات المخطط، وذلك بتحديد قيمتي الحد الأدنى والحد الأقصى لنطاق المحور. على سبيل المثال، يبدو المخطط أعلاه جيدًا، ولكن لتوضيح الارتباط بين الحقلين trip_total وfare_total، تحتاج نطاقات المحاور إلى بعض الضبط:
