Fazer upgrade para uma nova versão principal

Escolha uma opção de atualização:

Nos dois últimos caminhos, a nova implantação não recebe as alterações que chegam à origem após a promoção ou após o backup. Ensaie e valide a nova versão primeiro. Antes da troca definitiva, interrompa as gravações na fonte. Em seguida, promova a réplica ou faça o backup e altere os detalhes de conexão do seu aplicativo para a nova implantação.

Encontre as versões disponíveis para novas implantações no catálogo, com ibmcloud cdb deployables-show ou por meio da API do /deployables.

Nos exemplos de API, substitua {region} pela região da implantação, {id} pelo nome do recurso na nuvem (CRN) da implantação codificado em URL, e <IAM_TOKEN> pelo seu token de acesso do Identity and Access Management (IAM).

Requisitos para a atualização

Compatibilidade do aplicativo

Teste o caminho de atualização escolhido em uma implantação de teste representativa antes de passar para a produção. Para um ensaio do IPMVU, restaure um backup recente para a versão de origem do PostgreSQL. Uma implantação possui dois ou três membros de dados: o principal e um ou dois membros de alta disponibilidade (HA). Dimensionar a implantação restaurada para o mesmo número de membros que a de produção, pois a fase de conversão leva mais tempo com um número maior de membros de alta disponibilidade. Certifique-se de que a implantação restaurada tenha um backup completo e, em seguida, atualize-a para o destino pretendido. Verifique as consultas do aplicativo, os trabalhos em segundo plano, os drivers, as extensões e os conjuntos de conexões. Registre o desempenho e por quanto tempo seus aplicativos apresentam erros de leitura exclusiva e falhas de conexão, para comparação posterior.

Analise as notas de lançamento de todas as versões principais posteriores à sua versão de origem, até a versão de destino, inclusive. Verifique também as alterações nos privilégios das funções.

A atualização não mantém os carimbos de data e hora dos commits. Após a atualização, a função pg_xact_commit_timestamp() retorna NULL para todas as transações que foram confirmadas antes da atualização. Se seus aplicativos lerem carimbos de data e hora de confirmação, copie os valores necessários para uma coluna da tabela antes de realizar a atualização.

Extensões e outros objetos

Conclua os preparativos necessários nas seções a seguir antes de realizar a atualização. Para um IPMVU, prepare a implantação que você deseja atualizar. Para as réplicas somente leitura e os caminhos de restauração, prepare a implantação de origem antes de criar a réplica ou fazer o backup. Não é possível alterar uma réplica somente leitura, e uma restauração atualiza os dados na mesma operação. Planeje-se para eventuais dependências da aplicação em relação aos objetos que você remover.

Extensões

pg_repack

pg_repack não impede a atualização. Você não precisa excluí-la nem recriá-la antes ou depois da atualização.

old_snapshot

O old_snapshot módulo não está disponível no PostgreSQL 17 e versões posteriores. Ao atualizar d PostgreSQL e 16 ou versões anteriores para PostgreSQL 17 ou versões posteriores, o IPMVU remove old_snapshot de cada banco de dados antes que o modo somente leitura seja ativado. Se algum objeto depender de old_snapshot``, a atualização falhará. A remoção não será revertida caso a atualização falhe posteriormente.

Se o old_snapshot estiver instalado em qualquer banco de dados, entre em contato com o suporte para identificar os objetos dependentes antes de realizar a atualização. Para as demais opções de atualização, entre em contato com o suporte para agendar a remoção.

anon

Se o anon, versão 2, estiver instalado, execute estas etapas em cada banco de dados no qual ele estiver instalado. Execute-as como proprietário das tabelas mascaradas, como, por exemplo, admin. Para um IPMVU, o anon versão 2 faz com que a atualização falhe durante a fase de conversão, enquanto o banco de dados está indisponível, e todas as tentativas subsequentes falham da mesma forma. O anon versão 3 não requer essas etapas. A consulta de autoverificação 10 mostra a versão instalada em extversion.

Antes de remover as regras de mascaramento, bloqueie o acesso ao banco de dados para as funções mascaradas, que devem ter acesso apenas aos dados mascarados. Mantenha o acesso deles bloqueado até que você restaure e verifique as regras de mascaramento e os rótulos de função após a atualização.

  1. Registre as regras de mascaramento e as funções mascaradas para que você possa restaurá-las após a atualização.

    SELECT objtype, objname, label
    FROM pg_catalog.pg_seclabels
    WHERE provider = 'anon';
    
  2. Remova todas as regras de máscara.

    SELECT anon.remove_masks_for_all_columns();
    
  3. Remova a etiqueta mascarada de cada função listada na etapa 1. No PostgreSQL 16 e versões posteriores, essa ação requer a opção “ ADMIN ” na função. Para obter mais informações, consulte “Problemas com privilégios de funções durante atualizações de versão ”.

    SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
    
  4. Elimine a extensão anon com a opção em cascata. A opção “cascata” também remove objetos que dependem de anon``, como visualizações de máscara e funções. Anote as definições para que você possa recriá-las após a atualização.

    DROP EXTENSION anon CASCADE;
    
  5. Após a atualização, reative a opção “ anon ”, reaplique as regras de mascaramento e os rótulos de função registrados e verifique o mascaramento antes de restaurar o acesso às funções mascaradas.

PostGIS

Se você usar o PostGIS,, atualize-o em cada banco de dados que o utilize antes de realizar a atualização PostgreSQL:

SELECT postgis_extensions_upgrade();

Verifique a versão da extensão:

SELECT postgis_full_version();
earthdistance

Um IPMVU falha durante a fase de conversão se um índice ou uma coluna gerada armazenada utilizar uma função da versão earthdistance 1.1, como ll_to_earth(). Isso também se aplica quando o objeto o utiliza por meio de sua própria função SQL. PostgreSQL As versões 14 e 15 oferecem apenas a versão 1.1. Verifique com a consulta de autoverificação 13 em cada banco de dados e, em seguida, trate cada objeto listado:

  • No PostgreSQL 16 ou 17, atualize a extensão antes de fazer a atualização:

    ALTER EXTENSION earthdistance UPDATE;
    
  • No PostgreSQL 14 ou 15, se used_function for uma de suas próprias funções, adicione a configuração search_path a ela:

    ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog;
    
  • No PostgreSQL 14 ou 15, se used_function for uma função earthdistance, exclua o índice listado antes de realizar a atualização. Para manter os valores de uma coluna gerada listada, converta-a em uma coluna comum usando ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Após a atualização, execute o comando ` `ALTER EXTENSION earthdistance UPDATE; e, em seguida, recrie o que você removeu. Se o seu destino for o PostgreSQL 15, a atualização não terá efeito, e os objetos que você recriar bloquearão sua próxima atualização da mesma forma. Para evitar isso, atualize para o PostgreSQL 16 ou uma versão posterior.

pgRouting

Se sua implantação estiver executando o PostgreSQL 16 ou 17 e você fizer a atualização para o PostgreSQL 18, verifique cada banco de dados em que o pgRouting estiver instalado. PostgreSQL As 18 implantações não incluem a biblioteca pgRouting 3.5. Uma chamada IPMVU para PostgreSQL 18 falha nas verificações de compatibilidade, antes do início do modo somente leitura, enquanto qualquer função estiver utilizando essa biblioteca. Não espere nenhuma linha:

SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';

Se a consulta retornar uma linha, atualize para pgRouting a versão mais recente que sua implantação oferece antes de fazer a atualização e, em seguida, execute a consulta novamente:

ALTER EXTENSION pgrouting UPDATE;

pgRouting A versão 4.0 remove várias funções, como pgr_createTopology, pgr_analyzeGraph, e pgr_nodeNetwork, e altera outras. Teste suas aplicações com a versão 4.0, inicialmente em pgRouting um ambiente de teste. Caso precisem das funções removidas, entre em contato com o suporte antes de atualizar para o PostgreSQL 18. A partir do PostgreSQL 16, você também pode atualizar para o PostgreSQL 17, que inclui a biblioteca 3.5.

Funções SQL em índices, chaves de partição e colunas geradas

Durante a fase de conversão, um IPMVU recria a definição de cada índice, chave de partição e coluna gerada armazenada com um caminho de pesquisa vazio. Esta etapa falha se um desses objetos utilizar uma função do tipo “ LANGUAGE sql ” com um corpo de string que nomeie um objeto fora de pg_catalog sem seu esquema, seja diretamente ou por meio de uma restrição de verificação de domínio. As estatísticas estendidas têm o mesmo efeito em uma tabela que possui uma chave estrangeira. Em um índice, uma chamada que especifique o esquema ibm_extension, onde as extensões estão instaladas, também falha. A falha ocorre enquanto o banco de dados está indisponível, e todas as tentativas de repetição falham da mesma maneira.

Execute a consulta de autoverificação 12 em cada banco de dados. Para cada função listada, adicione uma configuração search_path que especifique todos os esquemas utilizados pelo corpo da função. Como alternativa, substitua o corpo da string por um corpo padrão do SQL. Execute essas instruções como proprietário da função. Por exemplo:

ALTER FUNCTION f_unaccent(text) SET search_path = ibm_extension, pg_catalog;
CREATE OR REPLACE FUNCTION f_unaccent(text) RETURNS text
  LANGUAGE sql IMMUTABLE PARALLEL SAFE STRICT
  RETURN ibm_extension.unaccent('ibm_extension.unaccent', $1);

Mantenha os resultados e outros atributos de cada função inalterados, pois os índices e as colunas geradas armazenam esses resultados, e as tabelas particionadas direcionam as linhas com base neles. Com a configuração “ search_path ”, o PostgreSQL não expande mais a função nas consultas que a chamam; portanto, essas consultas podem ficar mais lentas. Um órgão de padronização do SQL não protege as funções de corpo de string que ele chama; portanto, corrija essas funções também. Execute a consulta novamente até que ela não retorne nenhuma linha. Se a lista incluir uma função que não pertença a você, entre em contato com o suporte antes de fazer a atualização.

Se você fizer a atualização do PostgreSQL 16 ou versão anterior para o PostgreSQL 17 ou versão posterior, execute também a consulta de autoverificação 17. PostgreSQL 17 e, posteriormente, execute comandos de manutenção com um caminho de busca restrito. Uma função em qualquer linguagem de programação utilizada por um índice, uma visualização materializada ou estatísticas estendidas precisa, portanto, de sua própria configuração de “ search_path ”. Caso contrário, após a atualização, as chamadas ANALYZE, ` `REINDEX, CLUSTER, ` `VACUUM FULL e REFRESH MATERIALIZED VIEW falharão para os objetos afetados. Defina o caminho de pesquisa de cada função listada que nomeia objetos sem seu esquema, como no exemplo anterior. Para obter mais informações, consulte as notas de migração do PostgreSQL 17.

Objetos que utilizam nomes de sistema removidos

