Перейти к основному содержимому
Перейти к основному содержимому

ALTER TABLE ... MODIFY COMMENT

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

Синтаксис​

ALTER TABLE [db].name [ON CLUSTER cluster] MODIFY COMMENT 'Комментарий'

Примеры​

Чтобы создать таблицу с комментарием:

CREATE TABLE table_with_comment
(
    `k` UInt64,
    `s` String
)
ENGINE = Memory()
COMMENT 'Временная таблица';

Чтобы изменить комментарий таблицы:

ALTER TABLE table_with_comment 
MODIFY COMMENT 'новый комментарий к таблице';

Чтобы просмотреть изменённый комментарий:

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

┌─comment────────────────┐
│ новый комментарий к таблице │
└────────────────────────┘

Чтобы удалить комментарий таблицы:

ALTER TABLE table_with_comment MODIFY COMMENT '';

Чтобы проверить, что комментарий был удалён:

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

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

Замечания​

Для реплицируемых таблиц комментарий может отличаться на разных репликах. Изменение комментария применяется к одной реплике.

Эта функция доступна с версии 23.9. Она не работает в предыдущих версиях ClickHouse.

Связанный контент​