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

> يوضح كيفية ربط MongoDB لديك بـ ClickHouse Cloud بسلاسة.

# إدخال البيانات من MongoDB إلى ClickHouse (باستخدام CDC)

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>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ميزة Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

<Info>
  إدخال البيانات من MongoDB إلى ClickHouse Cloud عبر ClickPipes متاح حاليًا في النسخة التجريبية العامة.
</Info>

<Note>
  في وحدة تحكم ClickHouse Cloud والوثائق، يُستخدم المصطلحان "table" و"collection" بالتبادل عند الإشارة إلى MongoDB.
</Note>

يمكنك استخدام ClickPipes لإدخال البيانات من قاعدة بيانات MongoDB الخاصة بك إلى ClickHouse Cloud. ويمكن استضافة قاعدة بيانات MongoDB المصدر داخل بنيتك التحتية المحلية أو في السحابة باستخدام خدمات مثل MongoDB Atlas.

يمكن نشر MongoDB ClickPipes وإدارته يدويًا باستخدام ClickPipes UI، وكذلك برمجيًا باستخدام [OpenAPI](/docs/ar/integrations/clickpipes/programmatic-access/openapi) و[Terraform](/docs/ar/integrations/clickpipes/programmatic-access/terraform).

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

للبدء، عليك أولًا التأكد من أن قاعدة بيانات MongoDB المصدر مُعَدّة بشكل صحيح للنسخ المتماثل. وتعتمد خطوات الإعداد على طريقة نشر MongoDB، لذا يُرجى اتباع الدليل المناسب أدناه:

1. [MongoDB Atlas](/docs/ar/integrations/clickpipes/mongodb/source/atlas)

2. [Generic MongoDB](/docs/ar/integrations/clickpipes/mongodb/source/generic)

3. [Amazon DocumentDB](/docs/ar/integrations/clickpipes/mongodb/source/documentdb)

بعد إعداد قاعدة بيانات MongoDB المصدر، يمكنك متابعة إنشاء ClickPipe.

<div id="create-your-clickpipe">
  ## أنشئ ClickPipe الخاص بك
</div>