Cada versão principal remove ou renomeia algumas colunas do catálogo do sistema, funções e parâmetros de configuração. Por exemplo, a versão PostgreSQL 17 removeu as colunas de ponto de verificação de pg_stat_bgwriter, e a versão PostgreSQL 16 renomeou o parâmetro force_parallel_mode para debug_parallel_query. As verificações prévias não detectam objetos que utilizam esses nomes:

  • Se uma visão, uma visão materializada ou um agregado utilizar um nome removido, uma IPMVU falhará durante a fase de conversão. Uma função com um corpo em conformidade com o padrão SQL e uma função, função de papel ou configuração do banco de dados de um parâmetro removido têm o mesmo efeito.
  • Outras funções e procedimentos, tarefas do pg_cron e consultas de aplicativos que utilizam um nome removido apresentam falha ao serem executadas pela primeira vez na nova versão. Isso pode ocorrer antes que as gravações sejam retomadas.

Execute a consulta de autoverificação 14 em cada banco de dados. Altere ou remova cada objeto listado cuja versão do removed_in seja igual ou inferior à sua versão de destino. Verifique as configurações de função e do banco de dados com a consulta de autoverificação 7. Teste sua aplicação e suas consultas de monitoramento em uma implantação de teste da versão de destino.

Slots de replicação lógica

O IPMVU falha nas verificações prévias enquanto houver qualquer slot de replicação lógica, incluindo slots inativos e aqueles utilizados pelo wal2json. Não é possível recuperar um slot excluído, e um novo slot não inclui as alterações que o slot antigo mantinha. Antes de atualizar:

  1. Registre o nome de cada slot, o plug-in e o banco de dados com a consulta de autoverificação 2.

  2. Suspenda as gravações na fonte até que você restaure os consumidores após a atualização ou planeje ressincronizar os dados a jusante.

  3. Permita que os consumidores processem as alterações pendentes e, em seguida, cancele-as. Mantenha-as suspensas, com a reconexão automática desativada, até que a tarefa apareça como Concluída.

  4. Exclua cada slot com o ibmcloud cdb postgresql replication-slot-delete comando ou pela API “Excluir um slot de replicação lógica ”. O usuário do admin não pode excluir slots de replicação usando o SQL.

    ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME>
    
  5. Após a atualização, recrie os slots conforme descrito em “Configuração de wal2json ”.

wal2json é um plug-in de saída de decodificação lógica, e não uma extensão criada com o CREATE EXTENSION.

Assinaturas lógicas

Uma assinatura lógica recebe as alterações de um editor. Seu slot de replicação está no editor, por isso a consulta de slots não o exibe.

Se sua implantação estiver executando o PostgreSQL 16 ou uma versão anterior, o IPMVU falhará nas verificações prévias enquanto houver qualquer assinatura lógica, incluindo assinaturas desativadas. As atualizações a partir dessas versões não preservam o estado de sincronização de uma assinatura. Antes de fazer a atualização, combine com o proprietário da editora como remover e recriar cada assinatura e como ressincronizar os dados. Em seguida, exclua as assinaturas usando as funções de assinante. A função delete_subscription também encerra o slot da assinatura no editor e falha se o editor estiver inacessível ou se o slot não existir mais. Nesse caso, execute disable_subscription e, em seguida, subscription_slot_none antes de delete_subscription. Em seguida, peça ao proprietário do editor para liberar o slot, pois ele continua retendo os registros de transação no editor.

Se sua implantação estiver executando o PostgreSQL 17 ou uma versão posterior, as assinaturas podem ser mantidas, mas devem atender aos requisitos de atualização de replicação lógica da versão de destino. A atualização suporta, no máximo, 10 assinaturas. Se houver mais, ele falha nas verificações de compatibilidade antes mesmo de o modo somente leitura ser iniciado. Desative as assinaturas com disable_subscription antes de atualizar e reative-as com enable_subscription após a conclusão da atualização.

UNLOGGED tabelas e sequências

PostgreSQL não registra as alterações nas tabelas e sequências d UNLOGGED no log de transações. Ele não os replica para outros membros e os reinicializa após uma transição de failover ou uma restauração. Nenhuma das opções de atualização mantém seu conteúdo:

  • Um IPMVU os reinicializa ao reiniciar o serviço “ PostgreSQL ” com a nova versão e, novamente, ao alternar a função primária na fase de conclusão. Uma atualização com falha também pode zerá-los.
  • Uma réplica somente leitura promovida e um backup restaurado iniciam com as tabelas UNLOGGED vazias e as sequências UNLOGGED reinicializadas.

Após a atualização, as tabelas UNLOGGED ficam vazias e as sequências UNLOGGED são reinicializadas. Até que a tarefa apareça como “Concluída”, quaisquer alterações que você fizer nesses objetos também poderão ser perdidas. Antes de realizar a atualização, utilize a consulta de autoverificação 11 para identificar esses objetos em cada banco de dados e planeje como lidar com cada um deles.

  • Para preservar o conteúdo de uma tabela, converta-a com o comando ALTER TABLE <table_name> SET LOGGED;``. O comando SET LOGGED também converte os índices da tabela e as sequências a ela associadas. Converta uma tabela referenciada antes de converter quaisquer tabelas que a referenciem por meio de chaves estrangeiras. Como alternativa, exporte o conteúdo e recarregue-o depois que a tarefa aparecer como “Concluída ”.
  • Se uma sequência gerar valores para uma tabela registrada, converta-a com ALTER SEQUENCE <sequence_name> SET LOGGED;``. Caso contrário, feche os aplicativos que o utilizam até que a tarefa apareça como “Concluída ”. Em seguida, defina-o para um valor superior ao maior valor em uso com a função setval .

SET LOGGED reescreve a tabela e bloqueia as leituras e gravações até que a operação seja concluída. Além disso, gera aproximadamente a mesma quantidade de dados do log de transações que a tabela e seus índices ocupam. Converta tabelas grandes com bastante antecedência antes de enviar a atualização e utilize a consulta de autoverificação 5 para verificar se os logs de transação foram arquivados. Após a atualização, você poderá reconverter uma tabela usando o comando ALTER TABLE <table_name> SET UNLOGGED;``.

No caso de um IPMVU, uma tabela UNLOGGED , mesmo que esteja vazia, também faz com que o serviço reconstrua todos os membros de alta disponibilidade (HA), o que prolonga o tempo em que as gravações ficam bloqueadas. Para obter mais informações, consulte “Disponibilidade durante uma atualização ”. Para evitar essa reconstrução, converta todas as tabelas do tipo “ UNLOGGED ” ou elimine aquelas que não forem mais necessárias. O comando “ TRUNCATE ” não evita a reconstrução. As sequências do tipo “ UNLOGGED ” não causam uma reconstrução. Nos dias 16 e 17 de PostgreSQL, o comando SET LOGGED é, por si só, uma operação em massa que ainda pode exigir uma reconstrução; portanto, planeje-se para isso.

Atualização de versão principal sem remoção do sistema

Conclua a preparação e, em seguida, utilize a interface do usuário (UI), a API, a linha de comando (CLI) ou o procedimento do Terraform descrito abaixo.

Em um IPMVU, o serviço atualiza o servidor primário no local e atualiza cada membro do HA a partir de seus arquivos de dados existentes. Quando todos os membros do HA podem reutilizar seus arquivos de dados, as gravações ficam bloqueadas apenas por um breve período. A duração depende principalmente do número de objetos do banco de dados e do nível de atividade do banco de dados, e não da quantidade de dados armazenados.

Em algumas situações, o serviço passa a copiar todo o banco de dados para os membros do HA, o que mantém as gravações bloqueadas por muito mais tempo. Outras condições fazem com que a atualização falhe após o bloqueio das gravações. As verificações prévias não detectam essas condições; portanto, resolva-as antes de enviar a atualização. Para consultar a lista, veja “Condições que as verificações prévias não detectam ”.

Não é possível cancelar um IPMVU após o envio, nem é possível reverter a implantação já realizada. O serviço não realiza um backup de dados antes da atualização; portanto, crie e verifique primeiro um backup sob demanda.

Disponibilidade durante uma atualização

Um IPMVU é executado nas seguintes fases. As gravações são interrompidas quando a fase de somente leitura começa e retomadas quando o serviço sai do modo de somente leitura. As leituras também ficam indisponíveis durante a fase de conversão.

Fases e disponibilidade do IPMVU
Fase O que acontece Leituras Gravações
Verificações O serviço aguarda a conclusão das alterações de implantação pendentes e executa as verificações prévias. Ele verifica a compatibilidade da atualização no membro primário e nos membros de alta disponibilidade (HA) e suspende a transição automática para o membro de reserva. Disponível Disponível
Somente leitura O serviço torna as novas transações de leitura exclusiva em todos os bancos de dados e encerra todas as sessões dos clientes. Em seguida, ele aguarda até que os membros do HA e o arquivamento do log de transações fiquem em dia. Disponível Bloqueado
Conversão O serviço interrompe o PostgreSQL em todos os membros e atualiza o primário. Sempre que possível, ele atualiza cada membro do HA a partir dos arquivos de dados existentes desse membro. Indisponível Indisponível
Reinicialização O servidor primário atualizado é iniciado no modo somente leitura, e os membros do HA são iniciados. O serviço recria qualquer membro que não consiga reutilizar seus arquivos de dados a partir do primário atualizado. Disponível Bloqueado
Redige currículos O serviço desativa o modo somente leitura e encerra todas as sessões de clientes novamente. Disponível Disponível
Conclusão O serviço aguarda até que todos os membros do HA estejam em sincronia. Em seguida, o serviço reinicia os membros, um por um, para concluir a migração da implantação para a nova versão. Antes de reiniciar o primário, o serviço transfere a função de primário para outro membro, o que encerra as sessões dos clientes. Em seguida, o serviço remove os arquivos de atualização, coloca o backup pós-atualização na fila e marca as tarefas como “Concluídas ”. Disponível, exceto durante a transição Disponível, exceto durante a transição

O processo de reescrita é retomado depois que pelo menos um membro do HA tiver se atualizado e todos os demais membros do HA tiverem se atualizado ou estiverem em processo de reconstrução. O serviço reconstrói um membro de alta disponibilidade (HA) que não pode reutilizar seus arquivos de dados, copiando todo o banco de dados para ele. Se for necessário reconstruir todos os membros do HA, as gravações ficam bloqueadas até que a primeira reconstrução seja concluída. No caso de um banco de dados grande, isso pode levar horas. Uma implantação com dois membros de dados, que é a configuração padrão, possui apenas um membro de alta disponibilidade. Consequentemente, qualquer reconstrução bloqueia as gravações. Os membros da HA não podem reutilizar seus arquivos de dados nas seguintes situações:

  • Qualquer banco de dados contém uma tabela UNLOGGED , mesmo que esteja vazia. Em seguida, o serviço reinicializa todos os membros do HA. Verifique com a consulta de autoverificação 11 e consulte as tabelas e sequências d UNLOGGED.
  • A implantação é executada no PostgreSQL 16 ou 17, e as tabelas aumentaram de tamanho devido a operações em massa ou a muitas inserções ou atualizações simultâneas. As operações em massa incluem os comandos COPY, pg_restore, CREATE TABLE AS, CREATE MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW e ALTER TABLE, que reescrevem uma tabela, como, por exemplo, SET LOGGED. Não é possível verificar isso com antecedência; portanto, planeje uma reconstrução.

O serviço também pode reconstruir membros de alta disponibilidade (HA) por outros motivos que você não pode verificar com antecedência. Um teste em uma implantação de teste que você restaurar a partir de um backup pode não apresentar essa reconstrução.

