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

> Documentation de ALTER TABLE ... MODIFY COMMENT, qui permet d’ajouter, de modifier ou de supprimer le commentaire d’une table

# ALTER TABLE ... MODIFY COMMENT

Ajoute, modifie ou supprime le commentaire d’une table, qu’il ait été défini
auparavant ou non. La modification du commentaire est répercutée à la fois dans [`system.tables`](/fr/reference/system-tables/tables)
et dans la requête `SHOW CREATE TABLE`.

<div id="syntax">
  ## Syntaxe
</div>

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

<div id="examples">
  ## Exemples
</div>

Pour créer une table avec un commentaire :

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

Pour modifier le commentaire de la table :

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

Pour afficher le commentaire modifié :

```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 │
└────────────────────────┘
```

Pour supprimer le commentaire de la table :

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

Pour vérifier que le commentaire a bien été supprimé :

```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">
  ## Points à noter
</div>

Pour les tables Replicated, le commentaire peut varier d'une réplique à l'autre.
La modification du commentaire ne s'applique qu'à une seule réplique.

Cette fonctionnalité est disponible à partir de la version 23.9. Elle ne fonctionne pas dans les versions antérieures de
ClickHouse.

<div id="related-content">
  ## Contenu connexe
</div>

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