🗄️ تثبيت TimescaleDB — قاعدة بيانات السلاسل الزمنية SQL فائقة الأداء على Docker
نشر محرك TimescaleDB على Ubuntu باستخدام Docker — قاعدة بيانات السلاسل الزمنية (Time-Series) مفتوحة المصدر المبنية على PostgreSQL مع الجداول الفائقة (Hypertables) والضغط العمودي والتجميع الآلي على المنفذ 5432.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/timescaledb/timescaledb-ubuntu.sh
chmod +x timescaledb-ubuntu.sh
sudo bash timescaledb-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/timescaledb/timescaledb-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x timescaledb-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم لقاعدة البيانات (`./timescaledb-data`) وضبط كلمات المرور وتشغيل حاوية TimescaleDB الرسمية على المنفذ 5432.
sudo bash timescaledb-ubuntu.sh
4 الاتصال وإنشاء أول Hypertable
اتصل بقاعدة البيانات عبر المنفذ 5432 باستخدام psql أو DBeaver أو Grafana، وفعل إضافة TimescaleDB (`CREATE EXTENSION IF NOT EXISTS timescaledb;`)، وحول الجداول العادية إلى Hypertables مقسمة تلقائياً، وابدأ استيعاب ملايين السجلات الزمنية.
docker exec -it timescaledb psql -U postgres
# CREATE EXTENSION IF NOT EXISTS timescaledb;
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 5432 | PostgreSQL protocol (apps + Grafana) |
نظرة عامة
تعد TimescaleDB محرك قواعد بيانات سلاسل زمنية مفتوح المصدر وفائق الأداء صُمم كامتداد أصلي فوق قاعدة بيانات PostgreSQL. تعمل المنصة عبر منفذ PostgreSQL القياسي 5432، لتجمع بين القوة والمرونة الكاملة للغة SQL العلائقية (عمليات الربط JOINs، والفهارس الثانوية، والمفاتيح الأجنبية، ودعم بيانات JSONB وPostGIS الجغرافية) مع تقسيم الجداول تلقائياً حسب الوقت في هيئة جداول فائقة (Hypertables). وتقدم أداء استعلامات أسرع بما بين 10 إلى 100 ضعف مقارنة بـ PostgreSQL العادية، مع ضغط عمودي يوفر أكثر من 90% من المساحة، وتجميع فوري مستمر للبيانات.
لماذا تستخدمه
تعاني قواعد البيانات العلائقية التقليدية (مثل PostgreSQL وMySQL) من انهيار في سرعة الاستعلامات والإدخال فور تجاوز الجداول ملايين السجلات الزمنية، بينما تفتقر قواعد بيانات NoSQL الزمنية (مثل InfluxDB وPrometheus) للغة SQL الكاملة والمعاملات المالية وميزات الربط (JOINs). تمنحك TimescaleDB المزيج المثالي: اكتب استعلامات SQL قياسية واربط قراءات الحساسات اللحظية بجداول بيانات أعمالك العادية، بينما تتولى الجداول الفائقة والضغط العمودي معالجة مليارات الصفوف الزمنية بكفاءة مطلقة.
متى تحتاجه
- تحتاج لقاعدة بيانات سلاسل زمنية تدعم لغة SQL القياسية، ومعاملات ACID، وعمليات الربط (JOINs) مع بيانات الأعمال
- تستقبل قراءات حساسات إنترنت الأشياء، أو سجلات مراقبة السيرفرات، أو بيانات أسواق الأسهم والعملات الرقمية بكثافة عالية
- تعاني جداول PostgreSQL لديك من البطء بسبب تضخم البيانات الزمنية وتحتاج لتقسيم الجداول زمنياً تلقائياً (Hypertables)
- تريد توفير أكثر من 90% من مساحة التخزين عبر الضغط العمودي التلقائي للبيانات التاريخية القديمة
- تحتاج إلى تجميع آلي ومستمر للبيانات (مثل المتوسطات اللحظية لكل ساعة أو يوم) دون التسبب في بطء عند تنفيذ الاستعلامات
من يحتاجه
- مهندسو الخلفية ومطورو البرمجيات ومديرو قواعد البيانات (DBAs) لبناء تطبيقات كثيفة البيانات فوق PostgreSQL
- مهندسو إنترنت الأشياء والأنظمة الذكية لاستقبال ومعالجة ملايين قراءات الحساسات في الثانية الواحدة
- مشاريع التكنولوجيا المالية (FinTech) ومنصات التداول لتسجيل حركات الأسعار والشموع اليابانية وأوامر البيع والشراء
- مهندسو الـ DevOps لإدارة وتخزين سجلات مراقبة السيرفرات والشبكات ومؤشرات Prometheus بقاعدة SQL قوية
- أصحاب السيرفرات المنزلية لتخزين بيانات استهلاك الطاقة وحساسات المنزل وعرضها على Grafana
حالات الاستخدام الشائعة
- تخزين وتحليل بيانات استهلاك عدادات الكهرباء الذكية لـ 10,000 مبنى مع تلخيص آلي للقراءات كل 5 دقائق
- استيعاب 50,000 حدث سوقي للعملات الرقمية في الثانية وتوليد مخططات الشموع اليابانية (OHLCV) بلغة SQL
- ضغط جداول مراقبة أداء المعالج والذاكرة لسنتين سابقتين بنسبة 92% بالاعتماد على سياسات الضغط العمودي التلقائية
- دمج بيانات تتبع حركة السيارات بالـ GPS مع جدول بيانات السائقين عبر عمليات ربط SQL JOIN القياسية
- الحذف الآلي لبيانات الحساسات الخام الأقدم من 90 يوماً مع الاحتفاظ الدائم بملخصات المتوسطات لكل ساعة
الميزات الرئيسية
- توافقية كاملة بنسبة 100% مع PostgreSQL: دعم كامل لكافة أدوات ومكتبات الـ ORM (مثل Prisma وTypeORM وSQLAlchemy)
- الجداول الفائقة (Hypertables): تقسيم شفاف للبيانات حسب الوقت والمساحة لتسريع عمليات الإدخال والاستعلام عبر مليارات الصفوف
- ضغط عمودي يوفر أكثر من 90%: دمج مبتكر للبيانات السطرية والعمودية يقلل استهلاك القرص وعمليات القراءة والكتابة (I/O)
- التجميع المستمر (Continuous Aggregates): حساب وحفظ الملخصات الزمنية تلقائياً في الخلفية وتحديثها فورياً مع البيانات الجديدة
- سياسات أتمتة دورة حياة البيانات: قواعد معلنة لضغط البيانات القديمة وحذف الأجزاء المنتهية الصلاحية تلقائياً
- دوال زمنية متطورة: دوال مدمجة قوية مثل `time_bucket()`، و`first()`، و`last()`، ومعالجة الفجوات الزمنية (Gapfilling)
- تكامل أصلي مع Grafana: الاتصال المباشر مع Grafana عبر المنفذ 5432 باستخدام مصدر بيانات PostgreSQL/TimescaleDB المدمج
- معمارية Docker Compose تجمع TimescaleDB مع ربط مجلد `./timescaledb-data` على المنفذ 5432
كيفية الاستخدام بعد التثبيت
- اتصل بقاعدة TimescaleDB عبر أداة psql أو واجهة DBeaver: `psql -h ip-سيرفرك -p 5432 -U postgres -d postgres`
- فعل إضافة TimescaleDB بتنفيذ الأمر: `CREATE EXTENSION IF NOT EXISTS timescaledb;`
- أنشئ جدولاً عادياً يحتوي على عمود زمني، ثم حوّله لجدول فائق: `SELECT create_hypertable('sensor_data', 'time');`
- فعل ميزة الضغط العمودي التلقائي: `ALTER TABLE sensor_data SET (timescaledb.compress);`
- اربط لوحات Grafana أو تطبيقك البرمجي بالرابط `ip-سيرفرك:5432` باستخدام بيانات قاعدة البيانات
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات `./timescaledb-data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: عيّن كلمة مرور قوية ومعقدة لمتغير `POSTGRES_PASSWORD` في ملف `.env` قبل تشغيل الحاوية
- اقصر الاتصال بالمنفذ 5432 على سيرفرات التطبيقات الموثوقة بالشبكة الداخلية (`ufw allow from 192.168.1.0/24`)
- لا تكشف منفذ PostgreSQL 5432 للإنترنت العام مباشرة دون حماية
- أنشئ حسابات مستخدمين مخصصة ومحدودة الصلاحيات لتطبيقاتك وتجنب استخدام حساب المشرف `postgres` في الأكواد
- احمِ مجلد البيانات `./timescaledb-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات محرك PostgreSQL
المنافذ وإعدادات جدار الحماية
تتواصل قاعدة TimescaleDB عبر منفذ TCP 5432 القياسي لـ PostgreSQL. اسمح بالمنفذ 5432 للشبكة المحلية الموثوقة (`ufw allow 5432/tcp`). وإذا كنت تتصل بالسيرفر عبر الإنترنت، استخدم شبكة VPN مشفرة (مثل WireGuard أو Tailscale) أو فعل تشفير SSL الإجباري (`sslmode=require`) واقصر الدخول على عناوين IP المعتمدة فقط.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./timescaledb-data` احتياطياً، والذي يحتوي على كامل عنقود قاعدة بيانات PostgreSQL
- استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec timescaledb pg_dump -U postgres postgres > timescaledb_backup.sql`
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة باستيراد ملفات الـ SQL في حاوية تجريبية والتأكد من عمل الـ Hypertables وسياسات الضغط
الأخطاء الشائعة
- استخدام كلمات مرور افتراضية أو ضعيفة لحساب المشرف `postgres` على سيرفر متصل بالشبكة
- إنشاء جداول عادية ونسيان تنفيذ أمر `create_hypertable()` مما يفقدك كافة الميزات والسرعة الفائقة لـ TimescaleDB
- عدم ربط مجلد التخزين الدائم `./timescaledb-data`، مما يسبب فقدان كامل بيانات الجداول عند تحديث الحاوية
- ضبط فترات تقسيم الجداول الزمنية (Chunk Intervals) بشكل غير مناسب (قصيرة جداً كدقيقة واحدة أو طويلة جداً كسنة)
- كشف المنفذ 5432 للإنترنت العام مباشرة دون تقييد عناوين الـ IP المسموح لها بالاتصال
استكشاف الأخطاء وإصلاحها
- بطء استعلامات الجداول الضخمة — تأكد من تحويل الجدول لـ Hypertable وتأكد من وجود فهارس على عمود الوقت ومعرّف الجهاز
- رفض الاتصال بالمنفذ 5432 — تأكد من عمل الحاوية بالأمر `docker compose ps` وراجع صلاحيات الاتصال بملف `pg_hba.conf`
- فشل إقلاع الحاوية — افحص سجلات الحاوية بالأمر: `docker logs timescaledb -f`
- امتلاء مساحة القرص الصلب — فعل سياسات الضغط التلقائي: `SELECT add_compression_policy('sensor_data', INTERVAL '7 days');`
- أخطاء نفاد الذاكرة — استخدم أداة `timescaledb-tune` لضبط متغيرات `shared_buffers` و`work_mem` لتناسب حجم RAM السيرفر
البدائل
قاعدة بيانات InfluxDB المخصصة للسلاسل الزمنية. محرك ClickHouse العمودي للتحليلات الكبرى. منظومة Prometheus وVictoriaMetrics لمراقبة البنية التحتية. محرك QuestDB السريع بـ SQL. محرك PostgreSQL العادي بدون إضافات.
متى لا تستخدمه
تجنب استخدام TimescaleDB إذا كنت تبحث فقط عن كاش مؤقت بسيط للقيم (حيث تعد Redis أفضل) أو قاعدة مستندات NoSQL بدون أبعاد زمنية (مثل MongoDB). وإذا كنت تحتاج فقط لجمع مؤشرات سيرفرات Kubernetes والتنبيهات بدون استعلامات SQL، فإن Prometheus أو VictoriaMetrics مخصصة لذلك.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي TimescaleDB وكيف تختلف عن PostgreSQL العادية؟
TimescaleDB إضافة مفتوحة المصدر لقاعدة بيانات PostgreSQL. تعمل وتتعامل تماماً مثل PostgreSQL (تدعم نفس لغة SQL وكافة الأدوات)، ولكنها تضيف ميزة التقسيم الزمني التلقائي للجداول (Hypertables)، والضغط العمودي بنسبة 90%+، والتجميع المستمر، مما يرفع سرعة الاستعلامات الزمنية بمعدل 10 إلى 100 ضعف.
ما هو الجدول الفائق (Hypertable) في TimescaleDB؟
الجدول الفائق (Hypertable) طبقة تجريدية تظهر لتطبيقك كجدول SQL عادي وموحد، بينما يقوم المحرك تلقائياً بتقسيم البيانات وتوزيعها خلف الكواليس إلى أجزاء صغيرة حسب الوقت والمساحة لضمان أقصى سرعة إدخال وبحث.
كيف تعمل ميزة الضغط العمودي في TimescaleDB؟
يقوم TimescaleDB بتحويل أجزاء الجداول التاريخية القديمة من التخزين السطري التقليدي إلى التخزين العمودي فائق الكفاءة باستخدام خوارزميات ضغط متطورة، مما يوفر أكثر من 90% من المساحة مع إمكانية الاستعلام عن البيانات المضغوطة بلغة SQL بشكل طبيعي.
هل يمكن ربط TimescaleDB بلوحات Grafana؟
نعم! تتضمن Grafana مصدراً مدمجاً لقواعد PostgreSQL/TimescaleDB يدعم دوال الماكرو الزمنية مثل `$__timeGroupAlias()` لتصميم لوحات مراقبة بيانية تفاعلية في الوقت الفعلي.
كم تحتاج TimescaleDB من الذاكرة العشوائية (RAM)؟
يمكن لـ TimescaleDB العمل بذاكرة تبدأ من 512 ميجابايت لمشاريع الحساسات الصغيرة، ولكن يوصى بتخصيص 2 إلى 4 جيجابايت أو أكثر لبيئات الإنتاج ذات الإدخال الكثيف والاستعلامات التحليلية الكبيرة.
