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

# دعم تمرير تغييرات المخطط

> صفحة تصف أنواع تغييرات المخطط التي يمكن لـ ClickPipes اكتشافها في الجداول المصدر

يمكن لـ ClickPipes for MySQL اكتشاف تغييرات المخطط في الجداول المصدر، وفي بعض الحالات، تمرير هذه التغييرات تلقائيًا إلى الجداول الوجهة. آلية التعامل مع كل عملية DDL موثقة أدناه:

[//]: # "TODO وسّع هذه الصفحة لتشمل السلوك عند إعادة التسمية، وتغييرات نوع البيانات، و TRUNCATE، بالإضافة إلى إرشادات حول كيفية التعامل مع تغييرات المخطط غير المتوافقة."

| نوع تغيير المخطط                                                          | السلوك                                                                                                                                                                       |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| إضافة عمود جديد (`ALTER TABLE ADD COLUMN ...`)                            | يتم تمريره تلقائيًا. ستتم تعبئة الأعمدة الجديدة لجميع الصفوف التي جرى نسخها بعد تغيير المخطط                                                                                 |
| إضافة عمود جديد بقيمة افتراضية (`ALTER TABLE ADD COLUMN ... DEFAULT ...`) | يتم تمريره تلقائيًا. ستتم تعبئة الأعمدة الجديدة لجميع الصفوف التي جرى نسخها بعد تغيير المخطط، لكن الصفوف الحالية لن تُظهر القيمة الافتراضية إلا بعد إعادة تحديث كاملة للجدول |
| حذف عمود موجود (`ALTER TABLE DROP COLUMN ...`)                            | يُكتشف، ولكن **لا** يتم تمريره. ستُملأ الأعمدة المحذوفة بالقيمة `NULL` لجميع الصفوف التي جرى نسخها بعد تغيير المخطط                                                          |

<Note>
  إضافة أعمدة أثناء اللقطة غير مدعومة حاليًا. والحل البديل المقترح هو تنفيذ اللقطات قبل تغييرات المخطط المخطط لها أو بعدها، أو، إذا كان ClickPipe يتعطل بالفعل، إضافة عمود يدويًا من النوع المناسب إلى الجدول الوجهة.
</Note>

<div id="mysql-5-limitations">
  ### قيود MySQL 5.x
</div>

إصدارات MySQL الأقدم من [8.0.1](https://dev.mysql.com/blog-archive/more-metadata-is-written-into-binary-log/) لا تتضمن بيانات وصفية كاملة للأعمدة في `binlog` (`binlog_row_metadata=FULL`)، لذا تتعقّب ClickPipes الأعمدة بحسب ترتيبها. وهذا يعني ما يلي:

* **إضافة عمود في النهاية** (`ALTER TABLE ADD COLUMN ...`) مدعومة.
* **أي DDL يغيّر ترتيب الأعمدة** سيؤدي إلى ظهور خطأ في المسار، لأنه لن يعود بالإمكان بعد ذلك مطابقة المواضع الترتيبية بشكل موثوق. ويشمل ذلك:
  * `ALTER TABLE DROP COLUMN ...`
  * `ALTER TABLE ADD COLUMN ... AFTER ...` / `FIRST`
  * `ALTER TABLE MODIFY COLUMN ... AFTER ...` / `FIRST`
  * `ALTER TABLE CHANGE COLUMN ... AFTER ...` / `FIRST`

إذا واجهت هذا الخطأ، فستحتاج إلى إعادة مزامنة المسار.
