> ## 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.
# Migre para o Managed Postgres usando pg_dump e pg_restore
> Saiba como migrar seus dados do PostgreSQL para o ClickHouse Managed Postgres usando pg_dump e pg_restore
export const Image = ({img, alt, size}) => {
return
;
};
export const galaxyOnClick = eventName => () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
Este guia fornece instruções passo a passo sobre como migrar seu banco de dados PostgreSQL para o ClickHouse Managed Postgres usando os utilitários `pg_dump` e `pg_restore`.
## Pré-requisitos
* Acesso ao seu banco de dados PostgreSQL de origem.
* `pg_dump` e `pg_restore` instalados na máquina local. Eles normalmente são incluídos nas instalações do PostgreSQL. Caso contrário, você pode baixá-los no [site oficial do PostgreSQL](https://www.postgresql.org/download/).
## A configuração
Para seguir as etapas, vamos usar como exemplo um banco de dados Postgres no RDS como banco de dados de origem. Algo assim:
Eis o ambiente com que vamos trabalhar:
* Duas tabelas — `events` e `users`. `events` tem um milhão de linhas, e `users` tem mil linhas.
* `events` tem um índice.
* Uma view sobre a tabela `events`.
* Duas sequências
## Crie um dump do banco de dados de origem
Agora vamos usar `pg_dump` para gerar um arquivo de dump com os objetos acima. É um comando simples:
```shell theme={null}
pg_dump \
-d 'postgresql://:@:/' \
--format directory \
-f rds-dump
```
Aqui:
* Substitua ``, ``, ``, `` e `` pelas credenciais do seu banco de dados de origem. A maioria dos provedores de Postgres fornece uma string de conexão que você pode usar diretamente.
* `--format directory` especifica que queremos o dump no formato de diretório, que é adequado para o `pg_restore`.
* `-f rds-dump` especifica o diretório de saída dos arquivos de dump. Observe que esse diretório será criado automaticamente e não deve existir previamente.
* Você também pode paralelizar o processo de dump adicionando a flag `--jobs`, seguida do número de jobs paralelos que deseja executar. Para mais detalhes, consulte a [documentação do pg\_dump](https://www.postgresql.org/docs/current/app-pgdump.html).
Você pode testar esse processo uma vez para ter uma noção de quanto tempo ele leva e do tamanho do dump.
Veja como é a execução desse comando:
## Migre o dump para o ClickHouse Managed Postgres
Agora que temos o arquivo de dump, podemos restaurá-lo na nossa instância do ClickHouse Managed Postgres usando `pg_restore`.
### Crie uma instância do Managed Postgres
Primeiro, certifique-se de ter uma instância do Managed Postgres pronta, de preferência na mesma região da instância de origem. Você pode seguir o guia rápido [aqui](/pt-BR/products/managed-postgres/quickstart#create-postgres-database). Veja o que vamos provisionar neste guia:
### Restaurar o dump
Agora, de volta à nossa máquina local, podemos usar o comando `pg_restore` para restaurar o dump em nossa instância do Managed Postgres:
```shell theme={null}
pg_restore \
-d 'postgresql://:@:5432/' \
--verbose \
rds-dump
```
Você pode obter a string de conexão da sua instância do Managed Postgres no console do ClickHouse Cloud, conforme explicado de forma bem simples [aqui](/pt-BR/products/managed-postgres/connection).
Aqui também há algumas flags que vale a pena observar:
* `--verbose` fornece uma saída detalhada durante o processo de restore.
* Você também pode usar a flag `--jobs` aqui para paralelizar o processo de restore. Para mais detalhes, consulte a [documentação do pg\_restore](https://www.postgresql.org/docs/current/app-pgrestore.html).
No nosso caso, fica assim:
## Verifique a migração
Quando o processo de restauração for concluído, você poderá se conectar à sua instância do Managed Postgres e verificar se todos os seus dados e objetos foram migrados com sucesso. Você pode usar qualquer cliente PostgreSQL para se conectar e executar consultas.
Veja como fica nossa configuração do Managed Postgres após a migração:
Vemos que todas as nossas tabelas, índices, views e sequências estão intactos, e que as contagens de dados correspondem.
## Considerações
* Certifique-se de que as versões do PostgreSQL dos bancos de dados de origem e de destino sejam compatíveis.
Usar uma versão do pg\_dump mais antiga que a do servidor de origem pode causar ausência de recursos ou problemas na restauração. O ideal é usar a mesma versão principal do pg\_dump da origem ou uma versão mais recente.
* Bancos de dados grandes podem levar bastante tempo para gerar o dump e restaurar.
Planeje-se adequadamente para minimizar a indisponibilidade e considere usar dumps/restaurações em paralelo (`--jobs`) quando houver suporte.
* Observe que pg\_dump / pg\_restore não replicam todos os objetos relacionados ao banco de dados nem todo o estado de runtime.
Isso inclui roles e associações de roles, slots de replicação, configuração no nível do servidor (por exemplo, postgresql.conf, pg\_hba.conf), tablespaces e estatísticas de runtime.
## Próximas etapas
Parabéns! Você migrou com sucesso seu banco de dados PostgreSQL para o ClickHouse Managed Postgres usando `pg_dump` e `pg_restore`. Agora você já pode explorar os recursos do Managed Postgres e a integração com o ClickHouse. Aqui está um guia de início rápido de 10 minutos para ajudar você a começar:
* [Guia de início rápido do Managed Postgres](/pt-BR/products/managed-postgres/quickstart)