Skip to main content
جميع أدلة البدء السريع
التحليلات اللحظيةمستودعات البياناتObservabilityAI/MLCloud

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

يجب أيضًا أن تكون قد أكملت أدلة البدء السريع التالية:

ما ستبنيه

في هذا الدليل السريع، ستستخدم clickhouse-client — عميل ClickHouse CLI الرسمي — لإدخال بيانات من ملف CSV محلي إلى خدمة ClickHouse Cloud. ستثبّت clickhouse-client، وتُحضّر مجموعة بيانات تجريبية، وتتصل بخدمة Cloud الخاصة بك، وتنشئ جدولًا، ثم تُدخل البيانات من جهازك المحلي. وفي نهاية هذا الدليل، ستعرف كيفية استخدام clickhouse-client لتحميل الملفات المحلية إلى ClickHouse Cloud، وهو سير عمل يدعم CSV وParquet وJSON والعديد من التنسيقات الأخرى.
1

تثبيت clickhouse-client

يُعد clickhouse-client واجهة CLI الرسمية للاتصال بـ ClickHouse، وهو مُضمَّن في الملف التنفيذي لـ ClickHouse.ثبّته باستخدام المُثبّت العام:
سيؤدي هذا إلى تنزيل أحدث ملف تنفيذي clickhouse إلى الدليل الحالي. تحقّق من التثبيت:
من المفترض أن يظهر لك ناتج يعرض رقم إصدار ClickHouse، مما يؤكد أن clickhouse-client جاهز للاستخدام.
2

جهّز ملف CSV نموذجيًا صغيرًا

أنشئ ملف CSV نموذجيًا صغيرًا حتى يكون هذا الدليل التمهيدي السريع مكتفيًا بذاته. شغّل ما يلي في الطرفية:
3

اتصل بخدمة Cloud الخاصة بك

تفترض الأوامر أدناه أنك صدّرت CLICKHOUSE_HOST وCLICKHOUSE_USER وCLICKHOUSE_PASSWORD كمتغيرات بيئة، كما هو موضح في الدليل السريع الحصول على تفاصيل اتصال Cloud الخاصة بك. وإذا لم تكن قد فعلت ذلك، فيمكنك استبدالها بقيمك مباشرةً.اختبر الاتصال من خلال تشغيل استعلام بسيط على خدمة Cloud الخاصة بك:
إذا نجح الاتصال، فسترى القيمة 1 مطبوعة في الطرفية. وإذا ظهر خطأ في الاتصال، فتحقّق من أن خدمتك تعمل في Cloud Console وأن اسم المضيف وكلمة المرور صحيحان.
المنفذ 9440 هو منفذ native protocol الآمن في ClickHouse Cloud. ويؤدي الخيار --secure إلى تفعيل تشفير TLS. وهذان مطلوبان لجميع اتصالات Cloud.
4

أنشئ جدولًا مستهدفًا وأدرج البيانات

أولًا، أنشئ جدولًا على خدمة Cloud لديك لاستقبال البيانات:
الآن أدخِل البيانات من ملف CSV المحلي لديك. هذه هي الخطوة الأساسية - يقرأ clickhouse-client الملف من stdin ويُرسله كتدفّق إلى الخدمة البعيدة:
يرسل clickhouse-client محتويات ملف CSV مباشرةً إلى خدمة Cloud الخاصة بك. ويُخبر تنسيق CSVWithNames ClickHouse بأن الصف الأول يحتوي على أسماء الأعمدة.
5

تحقّق من أنه تم إدراج البيانات

نفّذ استعلامًا على خدمة Cloud الخاصة بك للتأكد من وصول الصفوف:
ينبغي أن يظهر لك 10، وهو عدد الصفوف في ملف CSV التجريبي.عاين البيانات:
يعمل سير العمل نفسه مع Parquet وTSV وJSON وAvro وORC والعديد من التنسيقات المدعومة الأخرى - ما عليك سوى تغيير بند FORMAT وتمرير الملف المناسب.

الخطوات التالية

في هذا الدليل السريع، ثبّت clickhouse-client، ووصلته بخدمة ClickHouse Cloud، واستخدمته لتمرير البيانات من ملف CSV محلي إلى Cloud. وتعمل هذه الطريقة نفسها مع Parquet وJSON وعشرات التنسيقات الأخرى. اطّلع بعد ذلك على أدلة البدء السريع التالية: أو تعمّق أكثر من خلال الوثائق المرجعية:
ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level

Check out the ClickHouse academy for on-demand and live training

Last modified on July 2, 2026