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

> أدخِل البيانات بسلاسة من قاعدة بيانات MySQL أو MariaDB إلى ClickHouse Cloud.

# إدخال البيانات من MySQL إلى 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>
  إدخال البيانات من MySQL إلى ClickHouse Cloud عبر ClickPipes متاح حاليًا في الإصدار التجريبي العام.
</Info>

يوفّر MySQL ClickPipe طريقة مُدارة بالكامل وموثوقة لإدخال البيانات من قواعد بيانات MySQL وMariaDB إلى ClickHouse Cloud. وهو يدعم كلاً من **عملية تحميل مجمّع** للإدخال لمرة واحدة و**التقاط تغيّر البيانات (CDC)** للإدخال المستمر.

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

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

[//]: # "TODO لا يلزم إعداد النسخ المتماثل لـ binlog لمسارات الإدخال لمرة واحدة. وقد كان هذا سببًا للالتباس في السابق، لذا ينبغي أيضًا توفير الحد الأدنى من المتطلبات اللازمة لعمليات التحميل المجمّع لتجنب تنفير المستخدمين."

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

<div id="supported-data-sources">
  ### مصادر البيانات المدعومة
</div>

| الاسم                                                         | الشعار | التفاصيل                                                                                                                 |
| ------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| **Amazon RDS MySQL** <br /> *تحميل لمرة واحدة، CDC*           |        | اتبع [دليل إعداد Amazon RDS MySQL](/docs/ar/integrations/clickpipes/mysql/source/rds).                                        |
| **Amazon Aurora MySQL** <br /> *تحميل لمرة واحدة، CDC*        |        | اتبع [دليل إعداد Amazon Aurora MySQL](/docs/ar/integrations/clickpipes/mysql/source/aurora).                                  |
| **Cloud SQL for MySQL** <br /> *تحميل لمرة واحدة، CDC*        |        | اتبع [دليل إعداد Cloud SQL for MySQL](/docs/ar/integrations/clickpipes/mysql/source/gcp).                                     |
| **Azure Flexible Server for MySQL** <br /> *تحميل لمرة واحدة* |        | اتبع [دليل إعداد Azure Flexible Server for MySQL](/docs/ar/integrations/clickpipes/mysql/source/azure-flexible-server-mysql). |
| **MySQL ذاتي الاستضافة** <br /> *تحميل لمرة واحدة، CDC*       |        | اتبع [دليل إعداد Generic MySQL](/docs/ar/integrations/clickpipes/mysql/source/generic).                                       |
| **Amazon RDS MariaDB** <br /> *تحميل لمرة واحدة، CDC*         |        | اتبع [دليل إعداد Amazon RDS MariaDB](/docs/ar/integrations/clickpipes/mysql/source/rds-maria).                                |
| **MariaDB ذاتي الاستضافة** <br /> *تحميل لمرة واحدة، CDC*     |        | اتبع [دليل إعداد Generic MariaDB](/docs/ar/integrations/clickpipes/mysql/source/generic-maria).                               |

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

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

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

[//]: # "   TODO update image here"

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. اختر بطاقة `MySQL CDC`

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=6e7a0ad3fb4b0303186a3c66237d9987" alt="تحديد MySQL" size="lg" border width="2612" height="892" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-tile.webp" />

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=9eefe348ba0d4d2ce55623a8419a6931" alt="املأ تفاصيل الاتصال" size="lg" border width="1842" height="1556" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-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 إذا كانت قاعدة بيانات MySQL المصدر غير متاحة للعامة.

1. فعِّل مفتاح التبديل "استخدام نفق SSH".

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. لاستخدام المصادقة المستندة إلى المفتاح، انقر على "إبطال وإنشاء زوج مفاتيح" لإنشاء زوج مفاتيح جديد، ثم انسخ المفتاح العام الذي تم إنشاؤه إلى خادم SSH لديك ضمن `~/.ssh/authorized_keys`.

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

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

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

<div id="advanced-settings">
  #### ضبط الإعدادات المتقدمة
</div>

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

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

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

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

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

6. يمكنك اختيار الجداول التي تريد نسخها من قاعدة بيانات MySQL المصدر. وأثناء اختيار الجداول، يمكنك أيضًا إعادة تسمية الجداول في قاعدة بيانات 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" />

أخيرًا، يُرجى الرجوع إلى صفحة ["الأسئلة الشائعة حول ClickPipes for MySQL"](/docs/ar/integrations/clickpipes/mysql/faq) لمزيد من المعلومات عن المشكلات الشائعة وكيفية حلّها.

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

[//]: # "TODO Write a MySQL-specific migration guide and best practices similar to the existing one for PostgreSQL. The current migration guide points to the MySQL table engine, which isn't ideal."

بعد إعداد ClickPipe لنسخ البيانات من MySQL إلى ClickHouse Cloud، يمكنك التركيز على كيفية الاستعلام عن بياناتك ونمذجتها لتحقيق أفضل أداء. للاطلاع على الأسئلة الشائعة حول MySQL CDC واستكشاف الأخطاء وإصلاحها، راجع [صفحة الأسئلة الشائعة الخاصة بـ MySQL](/docs/ar/integrations/clickpipes/mysql/faq).