> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> دليل خطوة بخطوة لإنشاء أول Kafka ClickPipe.
# إنشاء أول Kafka ClickPipe
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> في هذا الدليل، سنأخذك خطوة بخطوة خلال عملية إنشاء أول Kafka ClickPipe.
يمكن Deploy لـ Kafka ClickPipes وإدارتها يدويًا باستخدام ClickPipes UI، أو برمجيًا باستخدام [OpenAPI](/docs/ar/integrations/clickpipes/programmatic-access/openapi) و[Terraform](/docs/ar/integrations/clickpipes/programmatic-access/terraform).
اختر زر `Data Sources` من القائمة الجانبية اليسرى، ثم انقر على "Set up a ClickPipe".
اختر مصدر بيانات Kafka من القائمة.
املأ النموذج بإدخال اسم لـ ClickPipe، ووصف (اختياري)، وبيانات الاعتماد، وتفاصيل الاتصال الأخرى.
يلزم وجود schema صالح لموضوعات Avro وProtobuf. راجع [Schema registries](/docs/ar/integrations/clickpipes/kafka/schema-registries) لمزيد من التفاصيل حول كيفية تهيئة schema registry.
قم بتكوين Reverse Private Endpoint للسماح لـ ClickPipes بالاتصال بعنقود Kafka لديك عبر AWS PrivateLink.
راجع [وثائق AWS PrivateLink](/docs/ar/integrations/clickpipes/aws-privatelink) لمزيد من المعلومات.
يمكنك استخدام نفق SSH إذا كان وسيط Kafka لديك غير متاح عبر الإنترنت العام. وبدلًا من الاتصال المباشر، ينشئ ClickPipes اتصال SSH إلى مضيف Bastion (وهو خادم في شبكتك متاح عبر الإنترنت العام)، ثم يمرّر الحركة من خلاله إلى وسيط Kafka على شبكتك الخاصة.
1. فعّل زر التبديل "SSH Tunnel".
2. أدخل تفاصيل اتصال SSH:
* **SSH Host**: اسم المضيف أو عنوان IP الخاص بمضيف Bastion — وهو الخادم المتاح عبر الإنترنت العام الذي يعمل كبوابة إلى شبكتك الخاصة.
* **SSH Port**: المنفذ المستخدَم لـ SSH على مضيف Bastion (الافتراضي هو `22`).
* **SSH User**: اسم المستخدم المستخدم للمصادقة على مضيف Bastion.
3. لاستخدام المصادقة المستندة إلى المفتاح، انقر على "Revoke and regenerate key pair" لإنشاء زوج مفاتيح جديد، ثم انسخ المفتاح العام الذي تم إنشاؤه إلى خادم SSH لديك ضمن `~/.ssh/authorized_keys`.
4. انقر على "Verify Connection" للتحقق من الاتصال.
تأكد من السماح لـ [ClickPipes IP addresses](/docs/ar/integrations/clickpipes/home#list-of-static-ips) في قواعد جدار الحماية الخاصة بمضيف SSH Bastion حتى يتمكن ClickPipes من إنشاء نفق SSH.
حدّد الموضوع، وستعرض واجهة المستخدم مستندًا نموذجيًا منه.
في الخطوة التالية، يمكنك تحديد ما إذا كنت تريد إدخال البيانات إلى جدول ClickHouse جديد أو إعادة استخدام جدول حالي. اتبع الإرشادات المعروضة على الشاشة لتعديل اسم الجدول وبنيته وإعداداته. ويمكنك رؤية معاينة فورية لتغييراتك في جدول العينة بالأعلى.
يمكنك أيضًا تخصيص الإعدادات المتقدمة باستخدام عناصر التحكم المتاحة
سينشئ ClickPipes مستخدمًا مخصصًا لكتابة البيانات إلى جدول الوجهة. يمكنك اختيار دور لهذا المستخدم الداخلي باستخدام دور مخصص أو أحد الأدوار المحددة مسبقًا:
* `Full access`: يمنح وصولًا كاملًا إلى العنقود. قد يكون ذلك مفيدًا إذا كنت تستخدم Materialized View أو Dictionary مع جدول الوجهة.
* `Only destination table`: يمنح أذونات `INSERT` على جدول الوجهة فقط.
سيؤدي النقر على "Create ClickPipe" إلى إنشاء ClickPipe وتشغيله. وسيظهر الآن ضمن قسم مصادر البيانات.