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

> توثيق لعبارة ALTER TABLE ... MODIFY COMMENT التي تتيح إضافة تعليقات الجداول أو تعديلها أو إزالتها

# ALTER TABLE ... MODIFY COMMENT

يضيف تعليقًا إلى جدول أو يعدّله أو يزيله، سواء أكان مُعيَّنًا سابقًا أم لا. ينعكس تغيير التعليق في كلٍّ من [`system.tables`](/ar/reference/system-tables/tables)
وفي استعلام `SHOW CREATE TABLE`.

<div id="syntax">
  ## الصيغة
</div>

```sql theme={null}
ALTER TABLE [db].name [ON CLUSTER cluster] MODIFY COMMENT 'Comment'
```

<div id="examples">
  ## أمثلة
</div>

لإنشاء جدول يتضمّن تعليقًا:

```sql title="Query" theme={null}
CREATE TABLE table_with_comment
(
    `k` UInt64,
    `s` String
)
ENGINE = Memory()
COMMENT 'The temporary table';
```

لتعديل تعليق الجدول:

```sql title="Query" theme={null}
ALTER TABLE table_with_comment 
MODIFY COMMENT 'new comment on a table';
```

لعرض التعليق المعدَّل:

```sql title="Query" theme={null}
SELECT comment 
FROM system.tables 
WHERE database = currentDatabase() AND name = 'table_with_comment';
```

```text title="Response" theme={null}
┌─comment────────────────┐
│ new comment on a table │
└────────────────────────┘
```

لإزالة تعليق الجدول:

```sql title="Query" theme={null}
ALTER TABLE table_with_comment MODIFY COMMENT '';
```

للتحقق من أن التعليق قد أُزيل:

```sql title="Query" theme={null}
SELECT comment 
FROM system.tables 
WHERE database = currentDatabase() AND name = 'table_with_comment';
```

```text title="Response" theme={null}
┌─comment─┐
│         │
└─────────┘
```

<div id="caveats">
  ## ملاحظات مهمة
</div>

بالنسبة إلى الجداول Replicated، قد يختلف التعليق من نسخة متماثلة إلى أخرى.
يسري تعديل التعليق على نسخة متماثلة واحدة فقط.

تتوفّر هذه الميزة بدءًا من الإصدار 23.9. وهي لا تعمل في إصدارات
ClickHouse الأقدم.

<div id="related-content">
  ## محتوى مرتبط
</div>

* بند [`COMMENT`](/ar/reference/statements/create/table#comment-clause)
* [`ALTER DATABASE ... MODIFY COMMENT`](/ar/reference/statements/alter/database-comment)