Guia de Atualização de Versão Principal do OCI Database with PostgreSQL

• pg_dump e pg_restore são ferramentas de backup lógico.
• Adequado para atualizações de versão principal.
• Requer tempo de inatividade durante o switchover final.
• As atribuições sempre devem ser tratadas separadamente.

O processo de atualização usando pg_dump e pg_restore consiste nas etapas a seguir.

1. Etapa 1: Despejar Objetos Globais (Funções)

   Essa etapa ajuda a garantir que todas as funções, permissões e controles de acesso sejam preservados, permitindo que os usuários e aplicativos mantenham o acesso consistente após o upgrade.

2. Etapa 2: Despejar o Banco de Dados

   Esta etapa cria um backup lógico completo do banco de dados, fornecendo uma maneira confiável de transferir dados para o ambiente atualizado.

3. Etapa 3: Modificar Arquivo de Dump Global

   Esta etapa nos permite revisar e ajustar o dump conforme necessário, ajudando a garantir a compatibilidade com a versão de destino do PostgreSQL e um processo de restauração mais suave.

4. Etapa 4: Restaurar Objetos Globais

   A restauração de funções primeiro ajuda a garantir que os usuários e permissões apropriados estejam em vigor antes da reintrodução dos dados, oferecendo suporte a um ambiente consistente e seguro.

5. Etapa 5: Restaurar o banco de dados

   Esta etapa traz os dados para o sistema atualizado, completando a transição e tornando o banco de dados pronto para uso na nova versão do PostgreSQL.

• Usar valores -j mais altos com base na CPU disponível
• Use -Z0 durante o dump para obter um desempenho mais rápido
• Garanta capacidade suficiente de E/S de disco
• Monitorar o progresso da restauração usando logs detalhados

Após concluir a restauração, execute as tarefas a seguir.

• Verificar contagens de linhas

  Essa tarefa ajuda a confirmar se todos os dados foram migrados com sucesso e se não há discrepâncias entre os bancos de dados de origem e de destino.

• Verifique a conectividade do aplicativo

  Esta tarefa garante que os aplicativos possam se conectar e interagir com o banco de dados atualizado conforme esperado.

• Validar atribuições e permissões

  Essa tarefa ajuda a confirmar se os usuários e as funções têm o acesso e os privilégios apropriados no novo ambiente.

• Execute o comando a seguir para cada banco de dados

  VACUUM ANALYZE <database_name>;

  Esse comando ajuda a atualizar as estatísticas internas usadas pelo planejador de consultas, permitindo que o OCI PostgreSQL gere planos de execução mais eficientes com base nos dados atuais. Ele também pode ajudar a otimizar o desempenho geral após a restauração, especialmente para bancos de dados ou cargas de trabalho maiores com consultas complexas.

• Se ambos os sistemas de banco de dados estiverem dentro da mesma VCN, a conectividade estará automaticamente disponível.
• Se os bancos de dados estiverem em VCNs diferentes dentro da mesma região, configure o LPG (Local Peering Gateway) para estabelecer comunicação.
• Se os bancos de dados estiverem em VCNs diferentes dentro da região diferente, configure o Gateway de Roteamento Dinâmico (DRG) para estabelecer comunicação.

Execute as seguintes etapas nos bancos de dados de origem (versão anterior) e destino (versão posterior):

1. Acesse a Console do Oracle Cloud e navegue até o sistema de banco de dados do OCI PostgreSQL.
2. Modifique a configuração acessando o arquivo de configuração.
3. Selecione Copiar Configuração e atualize os parâmetros necessários. Em Variáveis do Usuário (Leitura/Gravação):
   • wal_level = logical
   • track_commit_timestamp = 1
4. Ativar Extensão: em Configurar Extensões, selecione pglogical e crie a configuração.
5. Navegue até o sistema de banco de dados, selecione Editar em Configuração e aplique a configuração criada anteriormente ao sistema de banco de dados.

   O estado do sistema de banco de dados é inicialmente Atualizando. Aguarde até que ele se torne Ativo antes de continuar.

   Essa configuração prepara ambos os ambientes para replicação lógica ativando as definições e extensões necessárias, permitindo que o pglogical capture e sincronize alterações de forma confiável entre os bancos de dados de origem e de destino durante o processo de upgrade.

