الدوال المعرّفة من قبل المستخدم في Cloud

أنشئ ملفًا جديدًا باسم main.py على جهازك المحلي:

cat > main.py << 'EOF'
import sys
from datetime import datetime

for line in sys.stdin:
    ts = datetime.fromisoformat(line.strip())
    result = 1 if (0 <= ts.weekday() <= 4 and 9 <= ts.hour <= 17) else 0
    print(result)
    sys.stdout.flush()
EOF

إذا كان سكربت بايثون لديك يستورد حزمًا تابعة لجهات خارجية، فأدرجها في ملف requirements.txt وسيتولى ClickHouse Cloud تثبيتها لك. ويمكنك بدلًا من ذلك تضمين التبعيات مباشرةً في ملف ZIP، لكن عندئذٍ يجب تضمين الحزم المخزنة مؤقتًا لكلتا معماريتَي CPU، لذا يُعد requirements.txt الخيار الأبسط. على سبيل المثال:

requests>=2.28.0
numpy>=1.23.0

لتضمين حزم التبعيات وأي ملفات محلية إضافية (مثل ملفات wheel أو ملفات الإعداد أو ملفات البيانات)، ضعها في المجلد نفسه إلى جانب main.py وrequirements.txt. عند إنشاء أرشيف ZIP، ضمّن جميع الملفات:

zip is_business_hours.zip main.py requirements.txt

يمكنك الإشارة إلى الدليل الأساسي للمسار المحلي المضمَّن في شيفرة بايثون الخاصة بك باستخدام os.path.dirname(os.path.abspath(__file__)). يُرجع هذا التعبير المسار المطلق إلى الدليل الذي يوجد فيه ملف main.py داخل أرشيف ZIP، مما يتيح لك الوصول إلى الملفات المضمَّنة الأخرى:

import os

# Get the base directory of the bundled files
base_dir = os.path.dirname(os.path.abspath(__file__))
config_path = os.path.join(base_dir, 'config.json')

يكون ذلك مفيدًا عندما تحتاج إلى:

• الوصول إلى ملفات التهيئة المضمّنة مع UDF الخاصة بك
• تحميل حزم wheel للتبعيات المخصّصة
• الإشارة إلى نصوص برمجية إضافية أو ملفات بيانات

الآن قم بضغط الملف في أرشيف ZIP:

zip is_business_hours.zip main.py

1. من الصفحة الرئيسية لـ Cloud Console، انقر على اسم مؤسستك في القائمة السفلية اليسرى.
2. اختر الدوال المعرّفة من قبل المستخدم من القائمة.
3. في صفحة الدوال المعرّفة من قبل المستخدم، انقر على Set up a UDF. ستُفتح لوحة إعدادات على الجانب الأيمن من الشاشة.
4. أدخل اسمًا للدالة. في هذا المثال، استخدم isBusinessHours.
5. اختر نوع الدالة: إما Executable pool أو Executable:
   • Executable pool: يُحفَظ pool من العمليات المستمرة، وتُؤخَذ منه عملية لتنفيذ reads.
   • Executable: يُشغَّل السكربت مع كل query.
6. في هذا المثال، استخدم الإعدادات الافتراضية. للاطلاع على القائمة الكاملة لمعلمات الإعداد، راجع الدوال المعرّفة من قبل المستخدم التنفيذية.
7. انقر على Browse File لتحميل ملف .zip الذي أُنشئ في بداية هذا الدليل.
8. أضف argument جديدًا. في هذا المثال، أضف argument باسم timestamp من النوع DateTime.
9. اختر return type. في هذا المثال، اختر Bool.
10. انقر على Create UDF. سيعرض مربع حوار حالة build الحالية.
    • إذا كانت هناك أي مشكلات، فستتغير الحالة إلى error.
    • بخلاف ذلك، ستنتقل الحالة من building إلى provisioning. يجب أن تكون الخدمة في حالة تشغيل لإكمال provisioning. إذا كانت الخدمة في حالة idle، فانقر على Wake Up Service في لوحة UDF details بجوار اسم الخدمة.
    • عند اكتمال العملية، ستتغير الحالة إلى deployed.

1. ارجع إلى الصفحة الرئيسية في SQL Console بالنقر على Settings - return to your service view من الزاوية العلوية اليسرى للصفحة
2. انقر على SQL Console في القائمة الجانبية اليسرى
3. اكتب الاستعلام التالي:

SELECT isBusinessHours('2026-03-20 10:00:00'::DateTime), isBusinessHours('2026-03-20 23:00:00'::DateTime);

من المفترض أن تظهر لك النتيجة:

true    false

لتغيير شيفرة UDF، أنشئ إصدارًا جديدًا. لا تُستخدم لوحة Edit إلا لإدارة الخدمات المُسنَدة إلى UDF؛ ولن يؤدي رفع ملف من خلالها إلى استبدال الشيفرة المنشورة.

1. من الصفحة الرئيسية في Cloud Console، انقر على اسم مؤسستك في القائمة السفلية اليسرى.
2. اختر الدوال المعرّفة من قبل المستخدم من القائمة.
3. انقر على النقاط الثلاث ضمن الإجراءات الخاصة بـ UDF ‏isBusinessHours، ثم انقر على إنشاء إصدار جديد
4. ارفع ملف zip يتضمن الشيفرة المعدّلة، أو غيّر الإعدادات ثم انقر على إنشاء إصدار جديد

لقد أضفت بنجاح أول دالة معرّفة من قبل المستخدم عبر UI، وتحققت من أنها تعمل، ورأيت كيفية إنشاء إصدار جديد لها عند الحاجة.