تثبيت ClickHouse باستخدام ملفات tgz المضغوطة

تثبيت ClickHouse على MacOS

يُوصى باستخدام أرشيفات tgz الرسمية المجمّعة مسبقًا لجميع توزيعات Linux عندما لا يكون تثبيت حزم deb أو rpm ممكنًا.

1. ​

   راجع التوصيات

   قبل تثبيت ClickHouse، راجع التوصيات التالية:

   • Swap: عطِّل ملف المبادلة الخاص بنظام التشغيل في بيئات الإنتاج.
   • Disk space: يتطلب الملف التنفيذي لـ ClickHouse ما لا يقل عن 2.5 جيجابايت من مساحة القرص لإتمام التثبيت.
   • Network: في عمليات النشر الموزعة (العنقدة)، استخدم اتصال شبكة بسرعة لا تقل عن 10 جيجابت. ويُعد عرض النطاق الترددي للشبكة عاملًا حاسمًا في معالجة الاستعلامات الموزعة التي تتضمن كميات كبيرة من البيانات الوسيطة، وكذلك في النسخ المتماثل.

   تقدير متطلبات التخزين

   لتقدير مساحة القرص المطلوبة لبياناتك:

   1. Estimate data volume: خذ عينة من بياناتك واحسب متوسط حجم الصف، ثم اضربه في عدد الصفوف التي تخطط لتخزينها.
   2. Apply the compression coefficient: حمِّل عينة إلى ClickHouse وقارن بين حجم البيانات الأصلي وحجم الجدول المخزَّن. فعلى سبيل المثال، تُضغط بيانات Clickstream عادةً بمعدل يتراوح بين 6 و10 مرات.
   3. Account for replicas: إذا كنت تخطط لتخزين البيانات في عدة نسخ متماثلة، فاضرب الحجم التقديري في عدد النسخ المتماثلة.

   للاطلاع على متطلبات الأجهزة بمزيد من التفصيل، راجع “توصيات تحديد السعة والأجهزة”

2. ​

   نزّل وثبّت أحدث إصدار مستقر

   يمكن تنزيل الإصدار المطلوب باستخدام curl أو wget من المستودع https://packages.clickhouse.com/tgz/. بعد ذلك، يجب فك ضغط الأرشيفات التي تم تنزيلها وتثبيتها باستخدام البرامج النصية الخاصة بالتثبيت.

   فيما يلي مثال على كيفية تثبيت أحدث إصدار مستقر.

   بالنسبة إلى بيئات production، يُوصى باستخدام أحدث إصدار stable. يمكنك العثور على رقم الإصدار في صفحة GitHub ذات اللاحقة -stable.

3. ​

   احصل على أحدث إصدار من ClickHouse

   احصل على أحدث إصدار من ClickHouse من GitHub وخزّنه في المتغير LATEST_VERSION.

   LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
       grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
   export LATEST_VERSION
   
4. ​

   اكتشف معمارية نظامك

   اكتشف معمارية النظام واضبط المتغير ARCH وفقًا لذلك:

   case $(uname -m) in
     x86_64) ARCH=amd64 ;;         # لمعالجات Intel/AMD ذات 64 بت
     aarch64) ARCH=arm64 ;;        # لمعالجات ARM ذات 64 بت
     *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # اخرج إذا كانت المعمارية غير مدعومة
   esac
   
5. ​

   نزّل ملفات tarball لكل مكوّن من مكوّنات ClickHouse

   نزّل ملفات tarball لكل مكوّن من مكوّنات ClickHouse. تحاول الحلقة تنزيل الحزم الخاصة بالمعمارية أولًا، ثم تلجأ إلى الحزم العامة.

   for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
   do
     curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
       || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
   done
   
6. ​

   استخرج الحزم وثبّتها

   شغّل الأوامر أدناه لاستخراج الحزم التالية وتثبيتها:

   • clickhouse-common-static

   # استخرج حزمة clickhouse-common-static وثبّتها
   tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-common-static-dbg

   # استخرج حزمة رموز التصحيح وثبّتها
   tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-server

   # استخرج حزمة الخادم وثبّتها مع الإعدادات
   tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
   sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
   sudo /etc/init.d/clickhouse-server start  # ابدأ الخادم
   

   • clickhouse-client

   # استخرج حزمة العميل وثبّتها
   tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
   sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"