> ## 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.

> استخدام ClickHouse Connector Sink مع Kafka Connect وClickHouse

# تكامل منصة Confluent Platform مع ClickHouse

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<div class="vimeo-container">
  <Frame>
    <iframe
      src="//www.youtube.com/embed/SQAiPVbd3gg"
      frameborder="0"
      allow="autoplay;
fullscreen;
picture-in-picture"
      allowfullscreen
    />
  </Frame>
</div>

<div id="prerequisites">
  ## المتطلبات المسبقة
</div>

نفترض أن لديك دراية بـ:

* [ClickHouse Connector Sink](/docs/ar/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Platform و[Custom Connectors](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/overview.html).

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-platform">
  ## الموصل الرسمي لـ Kafka من ClickHouse مع Confluent Platform
</div>

<div id="installing-on-confluent-platform">
  ### التثبيت على Confluent Platform
</div>

هذا دليل سريع لمساعدتك على البدء باستخدام ClickHouse Sink Connector على Confluent Platform.
لمزيد من التفاصيل، يُرجى الرجوع إلى [وثائق Confluent الرسمية](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-qs.html#uploading-and-launching-the-connector).

<div id="create-a-topic">
  #### إنشاء Topic
</div>

يُعدّ إنشاء Topic على Confluent Platform أمرًا بسيطًا نسبيًا، وتتوفر إرشادات مفصلة [هنا](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html).

<div id="important-notes">
  #### ملاحظات مهمة
</div>

* يجب أن يتطابق اسم Kafka topic مع اسم جدول ClickHouse. ويمكن تعديل ذلك باستخدام مُحوِّل (على سبيل المثال [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* لا يعني وجود المزيد من الأقسام دائمًا أداءً أفضل — راجع دليلنا القادم لمزيد من التفاصيل ونصائح تحسين الأداء.

<div id="install-connector">
  #### تثبيت الموصّل
</div>

يمكنك تنزيل الموصّل من [المستودع](https://github.com/ClickHouse/clickhouse-kafka-connect/releases) — ولا تتردد أيضًا في إرسال التعليقات والمشكلات هناك!

انتقل إلى "Connector Plugins" -> "Add plugin"، ثم استخدم الإعدادات التالية:

```text theme={null}
'Connector Class' - 'com.clickhouse.kafka.connect.ClickHouseSinkConnector'
'Connector type' - Sink
'Sensitive properties' - 'password'. This will ensure entries of the ClickHouse password are masked during configuration.
```

مثال:

<Image img="https://mintcdn.com/private-7c7dfe99/pIetLsS_hOGHqoPJ/images/integrations/data-ingestion/kafka/confluent/AddCustomConnectorPlugin.webp?fit=max&auto=format&n=pIetLsS_hOGHqoPJ&q=85&s=5fdb90da6ed384d7e4560bce54acf8ee" size="md" alt="واجهة Confluent Platform تعرض إعدادات إضافة موصل ClickHouse مخصّص" border width="552" height="850" data-path="images/integrations/data-ingestion/kafka/confluent/AddCustomConnectorPlugin.webp" />

<div id="gather-your-connection-details">
  #### اجمع بيانات الاتصال الخاصة بك
</div>

للاتصال بـ ClickHouse باستخدام HTTP(S)، تحتاج إلى المعلومات التالية:

| المعلمات                  | الوصف                                                                                         |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | عادةً ما يكون المنفذ 8443 عند استخدام TLS، أو 8123 عند عدم استخدام TLS.                       |
| `DATABASE NAME`           | افتراضيًا، توجد قاعدة بيانات باسم `default`. استخدم اسم قاعدة البيانات التي تريد الاتصال بها. |
| `USERNAME` and `PASSWORD` | افتراضيًا، يكون اسم المستخدم `default`. استخدم اسم المستخدم المناسب لحالة الاستخدام لديك.     |

تتوفر تفاصيل خدمة ClickHouse Cloud الخاصة بك في ClickHouse Cloud console.
حدِّد خدمة ثم انقر على **Connect**:

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="زر Connect لخدمة ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

اختر **HTTPS**. ستظهر تفاصيل الاتصال في مثال لأمر `curl`.

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="تفاصيل اتصال HTTPS لخدمة ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

إذا كنت تستخدم ClickHouse مُدارًا ذاتيًا، فسيُحدِّد مسؤول ClickHouse لديك تفاصيل الاتصال.

<div id="configure-the-connector">
  #### تهيئة الموصل
</div>

انتقل إلى `Connectors` -> `Add Connector` واستخدم الإعدادات التالية (لاحظ أن القيم الواردة هنا هي أمثلة فقط):

```json theme={null}
{
  "database": "<DATABASE_NAME>",
  "errors.retry.timeout": "30",
  "exactlyOnce": "false",
  "schemas.enable": "false",
  "hostname": "<CLICKHOUSE_HOSTNAME>",
  "password": "<SAMPLE_PASSWORD>",
  "port": "8443",
  "ssl": "true",
  "topics": "<TOPIC_NAME>",
  "username": "<SAMPLE_USERNAME>",
  "key.converter": "org.apache.kafka.connect.storage.StringConverter",
  "value.converter": "org.apache.kafka.connect.json.JsonConverter",
  "value.converter.schemas.enable": "false"
}
```

<div id="specify-the-connection-endpoints">
  #### حدّد نقاط نهاية الاتصال
</div>

تحتاج إلى تحديد قائمة السماح الخاصة بنقاط النهاية التي يمكن للموصل الوصول إليها.
يجب استخدام اسم نطاق مؤهل بالكامل (FQDN) عند إضافة نقاط نهاية الخروج الشبكي.
مثال: `u57swl97we.eu-west-1.aws.clickhouse.com:8443`

<Note>
  يجب تحديد منفذ HTTP(S). لا يدعم الموصل بروتوكول Native حتى الآن.
</Note>

[اقرأ الوثائق.](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-qs.html#cc-byoc-endpoints)

وبذلك يكون كل شيء جاهزًا!

<div id="known-limitations">
  #### القيود المعروفة
</div>

* يجب أن تستخدم Custom Connectors نقاط نهاية عامة عبر الإنترنت. عناوين IP الثابتة غير مدعومة.
* يمكنك تجاوز بعض خصائص Custom Connector. راجع [القائمة في الوثائق الرسمية.](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-manage.html#override-configuration-properties)
* تتوفر Custom Connectors فقط في [بعض مناطق AWS](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-fands.html#supported-aws-regions)
* راجع قائمة [قيود Custom Connectors في الوثائق الرسمية](https://docs.confluent.io/cloud/current/connectors/bring-your-connector/custom-connector-fands.html#limitations)