Um membro de alta disponibilidade (HA) em processo de reconstrução mantém seus arquivos de dados anteriores até que a tarefa seja concluída. Por isso, ele requer espaço livre em disco pelo menos igual à quantidade de espaço que seus dados ocupam. Antes de enviar a atualização, certifique-se de que cada membro de dados utilize significativamente menos da metade do espaço em disco disponível. Verifique esse valor usando a métrica de espaço em disco utilizado. Embora a verificação prévia do espaço em disco permita até 90% de utilização do disco, a reconstrução de um membro de alta disponibilidade (HA) requer uma quantidade substancialmente maior de espaço livre. Caso contrário, a reconstrução pode ficar sem espaço em disco e falhar repetidamente. As gravações podem, então, permanecer bloqueadas por horas antes que a tarefa falhe. O dimensionamento automático e manual do disco fica em espera até que a atualização seja concluída; portanto, dimensione o disco antes de enviar a atualização. Uma reconstrução demorada também pode fazer com que a tarefa falhe após a retomada das gravações. Em ambos os casos, a implantação executa a versão de destino até que a equipe de suporte conclua a atualização. Preveja uma reconstrução na sua janela de manutenção.

Grava o resumo antes que a tarefa seja concluída. Para verificar se as gravações foram retomadas, execute SHOW default_transaction_read_only; em uma nova sessão. Retorna off após a retomada das gravações. As sessões dos clientes são encerradas quando o modo somente leitura é ativado, quando o PostgreSQL é interrompido para a conversão, quando as gravações são retomadas, durante a transição na fase de conclusão e quando o serviço restaura o acesso de gravação após uma falha.

Até que a tarefa apareça como “Concluída”, evite gravações em massa prolongadas, como grandes carregamentos de dados ou tarefas em lote. A fase de conclusão aguarda até que todos os membros do HA tenham reproduzido todas as alterações. Sob uma carga contínua e intensa de gravações, essa espera pode atingir o tempo limite, e a tarefa falha assim que as gravações são retomadas. O risco é maior enquanto um membro do HA ainda estiver sendo reconstruído. A implantação, então, executa a versão de destino sem um backup pós-atualização, e a equipe de suporte deve concluir a atualização.

Para verificar se a carga de gravação permite que os membros do HA se atualizem, execute a consulta a seguir no horário previsto para a atualização. Repita isso a cada segundo por alguns minutos, por exemplo, com o comando psql \watch 1. O serviço precisa que todos os membros da HA apresentem um “ 0 ” em “ replay_lag_bytes ” ao mesmo tempo. Se isso nunca ocorrer, reduza a carga de gravação antes de enviar a atualização.

SELECT application_name, state,
       pg_catalog.pg_wal_lsn_diff(pg_catalog.pg_current_wal_lsn(), replay_lsn) AS replay_lag_bytes
FROM pg_catalog.pg_stat_replication
ORDER BY application_name;

A atualização não atualiza as estatísticas do otimizador; portanto, as consultas podem optar por planos lentos até que você execute ANALYZE. As atualizações para o PostgreSQL s 15, 16 ou 17 não transferem as estatísticas. As atualizações para o PostgreSQL 18 transferem a maioria das estatísticas, mas não as estatísticas estendidas criadas com o `CREATE STATISTICS`, nem as estatísticas coletadas por extensões como o PostGIS. O processo “ `autovacuum` ” analisa uma tabela somente após um número suficiente de gravações e nunca analisa tabelas particionadas. Não esperar a conclusão da tarefa. Assim que o comando ` `SHOW default_transaction_read_only;` ` retornar ` `off, atualize as estatísticas conforme descrito na seção “Após a atualização ”.

O modo somente leitura define uma configuração padrão para novas transações. Isso não bloqueia o banco de dados. Uma sessão que defina default_transaction_read_only como off ou que inicie explicitamente uma transação de leitura e gravação ainda pode gravar. O mesmo vale para uma função cuja propriedade ` `default_transaction_read_only` ` está definida como ` `off. Comandos de manutenção como VACUUM, ANALYZE, REINDEX e CLUSTER também continuam funcionando. O modo somente leitura não interrompe um trabalho do pg_cron que já esteja em execução, nem uma assinatura ativada no PostgreSQL 17. Essas gravações podem fazer com que a atualização falhe. Antes de enviar a atualização, encerre os processos que anulam o modo somente leitura. Suspenda as tarefas agendadas que gravam ou executam comandos de manutenção, como as tarefas do pg_cron , e aguarde até que as tarefas em execução sejam concluídas. Reinicie-os conforme descrito na seção “Após a atualização ”.

As operações de leitura também podem gravar logs de transação durante o modo somente leitura; por exemplo, na primeira vez em que as consultas leem linhas após um carregamento em massa ou uma grande atualização. Essa atividade atrasa a recuperação que as fases de “somente leitura” e “reinício” aguardam; assim, as gravações permanecem bloqueadas por mais tempo, e a atualização pode falhar. Antes de enviar a atualização, execute o comando VACUUM nas tabelas que você carregou recentemente ou modificou significativamente.

Quando o serviço encerra uma sessão, um cliente que se conecta diretamente à implantação recebe o SQLSTATE 57P01 (admin_shutdown). Uma gravação em uma transação somente leitura falha com o SQLSTATE 25006 (read_only_sql_transaction). Durante a fase de conversão, uma nova conexão pode falhar com um erro de autenticação, como o SQLSTATE 28P01, mesmo que suas credenciais permaneçam inalteradas. Tente a conexão novamente após a conversão. Se esses erros persistirem depois que a tarefa for marcada como “Falha”, entre em contato com o suporte. Por meio de um gerenciador de pool de conexões, os aplicativos podem detectar outros erros de conexão.

Os clientes que aceitam apenas sessões de leitura e gravação não podem se conectar enquanto o modo somente leitura estiver ativado; portanto, as operações de leitura também ficam indisponíveis para eles até que as gravações sejam retomadas. Isso se aplica aos clientes do libpq que definem target_session_attrs=read-write e aos clientes do JDBC que definem targetServerType=primary ou master. Para manter as leituras disponíveis, use target_session_attrs=any ou primary com o libpq 14 ou versões posteriores. Para acessar o site JDBC, use targetServerType=any.

Os aplicativos devem lidar com falhas de conexão e erros de leitura exclusiva, restabelecer a conexão e repetir transações interrompidas somente quando for seguro. O uso de pool de conexões não elimina esses requisitos. O acesso ao aplicativo não é prova de que a tarefa de atualização foi concluída.

Backups e recuperação

O serviço não realiza um backup dos dados antes da atualização. Crie e verifique um backup sob demanda recente antes do IPMVU. Para retornar à versão original após uma atualização, restaure um backup ou ponto de recuperação anterior à atualização em uma nova implantação que execute a versão original. Defina a versão explicitamente, pois uma restauração a um ponto específico no tempo sem uma versão cria uma implantação que executa a versão atual. Essa opção exige que a versão de origem ainda esteja disponível para novas implantações. Leve em conta as alterações feitas desde então.

Após uma atualização bem-sucedida, o serviço coloca em fila uma cópia de segurança da implantação atualizada. O backup é executado separadamente após a conclusão da tarefa de atualização e pode não iniciar imediatamente. Esse primeiro backup na nova versão copia todo o banco de dados; portanto, pode levar várias horas no caso de um banco de dados grande. Verifique o status em “Backups e restauração ”. Caso haja falha, faça um backup sob demanda e entre em contato com o suporte técnico se as falhas persistirem. Uma falha no backup não reverte a atualização.

A recuperação em um ponto no tempo (PITR) não permite reproduzir transações que abrangem uma atualização de versão principal. É possível restaurar para um ponto no tempo anterior ao início da tarefa de atualização ou após a conclusão do primeiro backup da implantação atualizada. Não é oferecido suporte a restaurações para pontos de recuperação entre a atualização e a conclusão do backup pós-atualização. O serviço rejeita alguns desses pontos de recuperação, enquanto as restaurações para outros podem ser aceitas, mas falham durante o processo de restauração. Esse período sem suporte inclui o tempo após o reinício das gravações. Até que o backup pós-atualização seja concluído, as restaurações para o ponto de recuperação mais recente disponível também podem falhar, mesmo que o serviço aceite a solicitação de restauração.

Para manter a cobertura do PITR para alterações após a atualização, mantenha as gravações do aplicativo suspensas até que o backup pós-atualização seja concluído. Coloque-os em pausa em seus aplicativos. Quando as gravações são retomadas, a atualização redefine a variável default_transaction_read_only em todos os bancos de dados; portanto, uma configuração de somente leitura no nível do banco de dados não mantém as gravações suspensas.

Uma atualização com falha não coloca o backup na fila. O PITR pode ficar indisponível para pontos entre o início da tentativa e o próximo backup concluído. Após uma atualização malsucedida, se o SHOW server_version; informar a versão de origem e a implantação aceitar gravações, faça um backup sob demanda. Caso contrário, entre em contato com o suporte antes de fazer um backup ou outras alterações.

Os backups e pontos de recuperação anteriores à atualização pertencem à versão anterior e continuam sujeitos aos limites de retenção. Para obter mais informações, consulte o PITR.

As opções de “skip-backup” não são compatíveis com o comando PostgreSQL:, skip_backup na API, --skip-backup na CLI e version_upgrade_skip_backup no Terraform. As solicitações que permitem que isso aconteça falham. A API e a CLI retornam um erro, e os planos do Terraform falham.

Antes de Iniciar

Aplique esses requisitos tanto ao ambiente de teste quanto ao de produção:

  • Conclua a preparação do aplicativo, da extensão e da replicação, bem como a preparação do backup.

  • Resolva as condições que as verificações prévias não detectam e execute as consultas de autoverificação.

  • Certifique-se de que cada membro de dados utilize significativamente menos da metade do espaço em disco disponível, para que a reconstrução dos membros de alta disponibilidade (HA) não fique sem espaço. Para obter mais informações, consulte “Disponibilidade durante uma atualização ”.

  • Certifique-se de que a implantação tenha pelo menos um backup concluído. Até lá, o console desativa o botão “Atualizar versão principal ”, e a API rejeita a solicitação.

  • O IPMVU não está disponível em uma implantação de réplica somente leitura. Para atualizar uma réplica, promova-a por meio de uma atualização de versão.

  • Promova ou exclua todas as réplicas somente leitura da implantação, incluindo as réplicas em outras regiões, e aguarde a conclusão de cada operação. Uma réplica excluída permanece associada à implantação até ser excluída permanentemente. A atualização falha nas verificações prévias enquanto houver alguma réplica associada à implantação. Planeje os aplicativos que fazem leitura nessas réplicas. Para obter mais informações, consulte “Réplicas somente leitura” e “IPMVU ”.

  • Execute uma atualização por vez. O serviço rejeita uma nova solicitação de atualização enquanto outra tarefa de atualização estiver na fila ou em execução.

  • Se você tiver definido a configuração “ synchronous_commit ” da implantação como “ on ”, altere-a para “ local ” antes de enviar a atualização. Altere de volta depois que a tarefa aparecer como “Concluída ”. Com o on``, uma atualização malsucedida pode deixar todos os bancos de dados na modalidade somente leitura ou fazer com que as confirmações fiquem em espera até que a equipe de suporte recupere a implantação. A configuração da implantação é on se a consulta a seguir retornar on com a fonte configuration file:

    SELECT setting, source
    FROM pg_catalog.pg_settings
    WHERE name = 'synchronous_commit';
    
  • Escolha um destino entre os recursos da sua implantação. Você pode atualizar diretamente para qualquer versão posterior que apareça como uma transição de atualização, sem passar por versões intermediárias. Uma versão que você pode provisionar não é necessariamente um destino de atualização no local:

    ibmcloud cdb deployment-capability-show <NAME|CRN> versions
    

    Na saída, utilize o valor “ to_version ” de uma entrada da Transição de Atualização.

