ALTER TABLE ... MODIFY COMMENT

Documentación de ALTER TABLE … MODIFY COMMENT, que permite añadir, modificar o eliminar comentarios de tablas

Añade, modifica o elimina el comentario de una tabla, independientemente de si se había establecido antes o no. El cambio en el comentario se refleja tanto en system.tables como en la consulta SHOW CREATE TABLE.

​

Sintaxis

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

​

Ejemplos

Para crear una tabla con un comentario:

Query

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

Para modificar el comentario de la tabla:

Query

ALTER TABLE table_with_comment 
MODIFY COMMENT 'new comment on a table';

Para ver el comentario modificado:

Query

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

Response

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

Para eliminar el comentario de la tabla:

Query

ALTER TABLE table_with_comment MODIFY COMMENT '';

Para verificar que se eliminó el comentario:

Query

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

Response

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

​

Consideraciones

Para las tablas Replicated, el comentario puede ser diferente en distintas réplicas. Al modificar el comentario, el cambio solo se aplica a una única réplica.

La funcionalidad está disponible desde la versión 23.9. No funciona en versiones anteriores de ClickHouse.

​

Contenido relacionado

• cláusula COMMENT
• ALTER DATABASE ... MODIFY COMMENT