> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.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`](/ru/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`](/ru/reference/statements/create/table#comment-clause)
* [`ALTER DATABASE ... MODIFY COMMENT`](/ru/reference/statements/alter/database-comment)