Verificações prévias e preparação

O serviço realiza as seguintes verificações antes de iniciar o modo somente leitura. Se uma verificação falhar, a tarefa exibirá a mensagem “Falha”, e a implantação permanecerá na versão atual sem bloquear as gravações. Se algum banco de dados tiver a opção “ default_transaction_read_only ” definida como “ on ”, uma verificação com falha também redefinirá essa configuração em todos os bancos de dados e encerrará todas as sessões dos clientes. A tarefa não informa qual verificação falhou; portanto, verifique cada item antes de enviar a atualização.

Verificações prévias do IPMVU
Verificar É aprovado quando Sua ação
Integridade da implantação Todos os membros de dados estão em operação, e cada membro de alta disponibilidade (HA) está recebendo dados do primário. Aguarde até que o dimensionamento, a manutenção e a reconstrução dos membros de alta disponibilidade sejam concluídos. Verifique por meio da consulta de autoverificação 1. Outras tarefas não falham nessa verificação, mas atrasam o início da atualização. Verifique as tarefas recentes ou liste as tarefas com ibmcloud cdb deployment-tasks-list. Se essa verificação continuar falhando, entre em contato com o suporte.
Espaço em disco Cada membro de dados utiliza, no máximo, 90% do espaço em disco que lhe foi alocado. Dimensionar o disco ou excluir os dados dos quais você não precisa mais. Os slots de replicação lógica não utilizados também podem armazenar logs de transação. Essa verificação permite até 90%, mas uma reconstrução dos membros do HA exige que cada membro de dados utilize bem menos da metade do seu espaço em disco. Consulte a seção “Disponibilidade durante uma atualização ”.
CPU, memória e E/S de disco Em cada membro de dados, a média de carga de 1 minuto do host é, no máximo, 90% de sua contagem de CPU, e o uso de memória do host é, no máximo, 90%. A utilização da E/S de disco também não ultrapassa 90%. Faça a atualização durante um período de baixa atividade ou envie a solicitação de atualização novamente mais tarde. O serviço mede a carga e a memória de todo o host, incluindo outras cargas de trabalho nele, e coleta amostras de E/S de disco ao longo de alguns segundos. A média de carga também inclui os processos que aguardam operações de E/S de disco. Seus valores podem, portanto, diferir das suas métricas de monitoramento, e dimensionar sua implantação pode não reduzi-los. Se essa verificação continuar falhando, entre em contato com o suporte.
Arquivamento do log de transações O arquivamento não está apresentando falhas, e não há mais do que 4 GB de logs de transação aguardando arquivamento. Reduza a taxa de gravação até que o acúmulo seja eliminado. Verifique por meio da consulta de autoverificação 5. A verificação também falha se um membro do HA tiver logs de transação pendentes, por exemplo, logo após uma failover. Se essa verificação continuar falhando, entre em contato com o suporte.
Replicação lógica Não existe nenhum slot de replicação lógico. No PostgreSQL 16 e versões anteriores, não há nenhuma assinatura lógica, incluindo as desativadas. Remova as ranhuras. No PostgreSQL 16 e versões anteriores, remova as assinaturas. No arquivo PostgreSQL 17, desative-os. Verifique com as consultas de autoavaliação 2 e 3.
Réplicas somente leitura e clientes de replicação A implantação não possui nenhuma réplica somente leitura associada, e nenhum cliente de replicação além dos membros de alta disponibilidade (HA) se conecta a ela. As réplicas são contabilizadas em qualquer região e estado, incluindo as réplicas que estão em processo de provisionamento ou desconectadas. Liste as réplicas associadas no console ou com ibmcloud cdb deployment-read-replicas. Promova ou exclua cada um deles e aguarde até que cada operação seja concluída. Uma réplica excluída continua sendo contabilizada até ser excluída definitivamente, embora não apareça mais na lista. Consulte “Réplicas somente leitura” e “IPMVU ”. Desconecte os demais clientes de replicação. A consulta de autoverificação 1 mostra apenas os clientes conectados.
Transações preparadas Não há nenhuma transação preparada. Faça com que o aplicativo responsável ou o gerenciador de transações conclua as transações preparadas e impeça a criação de novas transações até que a atualização seja concluída. Não as confirme nem as reverta apenas para passar na verificação. Verifique por meio da consulta de autoverificação 4.
Exportação do esquema O esquema de cada banco de dados é exportado sem erros. Uma exportação que atinge o tempo limite ou fica sem espaço de bloqueio não é reprovada nessa verificação. Faça um teste da atualização em um ambiente de teste que você restaure a partir de um backup recente. Essa verificação não verifica se a versão de destino é capaz de recriar o esquema; portanto, resolva também as condições que as pré-verificações não detectam. Se essa verificação continuar falhando, entre em contato com o suporte.
Compatibilidade com atualizações PostgreSQL As verificações de compatibilidade com a atualização foram aprovadas no servidor primário e em todos os membros do HA. Conclua a preparação da extensão, incluindo a verificação “ pgRouting ”. No PostgreSQL 17, mantenha no máximo 10 assinaturas. Verifique as questões de autoavaliação 6, 8, 9 e 10.

Condições que as verificações prévias não detectam

As verificações prévias não detectam as seguintes condições. Algumas delas fazem com que a atualização falhe depois que as gravações são bloqueadas. Se a causa estiver no esquema, como uma função ou o nome de um banco de dados, todas as tentativas subsequentes falharão da mesma forma até que você resolva o problema. Outras condições fazem com que o serviço copie todo o banco de dados para os membros do HA, o que mantém as gravações bloqueadas por muito mais tempo, ou fazem com que a atualização falhe após a retomada das gravações. Uma falha na fase de conversão ou reinicialização também pode fazer com que os membros do HA fiquem parados até que a equipe de suporte os reinicie. Resolva ou planeje uma solução para cada condição antes de enviar a atualização.