6. Depois que o sistema de banco de dados estiver ativo, conecte-se ao banco de dados e verifique as extensões ativadas usando a consulta a seguir.

   SHOW oci.admin_enabled_extensions;

7. Crie a extensão pglogical usando o seguinte comando:

   CREATE EXTENSION pglogical;

Faça log-in como usuário administrador (o usuário especificado durante a criação do banco de dados OCI PostgreSQL) e conceda os privilégios necessários para ativar a replicação lógica.

alter role xxx with replication; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ; 
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxx é o exemplo de usuário criado durante o provisionamento do sistema de banco de dados.

Faça log-in como usuário administrador (o usuário especificado durante a criação do banco de dados OCI PostgreSQL) e conceda os privilégios necessários para ativar a replicação lógica.

alter role xxx with replication;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ;
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxx é o exemplo de usuário criado durante a configuração do banco de dados.

Antes de continuar, certifique-se de que:

• Todos os esquemas e objetos necessários existem no destino

  Os itens incluem esquemas, tabelas, índices, extensões e quaisquer objetos de banco de dados necessários. Ter essas informações em vigor ajuda a garantir que as operações de replicação ou restauração possam prosseguir sem erros de dependências ausentes. A existência pode ser confirmada comparando listagens de esquema (por exemplo, usando \dn e \dt no psql) e validando se as extensões necessárias estão instaladas na origem e no destino.

• A estrutura do banco de dados corresponde à origem

  O banco de dados de destino deve se alinhar de perto com a origem em termos de definições de esquema, nomes de objeto e estrutura geral. Essa consistência ajuda a suportar uma migração de dados tranquila e reduz a probabilidade de conflitos ou inconsistências durante a sincronização. Verifique revisando definições de esquema (como o uso de pg_dump --schema-only) ou comparando estruturas de tabela e contagens de objetos entre os sistemas de origem e de destino.

1. Crie o nó do assinante no banco de dados de destino:

   SELECT pglogical.create_node(node_name := 'subscriber1', dsn := 'host=<target_database_fqdn> port=5432 user=xxx password=xxxxx dbname=pglogical_target');

   • node_name: Defina o nome do assinante no banco de dados de destino.
   • host: Informe o nome de domínio totalmente qualificado (FQDN) do banco de dados de destino.
   • port_number: Informe a porta na qual o banco de dados de destino está sendo executado.
   • database_name: Forneça o nome do banco de dados em que a assinatura será criada
2. Crie a assinatura para iniciar os processos de sincronização e replicação em segundo plano:

   SELECT pglogical.create_subscription(subscription_name := 'subscription1', provider_dsn := 'host=<source_database_fqdn> port=5432 user=xxx password=xxxxxx dbname=pglogical_source sslmode=require');

   • subscription_name: Forneça o nome da assinatura.
   • host: Fornecer o FQDN do banco de dados de origem.
   • port_number: Forneça a porta na qual o banco de dados de destino está sendo executado.
   • database_name: Informe o nome do banco e dados de origem.

1. Verifique o status da assinatura (destino): Execute a instrução a seguir para verificar o status da sua assinatura no banco de dados de destino.

   SELECT * FROM pglogical.show_subscription_status();

2. Verifique o status da replicação (origem): execute a instrução a seguir para verificar o status da replicação no banco de dados de origem.

   SELECT * FROM pg_stat_replication;

Se ambas as verificações indicarem um status ativo sem atraso ou alterações pendentes, esse resultado sugerirá que a replicação foi concluída e que o banco de dados de destino está totalmente sincronizado com a origem.

Para obter mais informações sobre o pglogical, incluindo etapas e explicações detalhadas, consulte Sincronização entre regiões do OCI Database with PostgreSQL usando a Extensão pglógica