> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# دليل إعداد RDS MariaDB كمصدر

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

يوضح هذا الدليل خطوة بخطوة كيفية إعداد مثيل RDS MariaDB لديك لنسخ بياناته عبر MySQL ClickPipe.

<br />

<Info>
  نوصي أيضًا بالاطلاع على الأسئلة الشائعة الخاصة بـ MySQL [هنا](/ar/integrations/clickpipes/mysql/faq). ويجري تحديث صفحة الأسئلة الشائعة باستمرار.
</Info>

<div id="enable-binlog-retention-rds">
  ## تمكين الاحتفاظ بالسجل الثنائي
</div>

السجل الثنائي عبارة عن مجموعة من ملفات السجل التي تتضمن معلومات عن تعديلات البيانات التي أُجريت على مثيل خادم MySQL. وتُعد ملفات السجل الثنائي مطلوبة للنسخ المتماثل. يجب اتباع كلتا الخطوتين أدناه:

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

تحدّد ميزة النسخ الاحتياطية الآلية ما إذا كان التسجيل الثنائي مفعّلًا أو معطّلًا في MySQL. ويمكن ضبطها من وحدة تحكم AWS:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=7236ad6a5564702878d31e2f32154a6c" alt="تمكين النسخ الاحتياطية الآلية في RDS" size="lg" border width="3230" height="530" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.webp" />

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

<div id="binlog-retention-hours-rds">
  ### 2. ساعات الاحتفاظ بـ binlog
</div>

تستخدم Amazon RDS for MariaDB طريقة مختلفة لتحديد مدة الاحتفاظ بـ binlog، وهي مقدار الوقت الذي يُحتفَظ فيه بملف binlog الذي يحتوي على التغييرات. وإذا لم تُقرأ بعض التغييرات قبل إزالة ملف binlog، فلن يتمكن النسخ المتماثل من الاستمرار. القيمة الافتراضية لساعات الاحتفاظ بـ binlog هي NULL، ما يعني عدم الاحتفاظ بالسجلات الثنائية.

لتحديد عدد الساعات للاحتفاظ بالسجلات الثنائية على مثيل قاعدة بيانات، استخدم الدالة mysql.rds\_set\_configuration مع فترة احتفاظ بـ binlog طويلة بما يكفي لحدوث النسخ المتماثل. ويُعد `24 hours` الحد الأدنى الموصى به.

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

<div id="binlog-parameter-group-rds">
  ## اضبط إعدادات binlog في مجموعة المعلمات
</div>

يمكنك العثور على مجموعة المعلمات بالنقر على مثيل MariaDB الخاص بك في RDS Console، ثم الانتقال إلى علامة التبويب `Configurations`.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/rds_config.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=298bd24f78ec394a8ec2aa1c514356ea" alt="مكان العثور على مجموعة المعلمات في RDS" size="lg" border width="708" height="853" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/rds_config.webp" />

عند النقر على رابط مجموعة المعلمات، ستنتقل إلى صفحة مجموعة المعلمات. وسترى زر `Edit` في أعلى اليمين:

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

يجب ضبط الإعدادات `binlog_format` و`binlog_row_metadata` و`binlog_row_image` على النحو التالي:

1. اضبط `binlog_format` على `ROW`.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=5a295b9004ecf56ba3be2d4a661b4934" alt="تنسيق binlog إلى ROW" size="lg" border width="960" height="232" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.webp" />

2. اضبط `binlog_row_metadata` على `FULL`

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=998466c7780b5731d8cdafd2c7e26e4e" alt="البيانات الوصفية لصف binlog إلى FULL" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.webp" />

3. اضبط `binlog_row_image` على `FULL`

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=88ab16be97b12e410aa1ec006c6082b1" alt="صورة صف binlog إلى FULL" size="lg" border width="934" height="234" data-path="images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.webp" />

بعد ذلك، انقر على `Save Changes` في أعلى اليمين. قد تحتاج إلى إعادة تشغيل المثيل حتى تدخل التغييرات حيز التنفيذ. إذا ظهر لك `Pending reboot` بجانب رابط مجموعة المعلمات في علامة التبويب `Configurations` الخاصة بمثيل RDS، فهذه علامة واضحة على ضرورة إعادة تشغيل المثيل.

<br />

<Tip>
  إذا كان لديك عنقود MariaDB، فستجد المعلمات المذكورة أعلاه في مجموعة معلمات [DB Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html)، وليس في مجموعة مثيل DB.
</Tip>

<div id="gtid-mode-rds">
  ## تمكين وضع GTID
</div>

تُعدّ Global Transaction Identifiers ‏(GTIDs) معرّفات فريدة تُسنَد إلى كل معاملة مُعتمدة في MySQL/MariaDB. وهي تُبسّط النسخ المتماثل عبر binlog وتجعل استكشاف الأخطاء وإصلاحها أكثر سهولة. يفعّل MariaDB وضع GTID افتراضيًا، لذلك لا يلزم المستخدم اتخاذ أي إجراء لاستخدامه.

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

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

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

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'host' 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>

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

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=7faf6c4f7a134540a4bfb927436ef8da" alt="أين تجد مجموعة الأمان في RDS؟" size="lg" border width="2850" height="994" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.webp" />

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/vgIzai2BO-JprHxt/images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.webp?fit=max&auto=format&n=vgIzai2BO-JprHxt&q=85&s=e70eeb0cae6c69c9cfd9a34bfc371c48" alt="تعديل قواعد Inbound rules لمجموعة الأمان المذكورة أعلاه" size="lg" border width="1800" height="935" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.webp" />

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

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