التطوير على ClickHouse باستخدام Moose OLAP

Moose OLAP هي وحدة أساسية من Moose Stack، وهي مجموعة أدوات مفتوحة المصدر للمطورين لبناء أنظمة خلفية تحليلية في الوقت الفعلي باستخدام TypeScript وبايثون. توفّر Moose OLAP طبقات تجريد ملائمة للمطورين ووظائف شبيهة بـ ORM، وهي مبنية خصيصًا لـ ClickHouse.

الميزات الرئيسية لـ Moose OLAP

المخططات كشيفرة: عرّف جداول ClickHouse الخاصة بك في TypeScript أو بايثون مع أمان الأنواع وإكمال تلقائي في بيئة التطوير المتكاملة
استعلامات آمنة نوعيًا: اكتب استعلامات SQL مع التحقق من الأنواع ودعم الإكمال التلقائي
التطوير المحلي: طوّر واختبر على مثيلات ClickHouse المحلية من دون التأثير على بيئة الإنتاج
إدارة الترحيلات: تتبّع تغييرات المخطط عبر التحكم في الإصدارات وأدِر الترحيلات من خلال الشيفرة
البث في الوقت الفعلي: دعم مدمج لربط ClickHouse مع Kafka أو Redpanda من أجل الاستيعاب المتدفق
واجهات برمجة تطبيقات REST: أنشئ بسهولة واجهات برمجة تطبيقات REST موثقة بالكامل فوق جداول ClickHouse والعروض الخاصة بك

البدء خلال أقل من 5 دقائق

للاطلاع على أحدث وأفضل أدلة التثبيت والبدء، راجع وثائق Moose Stack. أو اتبع هذا الدليل لبدء استخدام Moose OLAP على نشر حالي لـ ClickHouse أو ClickHouse Cloud خلال أقل من 5 دقائق.

المتطلبات المسبقة

Node.js 20+ أو بايثون 3.12+ - مطلوب لتطوير TypeScript أو بايثون
Docker Desktop - لبيئة التطوير المحلية
macOS/Linux - يعمل Windows عبر WSL2

تثبيت Moose

ثبّت Moose CLI على مستوى النظام:

bash -i <(curl -fsSL https://fiveonefour.com/install.sh) moose

إعداد مشروعك

الخيار A: استخدم عملية نشر ClickHouse الحالية لديك

مهم: سيظل ClickHouse الإنتاجي لديك دون أي تغيير. سيؤدي هذا فقط إلى تهيئة مشروع Moose OLAP جديد مع نماذج بيانات مشتقة من جداول ClickHouse لديك.

# TypeScript
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language typescript

# Python
moose init my-project --from-remote <YOUR_CLICKHOUSE_CONNECTION_STRING> --language python

يجب أن تكون سلسلة اتصال ClickHouse بهذا التنسيق:

https://username:password@host:port/?database=database_name

الخيار B: استخدم ClickHouse Playground

أليس لديك ClickHouse قيد التشغيل بعد؟ استخدم ClickHouse Playground لتجربة Moose OLAP!

# TypeScript
moose init my-project --from-remote https://explorer:@play.clickhouse.com:443/?database=default --language typescript

# Python
moose init my-project --from-remote https://explorer:@play.clickhouse.com:443/?database=default --language python

تثبيت التبعيات

# TypeScript
cd my-project
npm install

# Python
cd my-project
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

يجب أن ترى: Successfully generated X models from ClickHouse tables

استعرض النماذج التي تم إنشاؤها

يُنشئ Moose CLI تلقائيًا واجهات TypeScript أو نماذج Python Pydantic من جداول ClickHouse الحالية لديك.ألقِ نظرة على نماذج البيانات الجديدة في الملف app/index.ts.

ابدأ التطوير

شغّل خادم التطوير لتشغيل مثيل ClickHouse محلي، مع إعادة إنشاء جميع جداول الإنتاج تلقائيًا من تعريفات الشيفرة لديك:

moose dev

مهم: سيظل ClickHouse الإنتاجي لديك دون أي تغيير. يؤدي هذا إلى إنشاء بيئة تطوير محلية.

املأ قاعدة بياناتك المحلية ببيانات أولية

حمّل بياناتك إلى مثيل ClickHouse المحلي لديك:

من ClickHouse الخاص بك

moose seed --connection-string <YOUR_CLICKHOUSE_CONNECTION_STRING> --limit 100

من ClickHouse Playground

moose seed --connection-string https://explorer:@play.clickhouse.com:443/?database=default --limit 100

البناء باستخدام Moose OLAP

الآن بعد أن أصبحت جداولك معرّفة في الشيفرة، ستحصل على المزايا نفسها التي توفرها نماذج بيانات ORM في تطبيقات الويب — أمان الأنواع والإكمال التلقائي عند بناء واجهات برمجة التطبيقات والعروض المادية فوق بياناتك التحليلية. وكخطوة تالية، يمكنك تجربة:

بناء واجهة برمجة تطبيقات REST باستخدام Moose API
استيعاب البيانات أو تحويلها باستخدام Moose Workflows أو Moose Streaming
استكشاف الانتقال إلى بيئة الإنتاج باستخدام Moose Build وMoose Migrate

احصل على المساعدة وابقَ على تواصل

التطبيق المرجعي: اطّلع على التطبيق المرجعي مفتوح المصدر Area Code: وهو مستودع انطلاق يضم جميع اللبنات الأساسية اللازمة لبناء تطبيق غني بالميزات وجاهز لبيئات المؤسسات ويتطلب بنية تحتية متخصصة. يوجد تطبيقان نموذجيان: تحليلات موجهة للمستخدمين ومستودع بيانات تشغيلي.
مجتمع Slack: تواصل مع المشرفين على Moose Stack على Slack للحصول على الدعم وتقديم الملاحظات
شاهد الشروحات: شروحات فيديو وعروض توضيحية ومحتوى متعمق حول ميزات Moose Stack على Youtube
ساهم: اطّلع على الشيفرة، وساهم في Moose Stack، وأبلغ عن المشكلات على GitHub

​الميزات الرئيسية لـ Moose OLAP

​البدء خلال أقل من 5 دقائق

​المتطلبات المسبقة

​الخيار A: استخدم عملية نشر ClickHouse الحالية لديك

​الخيار B: استخدم ClickHouse Playground

​من ClickHouse الخاص بك

​من ClickHouse Playground

​احصل على المساعدة وابقَ على تواصل