تأكد من أنك مسجّل الدخول إلى حساب ClickHouse Cloud الخاص بك. إذا لم يكن لديك حساب بعد، يمكنك التسجيل [هنا](https://cloud.clickhouse.com/).

1. في وحدة تحكم ClickHouse Cloud، انتقل إلى خدمة ClickHouse Cloud الخاصة بك.

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_service.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=ba65ca18b8e032a9d412b779741717f5" alt="خدمة ClickPipes" size="lg" border width="1184" height="482" data-path="images/integrations/data-ingestion/clickpipes/cp_service.webp" />

2. من القائمة الجانبية اليسرى، حدّد الزر `Data Sources` ثم انقر على "Set up a ClickPipe".

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=fb04bb07245be43cb784fa68cee62287" alt="اختيار الواردات" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.webp" />

3. حدّد بطاقة `MongoDB CDC`.

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongodb-tile.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=37d4e87618edf9e1aee3324f9a6a5305" alt="اختيار MongoDB" size="lg" border width="1802" height="986" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongodb-tile.webp" />

<div id="add-your-source-mongodb-database-connection">
  ### أضِف اتصال قاعدة بيانات MongoDB المصدر
</div>

4. املأ تفاصيل الاتصال لقاعدة بيانات MongoDB المصدر التي أعددتها في خطوة المتطلبات الأساسية.

<Info>
  قبل البدء بإضافة تفاصيل الاتصال، تأكد من إدراج عناوين IP الخاصة بـ ClickPipes في قائمة السماح ضمن قواعد جدار الحماية لديك. في الصفحة التالية، يمكنك العثور على [قائمة بعناوين IP الخاصة بـ ClickPipes](/docs/ar/integrations/clickpipes/home#list-of-static-ips).
  لمزيد من المعلومات، راجع أدلة إعداد MongoDB المصدر المشار إليها في [أعلى هذه الصفحة](#prerequisites).
</Info>

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongodb-connection-details.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=2e9ea9be8d070e2a410f84692d9b2230" alt="املأ تفاصيل الاتصال" size="lg" border width="1538" height="1698" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongodb-connection-details.webp" />

<div id="optional-changing-tls-settings">
  #### (اختياري) تعديل إعدادات TLS
</div>

افتراضيًا، سيتم إنشاء ClickPipe مع تفعيل TLS والتحقق من الشهادة. ويمكن تعديل هذه الإعدادات الافتراضية عند إنشاء ClickPipe:

<Frame>
  <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/tls-settings.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=354571f9124f3d67be0009e0c0986509" alt="إعدادات TLS" width="1113" height="688" data-path="images/integrations/data-ingestion/clickpipes/postgres/tls-settings.webp" />
</Frame>

أو تعديلها من قسم *إعدادات الاتصال* ضمن علامة تبويب *الإعدادات* في ClickPipe المتوقّف مؤقتًا:

<Frame>
  <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=28a2df0694e28170b34f8ba7f8e81b82" alt="إعدادات الاتصال -> تعديل الاتصال" data-og-width="1035" width="1035" data-og-height="312" height="312" data-path="images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=280&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=dba8d05cac1ee3d8cac0765e6508fc65 280w, https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=560&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=da9b3248a380def99a3eac70fa2766fc 560w, https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=840&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=4d478a7aeda56d495f47322d0c448a39 840w, https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=1100&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=dcc4a87641fea36cecbbcbd1d7ed6e98 1100w, https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=1650&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=fadfc249d44a5778963a53657c22a684 1650w, https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-connection-settings.webp?w=2500&fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=ab8e5667017527822f07fa96cddcc22d 2500w" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/postgres/pipe-edit-connection.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=93ebf1b8ea0d0c24027a87abaae8c15b" alt="تعديل الاتصال" width="703" height="542" data-path="images/integrations/data-ingestion/clickpipes/postgres/pipe-edit-connection.webp" />
</Frame>

حيث:

* `Disable TLS` يبدّل TLS للاتصال بين التفعيل والتعطيل. ويعني تعطيل TLS أن البيانات تُرسل كنص غير مشفّر عبر الشبكة، وقد يشمل ذلك الأسرار والبيانات الحساسة.
* `Skip certificate verification` يبدّل التحقق من الشهادة التي تعرضها قاعدة البيانات المصدر بين التفعيل والتعطيل. يُرجى مراعاة الآثار الأمنية المترتبة على تخطي التحقق من الشهادة.
* `TLS Host` (اختياري، والقيمة الافتراضية هي *Host* للمصدر) هو اسم المضيف الذي يجب أن يتطابق معه CN الخاص بالشهادة عند تفعيل التحقق من الشهادة.
* `Upload CA` يمكن استخدامه لتوفير CA تُستخدم عند تفعيل التحقق من الشهادة.

<div id="optional-set-up-ssh-tunneling">
  #### (اختياري) إعداد نفق SSH
</div>

يمكنك تحديد تفاصيل نفق SSH إذا كانت قاعدة بيانات MongoDB المصدر لديك غير متاحة عبر الإنترنت العام.

1. فعِّل زر التبديل "Use SSH Tunnelling".

2. املأ تفاصيل اتصال SSH.

   <Image img="https://mintcdn.com/private-7c7dfe99/MoeBDs4tywkUTQ28/images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg?fit=max&auto=format&n=MoeBDs4tywkUTQ28&q=85&s=2cfd8e7bd51f0bb5b5c14efa95418b82" alt="نفق SSH" size="lg" border width="1780" height="1342" data-path="images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg" />

3. لاستخدام المصادقة المستندة إلى المفتاح، انقر على "Revoke and generate key pair" لإنشاء زوج مفاتيح جديد، ثم انسخ المفتاح العام الذي تم إنشاؤه إلى خادم SSH لديك ضمن `~/.ssh/authorized_keys`.

4. انقر على "Verify Connection" للتحقق من الاتصال.

<Note>
  تأكد من السماح لعناوين IP الخاصة بـ [عناوين IP الخاصة بـ ClickPipes](/docs/ar/integrations/clickpipes/home#list-of-static-ips) في قواعد جدار الحماية الخاصة بمضيف SSH bastion حتى يتمكن ClickPipes من إنشاء نفق SSH.
</Note>

بعد إدخال تفاصيل الاتصال، انقر على `Next`.

<div id="advanced-settings">
  #### تكوين الإعدادات المتقدمة
</div>

يمكنك تكوين الإعدادات المتقدمة عند الحاجة. يرد أدناه وصف موجز لكل إعداد:

* **فاصل المزامنة**: هذا هو الفاصل الزمني الذي ستتحقق عنده ClickPipes من وجود تغييرات في قاعدة البيانات المصدر. ولهذا تأثير على خدمة ClickHouse الوجهة، لذا نوصي المستخدمين الحريصين على التكلفة بالإبقاء عليه عند قيمة أعلى (أكبر من `3600`).
* **حجم دفعة السحب**: عدد الصفوف التي سيتم جلبها في دفعة واحدة. هذا إعداد يُطبَّق على أساس أفضل جهد، وقد لا يُلتزم به في جميع الحالات.
* **عدد الجداول في اللقطة الأولية بالتوازي**: هذا هو عدد الجداول التي سيتم جلبها بالتوازي أثناء اللقطة الأولية. ويكون ذلك مفيدًا عندما يكون لديك عدد كبير من الجداول وتريد التحكم في عدد الجداول التي يتم جلبها بالتوازي.

<div id="configure-the-tables">
  ### إعداد الجداول
</div>

5. هنا يمكنك تحديد قاعدة البيانات الوجهة لـ ClickPipe. يمكنك إما تحديد قاعدة بيانات موجودة أو إنشاء قاعدة بيانات جديدة.

   <Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/select-destination-db.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=d65876f82d33dfa7ad4282f0974ed14d" alt="تحديد قاعدة البيانات الوجهة" size="lg" border width="1742" height="548" data-path="images/integrations/data-ingestion/clickpipes/mongodb/select-destination-db.webp" />

6. يمكنك تحديد الجداول التي تريد نسخها من قاعدة بيانات MongoDB المصدر. وأثناء تحديد الجداول، يمكنك أيضًا اختيار إعادة تسمية الجداول في قاعدة بيانات ClickHouse الوجهة.

<div id="review-permissions-and-start-the-clickpipe">
  ### راجع الأذونات وابدأ ClickPipe
</div>

7. اختر دور «الوصول الكامل» من القائمة المنسدلة للأذونات، ثم انقر على «إكمال الإعداد».

   <Image img="https://mintcdn.com/private-7c7dfe99/MoeBDs4tywkUTQ28/images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg?fit=max&auto=format&n=MoeBDs4tywkUTQ28&q=85&s=f14674431c4db83bae53ffe332bfe7e1" alt="مراجعة الأذونات" size="lg" border width="1844" height="716" data-path="images/integrations/data-ingestion/clickpipes/postgres/ch-permissions.jpg" />

<div id="whats-next">
  ## ما التالي؟
</div>

بعد إعداد ClickPipe لنسخ البيانات من MongoDB إلى ClickHouse Cloud، يمكنك التركيز على كيفية الاستعلام عن بياناتك ونمذجتها لتحقيق أفضل أداء.

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

فيما يلي بعض الملاحظات المهمة التي ينبغي الانتباه إليها عند استخدام هذا الموصل:

* نشترط استخدام MongoDB بالإصدار 5.1.0 أو أحدث.
* نستخدم واجهة برمجة تطبيقات change stream الأصلية في MongoDB من أجل CDC، والتي تعتمد على oplog في MongoDB لالتقاط التغييرات في الوقت الفعلي.
* تُنسخ المستندات من MongoDB إلى ClickHouse باستخدام JSON type افتراضيًا. يوفّر ذلك مرونة في إدارة الـ schema، ويتيح استخدام المجموعة الغنية من operators الخاصة بـ JSON في ClickHouse لأغراض الاستعلام والتحليلات. يمكنك معرفة المزيد عن الاستعلام عن بيانات JSON [هنا](/docs/ar/reference/data-types/newjson).
* لا يتوفر حاليًا إعداد PrivateLink بنمط self-serve. إذا كنت تستخدم AWS وتحتاج إلى PrivateLink، يُرجى التواصل عبر [db-integrations-support@clickhouse.com](mailto:db-integrations-support@clickhouse.com) أو إنشاء تذكرة دعم — وسنعمل معك على تفعيله.