FAQ sobre migrações do Managed Postgres

Perguntas frequentes sobre migração de dados para o ClickHouse Managed Postgres.

Muitas dúvidas sobre como funciona a replicação do Postgres — incluindo colunas TOAST, slots de replicação, publicações, alterações de esquema e mapeamentos de tipos de dados — são abordadas no FAQ do ClickPipes for Postgres. As informações de lá também se aplicam às migrações do Managed Postgres.

​

Estou vendo um erro de “valor de entrada inválido para enum” durante a replicação

Esse erro ocorre quando o Postgres de origem tem um valor de enum que não existe no Managed Postgres de destino. A replicação lógica não propaga automaticamente os comandos ALTER TYPE ... ADD VALUE, então novos valores de enum adicionados na origem após a configuração inicial do esquema farão com que as inserções falhem no destino.

Para corrigir isso, adicione o valor ausente ao tipo enum no Postgres de destino:

ALTER TYPE your_enum_type ADD VALUE 'new_value';

Substitua your_enum_type pelo nome do seu tipo Enum e 'new_value' pelo valor ausente na mensagem de erro.

​

Estou recebendo um erro de violação de restrição de unicidade durante a replicação

Violações de restrição de unicidade podem ocorrer durante a replicação lógica quando a ordem da replicação causa um conflito com uma restrição de unicidade já existente no destino. Isso pode acontecer em workloads de CDC que envolvem a reprodução de operações que violam temporariamente a unicidade antes que uma atualização posterior resolva o problema.

Para desbloquear a replicação, remova a restrição de unicidade no Postgres de destino:

ALTER TABLE your_table DROP CONSTRAINT your_constraint_name;

Você pode encontrar o nome da restrição executando:

SELECT conname, conrelid::regclass
FROM pg_constraint
WHERE contype = 'u';

Adicione novamente a constraint durante a transição final, quando a replicação estiver concluída e a origem não estiver mais ativa:

ALTER TABLE your_table ADD CONSTRAINT your_constraint_name UNIQUE (column1, column2);