ClickHouse/docs/ru/sql-reference/statements/alter/comment.md

toc_priority	toc_title
51	COMMENT

ALTER TABLE … MODIFY COMMENT

Добавляет, изменяет или удаляет комментарий к таблице, независимо от того, был ли он установлен раньше или нет. Изменение комментария отражается как в системной таблице system.tables, так и в результате выполнения запроса SHOW CREATE TABLE.

Синтаксис

ALTER TABLE [db].name [ON CLUSTER cluster] MODIFY COMMENT 'Comment'

Примеры

Создание таблицы с комментарием (для более подробной информации смотрите секцию COMMENT):

CREATE TABLE table_with_comment
(
    `k` UInt64,
    `s` String
)
ENGINE = Memory()
COMMENT 'The temporary table';

Изменение комментария:

ALTER TABLE table_with_comment MODIFY COMMENT 'new comment on a table';
SELECT comment FROM system.tables WHERE database = currentDatabase() AND name = 'table_with_comment';

Вывод нового комментария:

┌─comment────────────────┐
│ new comment on a table │
└────────────────────────┘

Удаление комментария:

ALTER TABLE table_with_comment MODIFY COMMENT '';
SELECT comment FROM system.tables WHERE database = currentDatabase() AND name = 'table_with_comment';

Вывод удаленного комментария:

┌─comment─┐
│         │
└─────────┘