> ## 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 do ALTER

# ALTER

A maioria das consultas `ALTER TABLE` modifica configurações da tabela ou dados:

| Modificador                                                                |
| -------------------------------------------------------------------------- |
| [COLUMN](/pt-BR/reference/statements/alter/column)                         |
| [PARTITION](/pt-BR/reference/statements/alter/partition)                   |
| [DELETE](/pt-BR/reference/statements/alter/delete)                         |
| [UPDATE](/pt-BR/reference/statements/alter/update)                         |
| [ORDER BY](/pt-BR/reference/statements/alter/order-by)                     |
| [INDEX](/pt-BR/reference/statements/alter/skipping-index)                  |
| [CONSTRAINT](/pt-BR/reference/statements/alter/constraint)                 |
| [TTL](/pt-BR/reference/statements/alter/ttl)                               |
| [STATISTICS](/pt-BR/reference/statements/alter/statistics)                 |
| [APPLY DELETED MASK](/pt-BR/reference/statements/alter/apply-deleted-mask) |
| [APPLY PATCHES](/pt-BR/reference/statements/alter/apply-patches)           |

<Note>
  A maioria das consultas `ALTER TABLE` é suportada apenas para tabelas [\*MergeTree](/pt-BR/reference/engines/table-engines/mergetree-family), [Merge](/pt-BR/reference/engines/table-engines/special/merge) e [Distributed](/pt-BR/reference/engines/table-engines/special/distributed).
</Note>

Estas instruções `ALTER` manipulam views:

| Instrução                                                              | Descrição                                                                                   |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [ALTER TABLE ... MODIFY QUERY](/pt-BR/reference/statements/alter/view) | Modifica a estrutura de uma [visão materializada](/pt-BR/reference/statements/create/view). |

Estas instruções `ALTER` modificam entidades relacionadas ao Controle de Acesso Baseado em Funções:

| Instrução                                                              |
| ---------------------------------------------------------------------- |
| [USER](/pt-BR/reference/statements/alter/user)                         |
| [ROLE](/pt-BR/reference/statements/alter/role)                         |
| [QUOTA](/pt-BR/reference/statements/alter/quota)                       |
| [ROW POLICY](/pt-BR/reference/statements/alter/row-policy)             |
| [SETTINGS PROFILE](/pt-BR/reference/statements/alter/settings-profile) |

| Instrução                                                                    | Descrição                                                                                                |
| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [ALTER TABLE ... MODIFY COMMENT](/pt-BR/reference/statements/alter/comment)  | Adiciona, modifica ou remove comentários na tabela, independentemente de já terem sido definidos ou não. |
| [ALTER NAMED COLLECTION](/pt-BR/reference/statements/alter/named-collection) | Modifica [coleções nomeadas](/pt-BR/concepts/features/configuration/server-config/named-collections).    |

<div id="mutations">
  ## Mutações
</div>

Consultas `ALTER` destinadas a manipular dados de tabelas são implementadas por meio de um mecanismo chamado "mutações", principalmente [ALTER TABLE ... DELETE](/pt-BR/reference/statements/alter/delete) e [ALTER TABLE ... UPDATE](/pt-BR/reference/statements/alter/update). Elas são processos assíncronos em segundo plano, semelhantes às mesclagens em tabelas [MergeTree](/pt-BR/reference/engines/table-engines/mergetree-family), que produzem novas versões "mutadas" das partes.

Para tabelas `*MergeTree`, as mutações são executadas por **reescrita de partes de dados inteiras**.
Não há atomicidade — as partes são substituídas por partes mutadas assim que ficam prontas, e uma consulta `SELECT` iniciada durante uma mutação verá dados de partes que já foram mutadas junto com dados de partes que ainda não foram mutadas.

As mutações são totalmente ordenadas pela ordem de criação e são aplicadas a cada parte nessa ordem. As mutações também têm uma ordenação parcial em relação às consultas `INSERT INTO`: os dados inseridos na tabela antes de a mutação ser enviada serão mutados, e os dados inseridos depois disso não serão mutados. Observe que as mutações não bloqueiam inserts de forma alguma.

Uma consulta de mutação retorna imediatamente após a entrada da mutação ser adicionada (no caso de tabelas replicadas, ao ZooKeeper; no caso de tabelas não replicadas, ao sistema de arquivos). A mutação em si é executada de forma assíncrona usando as configurações do perfil do sistema. Para acompanhar o progresso das mutações, você pode usar a tabela [`system.mutations`](/pt-BR/reference/system-tables/mutations). Uma mutação enviada com sucesso continuará a ser executada mesmo que os servidores ClickHouse sejam reiniciados. Não há como reverter a mutação depois que ela é enviada, mas, se a mutação ficar travada por algum motivo, ela pode ser cancelada com a consulta [`KILL MUTATION`](/pt-BR/reference/statements/kill#kill-mutation).

As entradas de mutações concluídas não são excluídas imediatamente (o número de entradas preservadas é determinado pelo parâmetro do motor de armazenamento `finished_mutations_to_keep`). Entradas de mutação mais antigas são excluídas.

<div id="synchronicity-of-alter-queries">
  ## Sincronia das consultas `ALTER`
</div>

Para tabelas não replicadas, todas as consultas `ALTER` são executadas de forma síncrona. Para tabelas replicadas, a consulta apenas adiciona instruções para as ações apropriadas ao `ZooKeeper`, e as próprias ações são executadas assim que possível. No entanto, a consulta pode aguardar a conclusão dessas ações em todas as réplicas.

Para consultas `ALTER` que criam mutações (por exemplo, entre elas `UPDATE`, `DELETE`, `MATERIALIZE INDEX`, `MATERIALIZE PROJECTION`, `MATERIALIZE COLUMN`, `APPLY DELETED MASK`, `APPLY PATCHES`, `CLEAR STATISTIC`, `MATERIALIZE STATISTIC`), a sincronia é definida pela configuração [mutations\_sync](/pt-BR/reference/settings/session-settings#mutations_sync).

Para outras consultas `ALTER` que apenas modificam os metadados, você pode usar a configuração [alter\_sync](/pt-BR/reference/settings/session-settings#alter_sync) para configurar a espera.

Você pode especificar por quanto tempo (em segundos) aguardar que réplicas inativas executem todas as consultas `ALTER` com a configuração [replication\_wait\_for\_inactive\_replica\_timeout](/pt-BR/reference/settings/session-settings#replication_wait_for_inactive_replica_timeout).

<Note>
  Para todas as consultas `ALTER`, se `alter_sync = 2` e algumas réplicas permanecerem inativas por mais tempo do que o especificado na configuração `replication_wait_for_inactive_replica_timeout`, uma exceção `UNFINISHED` será lançada.
</Note>

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

* Blog: [Como lidar com atualizações e exclusões no ClickHouse](https://clickhouse.com/blog/handling-updates-and-deletes-in-clickhouse)