> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Cria uma tabela do ClickHouse com um dump de dados inicial de uma tabela do PostgreSQL e inicia o processo de replicação.
# motor de tabela MaterializedPostgreSQL
export const CloudNotSupportedBadge = () => {
return
;
};
Recomenda-se que os usuários do ClickHouse Cloud usem [ClickPipes](/pt-BR/integrations/clickpipes/home) para a replicação do PostgreSQL para o ClickHouse. Isso oferece suporte nativo a Change Data Capture (CDC) de alto desempenho para PostgreSQL.
Cria uma tabela do ClickHouse com um dump inicial dos dados de uma tabela do PostgreSQL e inicia o processo de replicação; ou seja, executa uma tarefa em segundo plano para aplicar novas alterações à medida que elas ocorrem na tabela do PostgreSQL no banco de dados PostgreSQL remoto.
Este motor de tabela é experimental. Para usá-lo, defina `allow_experimental_materialized_postgresql_table` como 1 em seus arquivos de configuração ou usando o comando `SET`:
```sql theme={null}
SET allow_experimental_materialized_postgresql_table=1
```
Se for necessária mais de uma tabela, é altamente recomendável usar o motor de banco de dados [MaterializedPostgreSQL](/pt-BR/reference/engines/database-engines/materialized-postgresql) em vez do motor de tabela e usar a configuração `materialized_postgresql_tables_list`, que especifica as tabelas a serem replicadas (também será possível adicionar o `schema` do banco de dados). Isso será muito melhor em termos de CPU, com menos conexões e menos slots de replicação no banco de dados PostgreSQL remoto.
## Criando uma tabela
```sql theme={null}
CREATE TABLE postgresql_db.postgresql_replica (key UInt64, value UInt64)
ENGINE = MaterializedPostgreSQL('postgres1:5432', 'postgres_database', 'postgresql_table', 'postgres_user', 'postgres_password')
PRIMARY KEY key;
```
**Parâmetros do motor**
* `host:port` — Endereço do servidor PostgreSQL.
* `database` — Nome do banco de dados remoto.
* `table` — Nome da tabela remota.
* `user` — Usuário do PostgreSQL.
* `password` — Senha do usuário.
## Requisitos
1. A configuração [wal\_level](https://www.postgresql.org/docs/current/runtime-config-wal.html) deve ter o valor `logical`, e o parâmetro `max_replication_slots` deve ter valor de pelo menos `2` no arquivo de configuração do PostgreSQL.
2. Uma tabela com o motor `MaterializedPostgreSQL` deve ter uma chave primária — a mesma de um índice de identidade de réplica (por padrão, a chave primária) de uma tabela PostgreSQL (consulte [detalhes sobre o índice de identidade de réplica](/pt-BR/reference/engines/database-engines/materialized-postgresql#requirements)).
3. Somente o banco de dados [Atomic](https://en.wikipedia.org/wiki/Atomicity_\(database_systems\)) é permitido.
4. O motor de tabela `MaterializedPostgreSQL` funciona apenas com versões do PostgreSQL >= 11, pois a implementação exige a função do PostgreSQL [pg\_replication\_slot\_advance](https://pgpedia.info/p/pg_replication_slot_advance.html).
## Colunas virtuais
* `_version` — Contador de transações. Tipo: [UInt64](/pt-BR/reference/data-types/int-uint).
* `_sign` — Marca de exclusão. Tipo: [Int8](/pt-BR/reference/data-types/int-uint). Valores possíveis:
* `1` — A linha não foi excluída,
* `-1` — A linha foi excluída.
Essas colunas não precisam ser adicionadas quando uma tabela é criada. Elas sempre podem ser acessadas na consulta `SELECT`.
A coluna `_version` corresponde à posição de `LSN` no `WAL`, portanto pode ser usada para verificar o quão atualizada está a replicação.
```sql theme={null}
CREATE TABLE postgresql_db.postgresql_replica (key UInt64, value UInt64)
ENGINE = MaterializedPostgreSQL('postgres1:5432', 'postgres_database', 'postgresql_replica', 'postgres_user', 'postgres_password')
PRIMARY KEY key;
SELECT key, value, _version FROM postgresql_db.postgresql_replica;
```
A replicação de valores [**TOAST**](https://www.postgresql.org/docs/9.5/storage-toast.html) não é suportada. O valor padrão do tipo de dados será usado.