> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

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/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

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

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

يمكن نشر MySQL ClickPipes وإدارتها يدويًا باستخدام واجهة ClickPipes، وكذلك برمجيًا باستخدام [OpenAPI](/ar/integrations/clickpipes/programmatic-access/openapi) و[Terraform](/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](/ar/integrations/clickpipes/mysql/source/rds).                                        |
| **Amazon Aurora MySQL** <br /> *تحميل لمرة واحدة، CDC*        |        | اتبع [دليل إعداد Amazon Aurora MySQL](/ar/integrations/clickpipes/mysql/source/aurora).                                  |
| **Cloud SQL for MySQL** <br /> *تحميل لمرة واحدة، CDC*        |        | اتبع [دليل إعداد Cloud SQL for MySQL](/ar/integrations/clickpipes/mysql/source/gcp).                                     |
| **Azure Flexible Server for MySQL** <br /> *تحميل لمرة واحدة* |        | اتبع [دليل إعداد Azure Flexible Server for MySQL](/ar/integrations/clickpipes/mysql/source/azure-flexible-server-mysql). |
| **MySQL ذاتي الاستضافة** <br /> *تحميل لمرة واحدة، CDC*       |        | اتبع [دليل إعداد Generic MySQL](/ar/integrations/clickpipes/mysql/source/generic).                                       |
| **Amazon RDS MariaDB** <br /> *تحميل لمرة واحدة، CDC*         |        | اتبع [دليل إعداد Amazon RDS MariaDB](/ar/integrations/clickpipes/mysql/source/rds-maria).                                |
| **MariaDB ذاتي الاستضافة** <br /> *تحميل لمرة واحدة، CDC*     |        | اتبع [دليل إعداد Generic MariaDB](/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-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/cp_service.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=02ff8f342ae5f1bed228fb111e05c78b" alt="خدمة ClickPipes" size="lg" border width="1184" height="482" data-path="images/integrations/data-ingestion/clickpipes/cp_service.png" />

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

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

3. اختر بطاقة `MySQL CDC`

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

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

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=e5c11240befd2c626bd915c9f8775253" alt="املأ تفاصيل الاتصال" size="lg" border width="1842" height="1556" data-path="images/integrations/data-ingestion/clickpipes/mysql/mysql-connection-details.png" />

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

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

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

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

   <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/kkh98eOd_iRyUp1R/images/integrations/data-ingestion/clickpipes/postgres/ssh-tunnel.jpg?fit=max&auto=format&n=kkh98eOd_iRyUp1R&q=85&s=2ef2f529ab68bfc828b40043e5dc164d" 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](/ar/integrations/clickpipes/home#list-of-static-ips) في قواعد جدار الحماية الخاصة بمضيف SSH الوسيط حتى يتمكن ClickPipes من إنشاء نفق SSH.
</Note>

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

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

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

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

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

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

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

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

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

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

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

أخيرًا، يُرجى الرجوع إلى صفحة ["الأسئلة الشائعة حول ClickPipes for MySQL"](/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](/ar/integrations/clickpipes/mysql/faq).