> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação para as instruções ALTER DATABASE ... MODIFY COMMENT que permitem adicionar, modificar ou remover comentários em bancos de dados.

# Instruções ALTER DATABASE ... MODIFY COMMENT

Adiciona, modifica ou remove um comentário de banco de dados, independentemente de ele já ter sido definido ou não. A alteração do comentário é refletida tanto em [`system.databases`](/pt-BR/reference/system-tables/databases)
quanto na consulta `SHOW CREATE DATABASE`.

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

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

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

Para criar um `DATABASE` com comentário:

```sql title="Query" theme={null}
CREATE DATABASE database_with_comment ENGINE = Memory COMMENT 'The temporary database';
```

Para alterar o comentário:

```sql title="Query" theme={null}
ALTER DATABASE database_with_comment 
MODIFY COMMENT 'new comment on a database';
```

Para ver o comentário modificado:

```sql title="Query" theme={null}
SELECT comment 
FROM system.databases 
WHERE name = 'database_with_comment';
```

```text title="Response" theme={null}
┌─comment─────────────────┐
│ new comment on database │
└─────────────────────────┘
```

Para remover o comentário do banco de dados:

```sql title="Query" theme={null}
ALTER DATABASE database_with_comment 
MODIFY COMMENT '';
```

Para verificar se o comentário foi removido:

```sql title="Query" theme={null}
SELECT comment 
FROM system.databases 
WHERE  name = 'database_with_comment';
```

```text title="Response" theme={null}
┌─comment─┐
│         │
└─────────┘
```

<div id="related-content">
  ## Conteúdo relacionado
</div>

* cláusula [`COMMENT`](/pt-BR/reference/statements/create/table#comment-clause)
* [`ALTER TABLE ... MODIFY COMMENT`](/pt-BR/reference/statements/alter/comment)