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

> دليل خطوة بخطوة لإعداد Amazon Aurora MySQL كمصدر لـ ClickPipes

# دليل إعداد Aurora MySQL كمصدر

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

<div id="enable-binlog-retention-aurora">
  ## تمكين الاحتفاظ بـ binlog
</div>

يُعد binlog مجموعةً من ملفات السجل التي تحتوي على معلومات عن التعديلات التي تُجرى على البيانات في مثيل خادم MySQL، وتكون ملفات binlog مطلوبةً للنسخ المتماثل. لتهيئة الاحتفاظ بـ binlog في Aurora MySQL، يجب [تمكين التسجيل الثنائي](#enable-binlog-logging) و[زيادة فترة الاحتفاظ بالـ binlog](#binlog-retention-interval).

<div id="enable-binlog-logging">
  ### 1. تمكين التسجيل الثنائي عبر النسخ الاحتياطية المؤتمتة
</div>

تحدد ميزة النسخ الاحتياطية المؤتمتة ما إذا كان التسجيل الثنائي مفعّلًا أو معطّلًا في MySQL. يمكنك تهيئة النسخ الاحتياطية المؤتمتة لمثيلك من خلال RDS Console بالانتقال إلى **Modify** > **Additional configuration** > **Backup** ثم تحديد مربع الاختيار **Enable automated backups** (إذا لم يكن محددًا بالفعل).

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=44d50884f8b3249b79019ebd1447aba1" alt="تمكين النسخ الاحتياطية المؤتمتة في Aurora" size="lg" border width="3230" height="530" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.png" />

نوصي بضبط **فترة الاحتفاظ بالنسخ الاحتياطية** على مدة طويلة نسبيًا، وفقًا لحالة استخدام النسخ المتماثل.

<div id="binlog-retention-interval">
  ### 2. زيادة فترة الاحتفاظ بالـ binlog
</div>

<Warning>
  إذا حاولت ClickPipes استئناف النسخ المتماثل وكانت ملفات binlog المطلوبة قد حُذفت بسبب قيمة الاحتفاظ بالـ binlog المُعَدّة، فسينتقل ClickPipe إلى حالة خطأ وستلزم إعادة المزامنة.
</Warning>

بشكل افتراضي، يحذف Aurora MySQL السجل الثنائي بأسرع وقت ممكن (أي *الحذف المؤجل*). نوصي بزيادة فترة الاحتفاظ بالـ binlog إلى **72 ساعة** على الأقل لضمان توفر ملفات السجل الثنائي للنسخ المتماثل في سيناريوهات الفشل. لتعيين فترة احتفاظ للسجل الثنائي ([`binlog retention hours`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration-usage-notes.binlog-retention-hours))، استخدم الإجراء [`mysql.rds_set_configuration`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration):

[//]: # "ملاحظة: يوصي معظم موفري CDC باستخدام الحد الأقصى لفترة الاحتفاظ في Aurora RDS (7 أيام/168 ساعة). ونظرًا لأن ذلك يؤثر في استخدام القرص، فإننا نوصي، من باب التحفظ، بحد أدنى قدره 3 أيام/72 ساعة."

```text theme={null}
mysql=> call mysql.rds_set_configuration('binlog retention hours', 72);
```

إذا لم يتم تعيين هذا الإعداد، أو تم تعيينه على فترة زمنية قصيرة، فقد يؤدي ذلك إلى حدوث فجوات في سجلات MySQL الثنائية، مما يعيق قدرة ClickPipes على استئناف النسخ المتماثل.

<div id="binlog-settings">
  ## تكوين إعدادات binlog
</div>

يمكن العثور على مجموعة المعلمات عند النقر على مثيل MySQL الخاص بك في RDS Console، ثم الانتقال إلى علامة التبويب **Configuration**.

<Tip>
  إذا كان لديك cluster لـ MySQL، فيمكن العثور على المعلمات أدناه في مجموعة معلمات [DB cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html) بدلًا من مجموعة معلمات DB instance.
</Tip>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/aurora_config.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=26651bd4950b859114c0d000f29bbef6" alt="مكان العثور على مجموعة المعلمات في Aurora" size="lg" border width="1524" height="901" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/aurora_config.png" />

<br />

انقر على رابط مجموعة المعلمات، وسيأخذك ذلك إلى صفحتها المخصصة. ينبغي أن ترى زر **Edit** في أعلى اليمين.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/edit_button.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=db811f938ad7abca9ace78dc8ef0d93f" alt="تحرير مجموعة المعلمات" size="lg" border width="1662" height="292" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/edit_button.png" />

<br />

يجب ضبط المعلمات التالية كما يلي:

1. تعيين `binlog_format` إلى `ROW`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=3ab86fae4861bc5fcf9128a81fd0f127" alt="تنسيق binlog إلى ROW" size="lg" border width="960" height="232" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.png" />

2. تعيين `binlog_row_metadata` إلى `FULL`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=92f964698139fb7ab9714a3ee20f476b" alt="البيانات الوصفية لصف binlog" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.png" />

3. تعيين `binlog_row_image` إلى `FULL`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=5528c5fc8f50bdb26880979cc842116f" alt="صورة صف binlog" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.png" />

<br />

بعد ذلك، انقر على **Save Changes** في الزاوية العلوية اليمنى. قد تحتاج إلى إعادة تشغيل المثيل الخاص بك حتى تدخل التغييرات حيز التنفيذ — ويمكنك معرفة ذلك إذا رأيت `Pending reboot` بجانب رابط مجموعة المعلمات في علامة التبويب **Configuration** الخاصة بمثيل Aurora.

<div id="gtid-mode">
  ## فعِّل وضع GTID (مُستحسن)
</div>

<Tip>
  يدعم MySQL ClickPipe أيضًا النسخ المتماثل من دون وضع GTID. ومع ذلك، يُوصى بتمكين وضع GTID لتحسين الأداء وتسهيل استكشاف الأخطاء وإصلاحها.
</Tip>

تُعد [Global Transaction Identifiers (GTIDs)](https://dev.mysql.com/doc/refman/8.0/en/replication-gtids.html) معرّفات فريدة تُسنَد إلى كل معاملة تم تثبيتها في MySQL. وهي تُبسّط النسخ المتماثل لـ binlog وتجعل استكشاف الأخطاء وإصلاحها أكثر سهولة. **نوصي** بتمكين وضع GTID، بحيث يتمكن MySQL ClickPipe من استخدام النسخ المتماثل المستند إلى GTID.

النسخ المتماثل المستند إلى GTID مدعوم في Amazon Aurora MySQL v2 ‏(MySQL 5.7) وv3 ‏(MySQL 8.0)، وكذلك Aurora Serverless v2. لتمكين وضع GTID لمثيل Aurora MySQL الخاص بك، اتبع الخطوات التالية:

1. في RDS Console، انقر على مثيل MySQL الخاص بك.
2. انقر على علامة التبويب **Configuration**.
3. انقر على رابط مجموعة المعلمات.
4. انقر على زر **Edit** في الزاوية العلوية اليمنى.
5. اضبط `enforce_gtid_consistency` على `ON`.
6. اضبط `gtid-mode` على `ON`.
7. انقر على **Save Changes** في الزاوية العلوية اليمنى.
8. أعد تشغيل المثيل لتصبح التغييرات سارية المفعول.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/enable_gtid.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=2c3b212f55083db752ea2fd501e9e9d6" alt="تم تمكين GTID" size="lg" border width="1650" height="469" data-path="images/integrations/data-ingestion/clickpipes/mysql/enable_gtid.png" />

<div id="configure-database-user">
  ## تهيئة مستخدم قاعدة بيانات
</div>

اتصل بمثيل Aurora MySQL الخاص بك باستخدام مستخدم مسؤول، ثم نفّذ الأوامر التالية:

1. أنشئ مستخدمًا مخصصًا لـ ClickPipes:

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'%' IDENTIFIED BY 'some-password';
   ```

2. امنح أذونات المخطط. يوضّح المثال التالي أذونات قاعدة البيانات `mysql`. كرر هذه الأوامر لكل قاعدة بيانات ولكل مضيف تريد النسخ المتماثل منه:

   ```sql theme={null}
   GRANT SELECT ON `mysql`.* TO 'clickpipes_user'@'host';
   ```

3. امنح المستخدم أذونات النسخ المتماثل:

   ```sql theme={null}
   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   ```

<div id="configure-network-access">
  ## إعداد الوصول إلى الشبكة
</div>

<div id="ip-based-access-control">
  ### التحكم في الوصول المستند إلى عنوان IP
</div>

لتقييد حركة المرور الواردة إلى مثيل Aurora MySQL لديك، أضِف [عناوين IP الثابتة لـ NAT المذكورة في الوثائق](/ar/integrations/clickpipes/home#list-of-static-ips) إلى **قواعد الدخول** في مجموعة الأمان الخاصة بـ Aurora.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=6207ee2b4575226d22be83a3c7d21847" alt="أين تجد مجموعة الأمان في Aurora MySQL؟" size="lg" border width="2850" height="994" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.png" />

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/kkh98eOd_iRyUp1R/images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.png?fit=max&auto=format&n=kkh98eOd_iRyUp1R&q=85&s=baa7c5ba8889b33e5222949fbd5bd469" alt="تحرير قواعد الدخول لمجموعة الأمان المذكورة أعلاه" size="lg" border width="1800" height="935" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.png" />

<div id="private-access-via-aws-privatelink">
  ### الوصول الخاص عبر AWS PrivateLink
</div>

للاتصال بمثيل Aurora MySQL الخاص بك عبر شبكة خاصة، يمكنك استخدام AWS PrivateLink. اتبع [دليل إعداد AWS PrivateLink لـ ClickPipes](/ar/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes) لإعداد الاتصال.

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

الآن، بعد أن أصبح مثيل Amazon Aurora MySQL الخاص بك مُعَدًّا للنسخ المتماثل عبر binlog ومتصلًا بشكل آمن بـ ClickHouse Cloud، يمكنك [إنشاء أول MySQL ClickPipe لك](/ar/integrations/clickpipes/mysql/index#create-your-clickpipe). للاطلاع على الأسئلة الشائعة حول MySQL CDC، راجع [صفحة الأسئلة الشائعة لـ MySQL](/ar/integrations/clickpipes/mysql/faq).