Condições que as verificações prévias não detectam
Condição Efeito O que Fazer
Um banco de dados contém uma tabela UNLOGGED. Todos os membros do HA são reconstruídos, e o conteúdo d UNLOGGED s é reinicializado. Verifique por meio da consulta de autoverificação 11. Consulte as tabelas e sequências em UNLOGGED.
A implantação é executada no PostgreSQL 16 ou 17, e as tabelas aumentaram de tamanho devido a operações em massa ou a muitas inserções ou atualizações simultâneas. Os membros da HA são reestruturados. Planeje o intervalo de manutenção e o espaço em disco necessário para uma reconstrução. Consulte a seção “Disponibilidade durante uma atualização ”.
Um membro de dados utiliza cerca de metade do espaço em disco ou mais quando os membros de alta disponibilidade (HA) são reconstruídos. A reconstrução fica sem espaço. As gravações podem permanecer bloqueadas por horas antes que a tarefa falhe. Antes de enviar a atualização, ajuste o tamanho do disco até que cada membro de dados utilize significativamente menos de 50% do espaço disponível no disco.
Um índice, uma chave de partição, uma coluna gerada automaticamente ou estatísticas estendidas utilizam uma função LANGUAGE sql com um corpo de string que nomeia objetos fora d pg_catalog , sem indicar seu esquema. Em um índice, nomear o esquema “ ibm_extension ” tem o mesmo efeito. A conversão falhou. Verifique por meio da consulta de autoverificação 12. Consulte as funções SQL em índices, chaves de partição e colunas geradas.
Um índice ou uma coluna gerada armazenada utiliza a versão earthdistance 1.1. A conversão falhou. Verifique por meio da consulta de autoverificação 13. Consulte earthdistance.
Uma visão, um agregado ou uma função com um corpo conforme ao padrão SQL utiliza um nome de sistema que foi removido na versão de destino. Ou uma função, um papel ou uma configuração do banco de dados utiliza um parâmetro removido. A conversão falhou. Verifique por meio das consultas de autoverificação 7 e 14. Consulte “Objetos que utilizam nomes de sistema removidos ”.
anon A versão 2 está instalada. A conversão falhou. Conclua a preparação para o exame “ anon ”.
O nome de um banco de dados contém uma aspa simples ('), uma barra invertida (``), um sinal de igual (=), um caractere de nova linha ou um retorno de carro. A atualização falha; em alguns casos, isso ocorre após o bloqueio das gravações. Verifique por meio da consulta de autoverificação 15. Renomeie o banco de dados e atualize suas cadeias de conexão.
Os bancos de dados contêm muitos milhares de tabelas e sequências ou, nas versões 14 e 15 d PostgreSQL, visões. A conversão fica sem espaço de bloqueio e falha. Verifique por meio da consulta de autoverificação 16 e aumente o valor de max_locks_per_transaction caso a consulta indique que isso é necessário.
A implantação possui um grande número de bancos de dados, tabelas ou objetos de grande porte. A conversão ultrapassou o tempo limite. A tarefa falha ou permanece em andamento enquanto o banco de dados estiver indisponível. Conte as tabelas e os objetos grandes com a consulta de autoconfiguração 16. Faça um teste em um ambiente de teste que você restaure a partir de um backup recente da produção. Se o ensaio não der certo, entre em contato com o suporte.
A atividade de gravação é elevada quando a atualização é iniciada ou quando há muitos logs de transação aguardando arquivamento. Após o início do modo somente leitura, os membros do HA e o arquivamento do log de transações têm apenas alguns minutos para se atualizar. Uma lista de pendências que for aprovada na verificação prévia pode demorar mais tempo para ser arquivada, e a atualização acaba falhando. Mantenha a carga baixa desde o início da atualização até que as gravações sejam retomadas e execute o comando VACUUM nas tabelas carregadas recentemente antes da atualização. Verifique o atraso na replicação usando a consulta em “Disponibilidade durante uma atualização ” e verifique o arquivamento usando a consulta de autoverificação 5.
As gravações continuam após o início do modo somente leitura, por exemplo, devido a substituições no modo somente leitura, comandos de manutenção, execução de tarefas do pg_cron ou assinaturas ativadas no PostgreSQL 17. É possível que os membros do HA e o processo de arquivamento não consigam acompanhar a tempo, fazendo com que a atualização falhe. Interrompa esses gravadores antes de enviar a atualização, conforme descrito na seção “Disponibilidade durante uma atualização ”.
Um cliente prepara uma transação após as verificações prévias. O comando PREPARE TRANSACTION continua funcionando no modo somente leitura. A atualização falha enquanto as gravações estão bloqueadas. Uma transação preparada pouco antes da interrupção de um PostgreSQL e pode fazer com que a conversão falhe. Interrompa os clientes que utilizam o commit em duas fases até que a tarefa apareça como Concluída. Verifique por meio da consulta de autoverificação 4.
Um cliente de replicação se conecta durante a atualização. O slot criado não é mantido, e a atualização pode falhar ou ficar paralisada enquanto o banco de dados estiver indisponível. Mantenha os clientes de replicação desconectados até que a tarefa apareça como “Concluída ”. Verifique com as consultas de autoverificação 1 e 2.
Uma carga em massa contínua é executada após a retomada das gravações. A tarefa falha após a retomada das gravações, e a implantação executa a versão de destino até que a equipe de suporte conclua a atualização. Evite cargas em massa até que a tarefa apareça como “Concluída ”.
A configuração “ synchronous_commit ” da implantação é on. Uma atualização malsucedida pode deixar todos os bancos de dados na modalidade somente leitura até que a equipe de suporte recupere a implantação. Altere para local, conforme descrito na seção “Antes de começar ”.
Ao atualizar do PostgreSQL e 16 ou versões anteriores para a versão 17 ou posteriores, se um índice, uma visão materializada ou estatísticas estendidas utilizarem uma função sem a configuração “ search_path ”. Após a atualização, as chamadas ANALYZE, REINDEX, CLUSTER, VACUUM FULL e REFRESH MATERIALIZED VIEW podem falhar para esses objetos. Verifique por meio da consulta de autoverificação 17. Consulte as funções SQL em índices, chaves de partição e colunas geradas.

Não altere esquemas, extensões, bancos de dados, slots de replicação lógica ou assinaturas entre o envio da atualização e a conclusão da tarefa.

Verifique você mesmo se está tudo pronto

Execute as seguintes consultas como usuário “ admin ” com a autorização “ psql ” antes de enviar a atualização. Eles trabalham nos dias 14 a 18 de PostgreSQL. As consultas de 1 a 7 e a consulta 15 abrangem toda a implantação; portanto, execute-as uma vez em qualquer banco de dados. Execute as outras consultas em cada banco de dados.

  1. Conexões de replicação. Haverá uma linha para cada membro do HA, que corresponde ao número de membros de dados menos um, cada uma com o estado streaming. Qualquer outra linha é uma réplica somente leitura ou outro cliente de replicação. Uma linha com o nome “ pg_basebackup ” significa que o serviço está copiando o banco de dados para um membro de alta disponibilidade (HA) ou para uma réplica somente leitura. Aguarde até que a cópia seja concluída e, em seguida, execute a consulta novamente.

    SELECT application_name, client_addr, state
    FROM pg_catalog.pg_stat_replication
    ORDER BY application_name;
    
  2. Slots de replicação lógica. Não espere discussões.

    SELECT slot_name, plugin, database, active
    FROM pg_catalog.pg_replication_slots
    WHERE slot_type = 'logical';
    
  3. Assinaturas lógicas. No PostgreSQL e 16 e versões anteriores, não há linhas. No dia 17 d PostgreSQL, espere encontrar “ f ” na coluna “ subenabled ” de cada linha.

    SELECT d.datname AS database_name, s.subname, s.subenabled
    FROM pg_catalog.pg_subscription AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.subdbid;
    
  4. Transações preparadas. Não espere discussões.

    SELECT gid, owner, database, prepared
    FROM pg_catalog.pg_prepared_xacts;
    
  5. Arquivamento do log de transações. É de se esperar que last_failed_time esteja vazio ou seja anterior a last_archived_time``, e que waiting_files seja 0 ou próximo de 0. Uma fila de tarefas pendentes que seja aprovada na verificação prévia ainda pode ser grande demais para ser arquivada após o início do modo somente leitura.

    SELECT failed_count, last_failed_time, last_archived_time
    FROM pg_catalog.pg_stat_archiver;
    
    SELECT count(*) AS waiting_files,
           pg_catalog.pg_size_pretty(count(*) * pg_catalog.pg_size_bytes(pg_catalog.current_setting('wal_segment_size'))) AS waiting_size
    FROM pg_catalog.pg_ls_archive_statusdir()
    WHERE name LIKE '%.ready';
    
  6. Configurações de conexão com o banco de dados. Não espere discussões. Excluir um banco de dados listado cujo endereço datconnlimit é -2, pois ele é inválido. Para qualquer outro banco de dados listado, permita conexões ou exclua-o. Se a consulta exibir “ template0 ”, entre em contato com o suporte.

    SELECT datname, datallowconn, datconnlimit
    FROM pg_catalog.pg_database
    WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2))
       OR (datname = 'template0' AND datallowconn);
    
  7. Configurações de função e banco de dados. Certifique-se de que todos os parâmetros em setconfig existam na versão de destino. Redefina um parâmetro que tenha sido removido ou renomeado na versão de destino e defina seu substituto após a atualização. Isso também se aplica aos parâmetros definidos por extensões cujos nomes contêm um ponto. Certifique-se de que nenhuma função defina default_transaction_read_only com um valor falso, como off, ` `false, no ou ` `0. Registre cada banco de dados que defina default_transaction_read_only``, pois a atualização redefine essa configuração. A consulta de autoverificação 14 verifica as configurações das funções.

    SELECT r.rolname AS role_name, d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    LEFT JOIN pg_catalog.pg_roles AS r ON r.oid = s.setrole
    LEFT JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase;
    
  8. Tipos de dados de coluna que o PostgreSQL não consegue atualizar. Não espere discussões. A consulta também lista colunas de tipos compostos do sistema, bem como de domínios, matrizes, tipos compostos e intervalos que são construídos com base nesses tipos. A coluna “ base_type ” mostra o tipo que está impedindo a atualização. O bloco de tipo “ aclitem ” bloqueia apenas as atualizações do “ PostgreSQL ” 14 ou 15 para a versão 16 ou posterior.

    WITH RECURSIVE problem_types (type_oid, base_type) AS (
      SELECT t.oid, t.typname::text
      FROM pg_catalog.pg_type AS t
      WHERE t.typnamespace = 'pg_catalog'::pg_catalog.regnamespace
        AND t.typname IN ('regcollation', 'regconfig', 'regdictionary', 'regnamespace',
                          'regoper', 'regoperator', 'regproc', 'regprocedure', 'aclitem')
      UNION ALL
      SELECT t.oid, 'system composite type ' || t.oid::pg_catalog.regtype::text
      FROM pg_catalog.pg_type AS t
      LEFT JOIN pg_catalog.pg_namespace AS n ON n.oid = t.typnamespace
      WHERE t.typtype = 'c'
        AND (t.oid < 16384 OR n.nspname = 'information_schema')
      UNION ALL
      SELECT derived.type_oid, derived.base_type
      FROM (
        WITH found AS (SELECT type_oid, base_type FROM problem_types)
        SELECT t.oid AS type_oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'd' AND t.typbasetype = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'b' AND t.typelem = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_class AS c ON c.reltype = t.oid
        JOIN pg_catalog.pg_attribute AS a ON a.attrelid = c.oid AND NOT a.attisdropped
        JOIN found AS f ON a.atttypid = f.type_oid
        WHERE t.typtype = 'c'
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_range AS r ON r.rngtypid = t.oid
        JOIN found AS f ON r.rngsubtype = f.type_oid
        WHERE t.typtype = 'r'
      ) AS derived
    )
    SELECT DISTINCT n.nspname AS schema_name, c.relname AS relation_name, a.attname AS column_name,
           a.atttypid::pg_catalog.regtype AS data_type, p.base_type
    FROM pg_catalog.pg_attribute AS a
    JOIN pg_catalog.pg_class AS c ON c.oid = a.attrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    JOIN problem_types AS p ON p.type_oid = a.atttypid
    WHERE a.attnum > 0
      AND NOT a.attisdropped
      AND c.relkind IN ('r', 'm', 'i')
      AND n.nspname NOT IN ('pg_catalog', 'information_schema')
      AND n.nspname !~ '^pg_toast_temp_|^pg_temp_'
    ORDER BY 1, 2, 3;
    
  9. Colunas herdadas que não possuem a restrição “ NOT NULL ” presente na tabela pai. Não espere discussões. Para corrigir uma coluna listada, o proprietário da tabela executa o comando ALTER TABLE <table_name> ALTER COLUMN <column_name> SET NOT NULL;``.

    SELECT n.nspname AS schema_name, c.relname AS table_name, child.attname AS column_name
    FROM pg_catalog.pg_inherits AS i
    JOIN pg_catalog.pg_attribute AS child ON child.attrelid = i.inhrelid
    JOIN pg_catalog.pg_attribute AS parent
      ON parent.attrelid = i.inhparent AND parent.attname = child.attname
    JOIN pg_catalog.pg_class AS c ON c.oid = i.inhrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE parent.attnum > 0
      AND parent.attnotnull
      AND NOT child.attnotnull
      AND NOT child.attisdropped;
    
  10. Extensões instaladas. Conclua a preparação da extensão. Em seguida, confirme se todas as extensões restantes estão disponíveis na versão de destino, por exemplo, em uma implantação de teste dessa versão.

    SELECT extname, extversion
    FROM pg_catalog.pg_extension
    ORDER BY extname;
    
  11. UNLOGGED tabelas e sequências. Seu conteúdo não é preservado durante a atualização, e uma tabela listada faz com que o serviço reconstrua todos os membros do HA. Antes de realizar a atualização, consulte as tabelas e sequências do UNLOGGED.

    SELECT n.nspname AS schema_name, c.relname AS relation_name, c.relkind
    FROM pg_catalog.pg_class AS c
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE c.relpersistence = 'u'
      AND c.relkind IN ('r', 'S');
    
  12. Funções SQL que podem fazer com que a conversão falhe. Não espere discussões. A consulta lista as funções do tipo “ LANGUAGE sql ” com um corpo de string que é utilizado por um índice, um predicado de índice parcial, uma chave de partição, uma coluna gerada armazenada ou estatísticas estendidas. Ele segue chamadas por meio de operadores, restrições de verificação de domínio e funções com corpo conforme o padrão SQL. Para cada função listada, consulte as funções SQL em índices, chaves de partição e colunas geradas.

    WITH RECURSIVE uses (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid,
             CASE WHEN c.relkind = 'p' THEN 'partition key of ' ELSE 'index ' END
               || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
      WHERE c.relkind IN ('i', 'I') OR (c.relkind = 'p' AND d.objsubid = 0)
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attrelid = ad.adrelid
       AND a.attnum = ad.adnum
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attribute AS a
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND a.attrelid = d.objid
       AND a.attnum = d.objsubid
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid, 'statistics ' || s.stxname || ' on ' || s.stxrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s
        ON d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
       AND s.oid = d.objid
    ), used (fn, used_by) AS (
      SELECT x.fn, u.used_by
      FROM uses AS u
      CROSS JOIN LATERAL (
        SELECT u.refobjid AS fn
        WHERE u.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE u.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = u.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE u.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = u.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
       AND NOT p.prosecdef
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT u.fn::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname = 'sql'
      AND p.prosqlbody IS NULL
      AND p.proconfig IS NULL
      AND NOT p.prosecdef
      AND p.pronamespace <> 'pg_catalog'::pg_catalog.regnamespace
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    
  13. Índices e colunas geradas armazenadas que utilizam a versão earthdistance 1.1, diretamente ou por meio de funções com corpo conforme o padrão SQL. Não espere discussões. Para cada objeto listado, consulte earthdistance.

    WITH RECURSIVE used (fn, via, used_by) AS (
      SELECT d.refobjid, d.refobjid, 'index ' || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
       AND c.relkind IN ('i', 'I')
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      LEFT JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attgenerated = 's'
       AND ((a.attrelid = ad.adrelid AND a.attnum = ad.adnum)
            OR (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                AND a.attrelid = d.objid
                AND a.attnum = d.objsubid))
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, u.via, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
       AND d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
    )
    SELECT e.extversion, u.via::pg_catalog.regprocedure AS used_function, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_depend AS m
      ON m.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
     AND m.objid = u.fn
     AND m.refclassid = 'pg_catalog.pg_extension'::pg_catalog.regclass
     AND m.deptype = 'e'
    JOIN pg_catalog.pg_extension AS e ON e.oid = m.refobjid
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE e.extname = 'earthdistance'
      AND e.extversion IN ('1.0', '1.1')
      AND l.lanname = 'sql'
      AND p.proconfig IS NULL
    ORDER BY 2, 3;
    
  14. Visões, visões materializadas, agregados e funções que utilizam nomes do catálogo do sistema ou parâmetros de configuração que foram removidos por uma versão posterior do PostgreSQL. A coluna “ removed_in ” mostra a primeira versão sem o nome. Não espere encontrar linhas com uma versão do removed_in igual ou inferior à sua versão alvo. Um nome pode corresponder a um texto que não seja uma referência do catálogo; portanto, verifique cada objeto listado. Consulte “Objetos que utilizam nomes de sistema removidos ”.

    WITH removed (relation_name, identifier, removed_in) AS (
      VALUES (NULL, 'pg_is_in_backup', 15), (NULL, 'pg_backup_start_time', 15),
             (NULL, 'pg_start_backup', 15), (NULL, 'pg_stop_backup', 15),
             ('pg_database', 'datlastsysoid', 15),
             (NULL, 'force_parallel_mode', 16),
             ('pg_stat_bgwriter', 'checkpoints_timed', 17), ('pg_stat_bgwriter', 'checkpoints_req', 17),
             ('pg_stat_bgwriter', 'checkpoint_write_time', 17), ('pg_stat_bgwriter', 'checkpoint_sync_time', 17),
             ('pg_stat_bgwriter', 'buffers_checkpoint', 17), ('pg_stat_bgwriter', 'buffers_backend', 17),
             ('pg_stat_bgwriter', 'buffers_backend_fsync', 17),
             (NULL, 'pg_stat_get_bgwriter_timed_checkpoints', 17),
             (NULL, 'pg_stat_get_bgwriter_requested_checkpoints', 17),
             (NULL, 'pg_stat_get_checkpoint_write_time', 17), (NULL, 'pg_stat_get_checkpoint_sync_time', 17),
             (NULL, 'pg_stat_get_bgwriter_buf_written_checkpoints', 17),
             (NULL, 'pg_stat_get_buf_written_backend', 17), (NULL, 'pg_stat_get_buf_fsync_backend', 17),
             ('pg_stat_progress_vacuum', 'max_dead_tuples', 17),
             ('pg_stat_progress_vacuum', 'num_dead_tuples', 17),
             ('pg_database', 'daticulocale', 17), ('pg_collation', 'colliculocale', 17),
             ('element_types', 'domain_default', 17),
             (NULL, 'interval_accum', 17), (NULL, 'interval_accum_inv', 17), (NULL, 'interval_combine', 17),
             ('pg_stat_wal', 'wal_write', 18), ('pg_stat_wal', 'wal_sync', 18),
             ('pg_stat_wal', 'wal_write_time', 18), ('pg_stat_wal', 'wal_sync_time', 18),
             ('pg_stat_io', 'op_bytes', 18), ('pg_backend_memory_contexts', 'parent', 18),
             ('pg_attribute', 'attcacheoff', 18)
    ), definitions (object_name, definition) AS (
      SELECT 'view ' || c.oid::pg_catalog.regclass::text, pg_catalog.pg_get_viewdef(c.oid)
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind IN ('v', 'm')
        AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'function ' || p.oid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', pg_catalog.pg_get_function_sqlbody(p.oid),
                                  pg_catalog.array_to_string(p.proconfig, ' '))
      FROM pg_catalog.pg_proc AS p
      WHERE (p.prosqlbody IS NOT NULL OR p.proconfig IS NOT NULL)
        AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'aggregate ' || a.aggfnoid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', a.aggtransfn, a.aggfinalfn, a.aggcombinefn,
                                  a.aggmtransfn, a.aggminvtransfn, a.aggmfinalfn)
      FROM pg_catalog.pg_aggregate AS a
      JOIN pg_catalog.pg_proc AS p ON p.oid = a.aggfnoid
      WHERE p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
    )
    SELECT d.object_name, r.identifier, r.removed_in
    FROM definitions AS d
    JOIN removed AS r
      ON d.definition ~ ('\m' || r.identifier || '\M')
     AND (r.relation_name IS NULL OR d.definition ~ ('\m' || r.relation_name || '\M'))
    ORDER BY 3, 1, 2;
    
  15. Nomes de bancos de dados que a atualização não pode utilizar. Não espere discussões. Para corrigir um banco de dados listado, seu proprietário deve se conectar a outro banco de dados e executar o comando enquanto ALTER DATABASE "<database_name>" RENAME TO <new_name>; nenhuma sessão estiver conectada ao banco de dados que está sendo renomeado. O proprietário também deve possuir o atributo “ CREATEDB ”. Em seguida, atualize todos os aplicativos que se conectam ao banco de dados.

    SELECT datname
    FROM pg_catalog.pg_database
    WHERE pg_catalog.strpos(datname, '''') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(92)) > 0
       OR pg_catalog.strpos(datname, '=') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(10)) > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(13)) > 0
    ORDER BY datname;
    
  16. Relações bloqueadas pela atualização, objetos grandes e a capacidade de bloqueio da implantação. Some os valores de “ locked_relations ” das quatro bases de dados com os valores mais altos. Nos dias 14 e 15 d PostgreSQL, o comando locked_relations inclui visões e visões materializadas, pois a atualização também as bloqueia. Se o total exceder lock_capacity, aumente max_locks_per_transaction até que lock_capacity exceda o total. Essa alteração reinicia o banco de dados; portanto, faça-a antes de enviar a atualização. Muitas tabelas ou objetos grandes também prolongam o processo de conversão; portanto, faça um teste da atualização com seu esquema e seus dados reais.

    SELECT pg_catalog.current_database() AS database_name,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_class AS c
            WHERE (c.relkind IN ('r', 'p', 'S')
                   OR (c.relkind IN ('v', 'm')
                       AND pg_catalog.current_setting('server_version_num')::integer < 160000))
              AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                         'information_schema'::pg_catalog.regnamespace)) AS locked_relations,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_largeobject_metadata) AS large_objects,
           pg_catalog.current_setting('max_locks_per_transaction')::integer
             * (pg_catalog.current_setting('max_connections')::integer
                + pg_catalog.current_setting('max_prepared_transactions')::integer) AS lock_capacity;
    
  17. Funções que não possuem a configuração search_path e que são utilizadas por índices, visualizações materializadas e estatísticas estendidas. A consulta segue chamadas por meio de operadores, restrições de verificação de domínio e funções com um corpo conforme o padrão SQL. Execute esta consulta se você estiver atualizando do PostgreSQL 16 ou versões anteriores para o PostgreSQL 17 ou versões posteriores. Uma função listada cujo corpo nomeia objetos fora d pg_catalog, sem indicar seu esquema, faz com que os comandos de manutenção falhem após a atualização. Uma função só não é afetada se seu corpo — e todas as funções que ela chama — referirem-se a todos os objetos fora d pg_catalog, indicando seu esquema. Para cada uma das demais funções listadas, seu proprietário adiciona uma configuração search_path , conforme descrito em “Funções SQL em índices, chaves de partição e colunas geradas ”.

    WITH RECURSIVE refreshed (relid, used_by) AS (
      SELECT c.oid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind = 'm'
      UNION
      SELECT v.oid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
       AND d.refclassid = 'pg_catalog.pg_class'::pg_catalog.regclass
      JOIN pg_catalog.pg_class AS v ON v.oid = d.refobjid AND v.relkind = 'v'
    ), refs (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c ON c.oid = d.objid AND c.relkind IN ('i', 'I')
      WHERE d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
      UNION
      SELECT d.refclassid, d.refobjid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
      UNION
      SELECT d.refclassid, d.refobjid, s.stxrelid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s ON s.oid = d.objid
      WHERE d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
    ), used (fn, used_by) AS (
      SELECT x.fn, r.used_by
      FROM refs AS r
      CROSS JOIN LATERAL (
        SELECT r.refobjid AS fn
        WHERE r.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE r.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = r.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE r.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = r.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND NOT EXISTS (SELECT 1
                       FROM pg_catalog.unnest(p.proconfig) AS setting
                       WHERE setting LIKE 'search\_path=%')
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT p.oid::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname NOT IN ('c', 'internal')
      AND p.prosqlbody IS NULL
      AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                 'information_schema'::pg_catalog.regnamespace)
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.unnest(p.proconfig) AS setting
                      WHERE setting LIKE 'search\_path=%')
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    

A aprovação nessas verificações não garante que a atualização seja bem-sucedida nem que seus aplicativos sejam compatíveis com a versão de destino. Somente um ensaio em uma implantação de teste executa a conversão completa.

Planejamento do período de atualização

Use o ensaio de teste para estimar uma janela de manutenção. O tempo de conversão depende principalmente do número de bancos de dados e objetos. A reconstrução de um membro do HA depende do tamanho do banco de dados. A carga de trabalho e o volume do log de transações afetam as verificações e a recuperação. Leve em conta o tempo total necessário para a tarefa de atualização, e não apenas o tempo em que as gravações ficam bloqueadas.

O prazo de validade do início define o horário mais tardio em que uma atualização na fila pode ser iniciada. O padrão é de 5 minutos após a solicitação, e você pode configurá-lo com até 24 horas de antecedência. Operações em andamento, como um backup, e solicitações agendadas anteriormente atrasam o início. Se a atualização não for iniciada antes do prazo de validade, ela não será executada, e a tarefa aparecerá como “Vencida ”. O vencimento não interrompe uma atualização que já tenha sido iniciada. Por exemplo, uma solicitação na fila expira às 22h30 UTC. Uma tarefa que começa às 22h25 UTC pode se estender além desse horário.

Enquanto a atualização está em andamento, outras solicitações de implantação ficam em espera até que ela seja concluída. Isso inclui escalonamento manual e automático, alterações na configuração, alterações em usuários e senhas, alterações nos endereços IP permitidos e backups. Não exclua a implantação enquanto a tarefa de atualização estiver na fila ou em execução.

Não crie réplicas somente de leitura até que a tarefa seja concluída. O serviço não bloqueia essas solicitações. Se você criar uma, a atualização pode falhar nas verificações prévias, ou a nova réplica pode não conseguir replicar a partir da implantação atualizada. Exclua essa réplica e crie uma nova assim que a tarefa for concluída.

Fazendo upgrade na IU

  1. Crie e verifique um backup sob demanda. A atualização não requer nenhum.
  2. Na página “Visão geral ” da implantação, clique em “Atualizar versão principal ”.
  3. Na etapa “Orientação ”, leia as orientações, selecione “Li as orientações e estou pronto para prosseguir com a atualização ” e clique em “Avançar ”. Para saber quando as operações de leitura e gravação não estão disponíveis, consulte “Disponibilidade durante uma atualização ”.
  4. Em “Atualizar para a versão ”, selecione a versão desejada. Se houver mais de um destino disponível, a lista seleciona o mais recente por padrão. A nota sobre réplicas de leitura nesta etapa está desatualizada. A atualização falha nas verificações prévias enquanto houver alguma réplica somente leitura associada à implantação; portanto, promova ou exclua todas as réplicas antes de realizar a atualização.
  5. Em “Prazo de validade para iniciar a atualização”, selecione por quanto tempo a solicitação pode ficar em espera antes de ser iniciada. O padrão é 5 minutos.
  6. Clique em Fazer upgrade. Enquanto a solicitação está em espera ou em execução, a linha “Versão” na página “Visão geral ” exibe “Atualização na fila ” ou “Atualização em andamento ”.
  7. Acompanhe a tarefa em “Tarefas recentes ”. Assim que as gravações forem retomadas, atualize as estatísticas conforme descrito na seção “Após a atualização ”. Quando a tarefa aparecer como “Concluída”, conclua as etapas restantes dessa seção. Se aparecer “Falha ”, consulte a seção “Solução de problemas ”. Se aparecer “Expirado”, a atualização não foi iniciada, e você pode enviá-la novamente com uma data de validade posterior.

Fazendo upgrade por meio da API

Envie uma solicitação PATCH para o endpoint /deployments/{id}/version. Defina version como a versão principal de destino e defina a data de início da validade com o parâmetro de consulta expiration_datetime :

curl -X PATCH \
  'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version?expiration_datetime=<EXPIRATION_TIME>' \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"version": "18"}'

Substitua <EXPIRATION_TIME> por uma hora em UTC no formato ISO 8601, como 2026-11-03T22:30:00Z, entre 5 minutos e 24 horas após a solicitação. Se você omitir expiration_datetime``, a solicitação expirará caso não seja iniciada em até 5 minutos.

Uma solicitação bem-sucedida retorna uma tarefa. Uma solicitação aceita não significa que a atualização tenha sido concluída. Use o ID da tarefa com a função “Obter informações sobre uma tarefa” para monitorar a atualização. Para listar os destinos disponíveis, use a função “Descobrir informações de recursos” de uma implantação com o recurso “ versions ”. Para conhecer todos os parâmetros, consulte a referência da API.

Fazendo upgrade por meio da CLI

Utilize a versão 0.20.0 ou posterior do plug-in CLI do Cloud Databases. Defina o prazo de validade inicial com --expire-in ou --expire-at``, de 5 minutos a 24 horas após a solicitação. O padrão é 5 minutos.

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait

Sem o parâmetro --nowait, o comando aguarda até que a tarefa seja concluída ou falhe. Ele não retorna nenhum resultado se a atualização expirar antes de começar; portanto, use ` `--nowait` ` nos scripts. Com ` `--nowait, o comando retorna assim que o serviço aceita a solicitação. Acompanhe a tarefa com deployment-tasks-list:

ibmcloud cdb deployment-tasks-list <NAME|CRN>

Para todos os parâmetros, execute ibmcloud cdb deployment-version-upgrade --help``.

Atualização através do Terraform

Utilize o provedor Terraform “ IBM Cloud® ” na versão 1.79.2 ou posterior. Defina “ version ” como um destino disponível, analise o plano e aplique-o. O plano falhará se o destino não estiver disponível para uma atualização no local.

Defina o tempo limite de atualização do recurso com duração suficiente para que toda a atualização seja concluída, e de, no mínimo, 5 minutos. O provedor também utiliza esse tempo limite, de até 24 horas, como data de início da validade. Uma atualização em fila pode, portanto, ser iniciada a qualquer momento até que o tempo limite se esgote. Aplique a alteração quando não houver nenhum backup ou outra operação em execução ou na fila, para que a atualização comece imediatamente. Se o tempo de espera para a aplicação expirar após o início da atualização, a atualização continuará. Se a atualização ainda estiver na fila quando o tempo limite expirar, ela será cancelada e não será executada. Aguarde até que a tarefa seja concluída antes de executar novamente terraform plan ou terraform apply.

Se a tarefa de atualização falhar, conclua a seção “Solução de problemas” antes de executar o “ terraform apply ” novamente. O Terraform reenvia a atualização sempre que a implantação ainda indicar a versão de origem.

Após uma atualização fora do Terraform, defina version para a nova versão ou remova version da configuração. As atualizações fora do Terraform incluem atualizações na interface do usuário (UI), na linha de comando (CLI) ou na API, além de uma atualização forçada. Até que você atualize a configuração, todas as chamadas terraform plan e terraform apply que incluam essa implantação falharão, impedindo alterações em outros recursos na mesma configuração. O erro é semelhante ao descrito em Version 14 is not a valid upgrade version ou No available upgrade versions for version 18.

O argumento version_upgrade_skip_backup não é compatível com PostgreSQL. Para obter mais informações, consulte a referência de recursos do banco de dados.

Após a atualização

Assim que as gravações forem retomadas, certifique-se de que as estatísticas do otimizador estejam completas. Não esperar a conclusão da tarefa. As gravações foram retomadas quando SHOW default_transaction_read_only; retornou off em uma nova sessão. Em cada banco de dados, a consulta a seguir lista as tabelas e as visualizações materializadas que não possuem estatísticas. Execute o comando ANALYZE <table_name>; para cada relação listada. Se o usuário não tiver permissão para analisar uma relação, execute o comando como proprietário da relação. A análise de uma tabela particionada também analisa suas partições.

SELECT c.oid::pg_catalog.regclass AS relation_name
FROM pg_catalog.pg_class AS c
WHERE c.relkind IN ('r', 'm', 'p')
  AND c.reltuples < 0
  AND NOT c.relispartition
  AND c.relpersistence <> 't'
  AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                             'information_schema'::pg_catalog.regnamespace)
  AND NOT EXISTS (SELECT 1
                  FROM pg_catalog.pg_depend AS e
                  WHERE e.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                    AND e.objid = c.oid
                    AND e.deptype = 'e');

No PostgreSQL 17 e versões posteriores, o comando ANALYZE pode falhar com um erro como “ function ... does not exist ”. Nesse caso, corrija a função listada na consulta de autoverificação 17 e execute novamente o comando ANALYZE . Uma instrução ANALYZE aplicada a todo o banco de dados que seja interrompida por um erro não analisa as tabelas restantes. No dia 18 d PostgreSQL, analise também cada tabela que possua objetos de estatística, conforme listado pelo comando psql ( \dX), e cada tabela que contenha colunas PostGIS, pois a atualização não transfere essas estatísticas.

Depois que a tarefa aparecer como Concluída:

  1. Verifique se a versão da implantação no console ou na API corresponde à versão de destino e se a chamada SHOW server_version; retorna essa versão. Execute a consulta de autoverificação 1 e confirme se todos os membros do HA estão transmitindo dados. Confirme também se as gravações foram retomadas em todos os bancos de dados: a consulta a seguir não retorna nenhuma linha. Se algum membro do HA estiver faltando, se houver uma linha chamada “ pg_basebackup ” ou se a consulta listar um banco de dados, entre em contato com o suporte.

    SELECT d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase
    WHERE s.setrole = 0
      AND d.datallowconn
      AND NOT d.datistemplate
      AND EXISTS (SELECT 1
                  FROM pg_catalog.unnest(s.setconfig) AS c(setting)
                  WHERE c.setting LIKE 'default_transaction_read_only=%');
    
  2. Atualizar extensões. A atualização mantém cada extensão na versão em que está instalada. Em cada banco de dados, liste as extensões que possuem uma versão mais recente e atualize cada uma delas:

    SELECT name, installed_version, default_version
    FROM pg_catalog.pg_available_extensions
    WHERE installed_version <> default_version;
    
    ALTER EXTENSION <extension_name> UPDATE;
    

    Se você atualizou do PostgreSQL 14, 15 ou 16 para o PostgreSQL 17 ou uma versão posterior, a atualização do pg_stat_statements renomeia as colunas blk_read_time e blk_write_time para shared_blk_read_time e shared_blk_write_time. Atualize as consultas que leem essas colunas.

  3. Restaure as extensões e o mascaramento conforme descrito na etapa de preparação. Recarregue as tabelas do UNLOGGED a partir do conteúdo que você exportou. Defina cada sequência de UNLOGGED para valores superiores aos que estão em uso; por exemplo, com SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));``. Recrie os slots de replicação lógica, as assinaturas e as réplicas somente leitura que você removeu e ative as assinaturas que você desativou. Reconecte os consumidores e ressincronize os dados antes de retomar as aplicações dependentes.

  4. Se você tiver definido default_transaction_read_only para um banco de dados, defina-o novamente. A atualização redefine essa configuração em todos os bancos de dados, de modo que eles voltem a aceitar gravações.

  5. Confirme se o backup pós-atualização foi concluído. Ele copia todo o banco de dados, por isso pode levar várias horas. Se você precisar de uma recuperação em um momento específico para as alterações feitas após a atualização, mantenha as gravações do aplicativo suspensas até esse momento.

  6. Se você atualizou do PostgreSQL 14 ou 15 para o PostgreSQL 16 ou uma versão posterior, execute a consulta de funções descrita na seção “Problemas com privilégios de funções durante atualizações de versão ”. Conceda as funções listadas antes de retomar as tarefas que gerenciam essas funções.

  7. Se o Terraform gerenciar a implantação e você tiver feito a atualização fora do Terraform, defina version para a nova versão ou remova-o, conforme descrito em “Atualização por meio do Terraform ”.

  8. Retome as gravações do aplicativo e as tarefas agendadas que você pausou. Restaure as configurações que você alterou para a atualização, como synchronous_commit.

  9. Recompile os objetos que dependem de dados Unicode, pois as versões mais recentes do PostgreSQL utilizam dados Unicode mais recentes:

    • A menos que você tenha feito a atualização do PostgreSQL 16 para o PostgreSQL 17, verifique os índices, as visualizações materializadas, as restrições de verificação e as chaves de partição cujas expressões utilizem normalize() ou is_normalized()``. Apenas o texto que contém caracteres novos na versão mais recente do Unicode é afetado.
    • Se você atualizou do PostgreSQL 17 para o PostgreSQL 18, verifique também os objetos que utilizam o unicode_assigned(). Verifique também os objetos que aplicam expressões regulares, como ILIKE, lower(), upper() ou initcap(), ao texto na localidade integrada C.UTF-8. A ordenação “ pg_c_utf8 ” e os bancos de dados que utilizam o provedor de localidade “ builtin ” com “ C.UTF-8 ” utilizam essa localidade.
    • Se você atualizou para o PostgreSQL 18 e um banco de dados utiliza o provedor de localidade icu ou builtin, recrie seus índices de pesquisa de texto completo e de pg_trgm.

    Execute REINDEX INDEX <index_name>; para cada índice afetado e REFRESH MATERIALIZED VIEW <view_name>; para cada visualização materializada afetada. Certifique-se de que as linhas ainda atendam às restrições de verificação afetadas e estejam nas partições corretas.

  10. Compare o comportamento e o desempenho do aplicativo com os resultados do ambiente de teste.

Resolução de problemas

Se o serviço rejeitar uma solicitação, o erro é exibido imediatamente. A interface do usuário geralmente exibe a mensagem “Falha na atualização” acompanhada do motivo; a API retorna a mensagem de erro; e a CLI exibe o erro com uma dica. Corrija a solicitação e envie-a novamente.

Se a tarefa estiver com o status “Expirado”, a atualização não foi iniciada e a implantação permanece inalterada. Envie a atualização novamente quando não houver nenhuma outra operação em execução ou na fila, ou defina uma data de validade de início posterior.

Uma tarefa que posteriormente aparece como “Falha” não identifica a verificação ou etapa que falhou, e a interface do usuário não exibe a causa. Dependendo da etapa que falhou, a implantação pode estar em um destes estados:

  • Na versão de origem: a implantação executa a versão de origem e aceita gravações. Uma pré-verificação com falha deixa a implantação nesse estado, e o serviço restaura o acesso de gravação após a maioria das falhas ocorridas durante o modo somente leitura. Uma tentativa fracassada ainda pode ter efeitos duradouros. Isso pode remover old_snapshot, esvaziar UNLOGGED tabelas, redefinir UNLOGGED sequências e deixar uma lacuna na cobertura do PITR. Ele também pode redefinir as configurações de “ default_transaction_read_only ” no nível do banco de dados, para que esses bancos de dados voltem a aceitar gravações. Se você definir default_transaction_read_only como on para qualquer banco de dados, uma tentativa malsucedida também encerrará todas as sessões dos clientes, mesmo quando uma verificação prévia falhar.
  • Sobre a versão de destino: A implantação executa a versão de destino, mas a atualização fica incompleta até que a equipe de suporte a conclua. O console e a API ainda podem exibir a versão do código-fonte. Até lá, os membros do HA podem não estar em operação, e os backups e o arquivamento do log de transações podem falhar. Se a consulta de autoverificação 1 ou 5 indicar algum problema, suspenda as gravações do aplicativo até que a equipe de suporte conclua a atualização.
  • Com falha: A implantação permanece em modo somente leitura ou indisponível, ou é executada sem seus membros de alta disponibilidade, até que a equipe de suporte a recupere. Uma falha na fase de conversão ou reinicialização pode deixar os membros do HA paralisados até que a equipe de suporte os reinicie, mesmo após a retomada das gravações.

Para identificar o estado, conecte-se como admin e execute SHOW server_version;. Em cada banco de dados que você utiliza, execute o comando SHOW default_transaction_read_only;``. Execute a consulta de autoverificação 1 para confirmar se todos os membros do HA estão transmitindo dados. Se o admin não conseguir se conectar após a falha da tarefa, por exemplo, devido a um erro de autenticação, entre em contato com o suporte. A atualização não altera suas credenciais.

Se a implantação aceitar gravações, executar a versão de origem e todos os membros do HA estiverem transmitindo dados, verifique as pré-verificações e execute as consultas de autoverificação. Resolva todos os itens que não estão em conformidade, faça um backup sob demanda e, em seguida, envie a atualização novamente. Em todos os outros casos, ou se a próxima tentativa também falhar, entre em contato com o suporte antes de tentar novamente ou fazer outras alterações. Incluir:

  • O CRN da implantação e o ID da tarefa com falha. Anote o ID da tarefa quando ela falhar, pois as listas de tarefas mostram apenas as tarefas mais recentes.
  • As versões do PostgreSQL de origem e de destino solicitadas, e o resultado do comando SHOW server_version;``.
  • A hora aproximada da falha e o fuso horário.
  • Se os aplicativos conseguem se conectar, ler e gravar.
  • O resultado das consultas de autoverificação.
  • O CRN de cada réplica somente leitura relacionada, incluindo qualquer réplica promovida ou excluída recentemente.

Se a solicitação falhar devido a um erro interno, entre em contato com o suporte. Na interface do usuário, esse erro é exibido como “Falha na atualização”, com a mensagem “Falha ao criar a tarefa de atualização no local ”. A interface do usuário também exibe essa mensagem para outras solicitações rejeitadas quando não é possível exibir o motivo específico. Para saber o motivo, envie a solicitação usando a CLI ou a API. Entre em contato com o suporte também se a tarefa permanecer em andamento por muito mais tempo do que durante o seu ensaio. Após uma falha, a tarefa pode permanecer em andamento (status “ running ” na CLI e na API) enquanto o serviço tenta a recuperação.

Remova apenas os objetos listados nas etapas de preparação e nas consultas de autoverificação. Não jogue outros objetos no chão para passar por uma revista. Entre em contato com o suporte, em vez disso.

Fazendo upgrade por meio de uma réplica somente leitura

Crie uma réplica somente leitura a partir da implantação de origem e aguarde até que a réplica seja sincronizada. Em seguida, promova e atualize a réplica usando o endpoint /remotes/promotion. Defina version como um destino que a réplica liste em suas capacidades:

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "promotion": {
        "version": "18",
        "skip_initial_backup": false
    }
}'

Defina skip_initial_backup como true somente se desejar ignorar o backup inicial criado pela promoção. Essa configuração pode reduzir o tempo da tarefa de promoção, mas a recuperação da implantação promovida exige, posteriormente, um backup agendado ou sob demanda bem-sucedido.

Se uma promoção que envolva uma atualização de versão falhar, o serviço desativa a implantação promovida. Entre em contato com o suporte. Ensaie uma promoção com uma atualização de versão em uma réplica de uma implantação de teste antes de confiar nela.

Atualização por meio da restauração de um backup

Restaurar um backup em uma implantação que utilize uma versão de destino compatível. Se você restaurar um backup usando a CLI ou a API e não especificar os parâmetros de alocação de recursos, a nova implantação utilizará as alocações de recursos que a implantação de origem possuía no momento em que o backup foi criado. Na interface do usuário, a página de restauração exibe inicialmente as alocações atuais da implantação de origem, que você pode alterar.

Restaurando um backup na IU

Na seção “Backups e restauração ” do painel de implantação, clique em “Restaurar backup” para o backup que você deseja usar. Na página que for aberta, selecione uma versão de destino compatível na seção “Versão do banco de dados ” e configure as opções para a nova implantação. Em seguida, clique em “Restaurar backup ”.

Restaurando um backup por meio da CLI

Crie a implantação com a versão de destino e o ID do backup no argumento JSON -p :

ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
  -p '{
  "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version": "18"
}' \
  --service-endpoints "public"

Restaurando um backup por meio da API

Use a API do controlador de recursos para restaurar um backup em uma nova implantação que execute a versão de destino. Especifique o nome da implantação, o local, o grupo de recursos, o plano, o ID do backup e a versão de destino:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-postgresql-standard",
    "parameters": {
      "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
      "version": "18"
    }
  }'

Atualização forçada

Após a data de fim de vida útil, todas as implantações ativas do Databases for PostgreSQL que executam a versão obsoleta serão automaticamente atualizadas para a próxima versão suportada.

Uma atualização obrigatória é considerada um IPMVU; portanto, conclua os preparativos para o IPMVU antes da data de fim de vida útil.

Faça o upgrade antes da data de fim de vida útil para evitar os seguintes riscos:

  • Não são fornecidos SLAs para esse tipo de upgrade forçado.
  • Você pode perder alguns dados.
  • Sua aplicação poderá ficar fora do ar por um período prolongado.
  • Seu aplicativo pode deixar de funcionar caso seja incompatível com a nova versão.
  • Não é possível controlar o momento em que esse upgrade ocorrerá em sua implementação.
  • Não há processo de reversão para essa atualização forçada.
  • Se o Terraform gerenciar a implantação e definir version, todas as chamadas a ` `terraform plan` ` falharão após a atualização forçada até que você atualize ` `version.

Para saber as datas de fim de vida útil, consulte a página de política de versões.

Problemas com privilégios de funções durante atualizações de versão

No PostgreSQL 16 e versões posteriores, uma função com o atributo “ CREATEROLE ”, como admin, precisa de uma função com o atributo “ ADMIN OPTION ” para gerenciá-la. O gerenciamento de uma função inclui alterar sua senha ou atributos, excluí-la e conceder acesso a ela. A atualização do PostgreSQL 14 ou 15 para a versão 16 ou posterior não disponibiliza essa opção para o admin em funções que já existiam antes da atualização. As tarefas que gerenciam essas funções como “ admin ”, como a rotação de senhas, acabam falhando. Para obter mais informações, consulte as notas de lançamento do PostgreSQL 16, os atributos de funções e as concessões de funções.

Por exemplo, a alteração de senha falha com a mensagem:

ERROR:  permission denied to alter role
DETAIL:  To change another role's password, the current user must have the CREATEROLE attribute and the ADMIN option on the role.

Antes de fazer a atualização, execute a seguinte consulta como admin. A lista apresenta as funções que o admin não poderá gerenciar após a atualização, exceto os usuários criados na interface do usuário (UI), na linha de comando (CLI) ou pela API. No PostgreSQL 16 e versões posteriores, o admin também não permite alterar esses usuários; portanto, gerencie-os pela interface do usuário (UI), pela linha de comando (CLI) ou pela API.

SELECT r.rolname AS role_name,
       pg_catalog.pg_has_role(r.oid, 'admin'::name, 'MEMBER') AS member_of_admin
FROM pg_catalog.pg_roles AS r
WHERE NOT r.rolsuper
  AND NOT r.rolreplication
  AND r.rolname <> 'admin'
  AND r.rolname !~ '^(pg_|ibm-)'
  AND NOT EXISTS (
      SELECT 1
      FROM pg_catalog.pg_auth_members AS m
      JOIN pg_catalog.pg_roles AS b ON b.oid = m.roleid
      WHERE m.member = r.oid
        AND b.rolname IN ('ibm-cloud-base-user', 'ibm-cloud-base-user-ro'))
  AND NOT pg_catalog.pg_has_role(r.oid, 'MEMBER WITH ADMIN OPTION')
ORDER BY 1;

Para continuar gerenciando uma função listada, atribua- admin e antes de realizar a atualização:

GRANT <role_name> TO admin WITH ADMIN OPTION;

Essa concessão falha para uma função cujo valor de “ member_of_admin ” é “ t ”, pois essa função é membro de “ admin ”. Após a atualização, o admin não consegue gerenciar essa função.

Após atualizar para o PostgreSQL e 16 ou uma versão posterior, execute a consulta novamente. Para cada função listada cujo valor de member_of_admin seja f``, execute o seguinte programa auxiliar enquanto estiver conectado a ibmclouddb ou a qualquer banco de dados, exceto postgres. Não inclua outras funções, pois uma concessão rejeitada anula toda a convocatória. É possível executar o auxiliar com segurança mais de uma vez:

SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');

Ambas as concessões também tornam admin membro da função, de modo que admin possa utilizar os privilégios dessa função.

Log de mudanças para versões principais do PostgreSQL