Considerações de extensão específicas do Banco de Dados do Azure para servidor flexível PostgreSQL
Para verificar quais versões de uma extensão estão disponíveis para a instalação atual do banco de dados, consulte a exibição do catálogo do pg_available_extensions sistema.
Por exemplo, para determinar a versão disponível para a extensão 'azure_ai', execute:
SELECT * FROM pg_available_extensions WHERE name = 'azure_ai';
Esses comandos fornecem informações necessárias sobre as configurações de extensão do seu banco de dados, ajudando a manter seus sistemas de forma eficiente e segura. Quando você habilita atualizações fáceis para as versões de extensão mais recentes, o Banco de Dados do Azure para PostgreSQL continua a oferecer suporte ao gerenciamento robusto, seguro e eficiente de seus aplicativos de banco de dados.
Pré-requisitos
Siga o seguinte artigo para saber como permitir extensões.
Extensões
Segue-se uma lista de extensões suportadas que requerem considerações específicas no serviço de servidor flexível da Base de Dados do Azure para PostgreSQL:
dblinkpg_buffercachepg_cronpg_failover_slotspg_hint_planpg_prewarmpg_repackpg_stat_statementspostgres_fdwpgstattuple
dblink
A dblink extensão permite que você se conecte de uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL a outro ou outro banco de dados no mesmo servidor. O servidor flexível do Banco de Dados do Azure para PostgreSQL dá suporte a conexões de entrada e saída para qualquer servidor PostgreSQL. O servidor de envio precisa permitir conexões de saída com o servidor de recebimento. Da mesma forma, o servidor de recebimento precisa permitir conexões do servidor de envio.
Se você planeja usar essa extensão, recomendamos implantar seus servidores com integração de rede virtual. Por padrão, a integração de rede virtual permite conexões entre servidores na rede virtual. Você também pode optar por usar grupos de segurança de rede de rede virtual para personalizar o acesso.
pg_buffercache
A pg_buffercache extensão pode ser usada para estudar o conteúdo de shared_buffers. Usando essa extensão, você pode saber se uma relação específica está armazenada em cache (em shared_buffers). Essa extensão pode ajudá-lo a solucionar problemas de desempenho (problemas de desempenho relacionados ao cache).
Esta extensão é integrada com a instalação principal do PostgreSQL, e é fácil de instalar.
CREATE EXTENSION pg_buffercache;
pg_cron
A pg_cron extensão é um agendador de tarefas simples e baseado em cron para PostgreSQL que é executado dentro do banco de dados como uma extensão. A pg_cron extensão pode executar tarefas de manutenção agendadas dentro de um banco de dados PostgreSQL. Por exemplo, você pode executar um vácuo periódico de uma tabela ou remover trabalhos de dados antigos.
A pg_cron extensão pode executar vários trabalhos em paralelo, mas executa no máximo uma instância de um trabalho de cada vez. Se uma segunda execução deve começar antes que a primeira termine, a segunda execução é enfileirada e iniciada assim que a primeira é concluída. Dessa forma, garante-se que os trabalhos sejam executados exatamente quantas vezes forem programadas e não sejam executados simultaneamente com eles mesmos.
A pg_cron extensão é pré-carregada para shared_preload_libraries cada instância de servidor flexível do Banco de Dados do Azure para PostgreSQL dentro do banco de dados Postgres para fornecer a capacidade de agendar trabalhos para execução em outros bancos de dados dentro de sua instância de banco de dados flexível do Banco de Dados do Azure para PostgreSQL sem comprometer a segurança.
Por motivos de segurança, você deve permitir a lista de permissões da extensão e instalá-la usando o pg_cron comando CREATE EXTENSION.
Exemplos
Para apagar dados antigos no sábado às 3:30 am (GMT).
SELECT cron.schedule('30 3 * * 6', $$DELETE FROM events WHERE event_time < now() - interval '1 week'$$);Para executar o vácuo todos os dias às 10:00 am (GMT) no banco de dados
postgrespadrão.SELECT cron.schedule('0 10 * * *', 'VACUUM');Para desagendar todas as tarefas de
pg_cron.SELECT cron.unschedule(jobid) FROM cron.job;Para ver todos os trabalhos atualmente agendados com
pg_crono .SELECT * FROM cron.job;Para executar o vácuo todos os dias às 10:00 am (GMT) no banco de dados
test cronsob a conta deazure_pg_adminfunção.SELECT cron.schedule_in_database('VACUUM',' 0 10 * * * ', 'VACUUM', 'testcron',null,TRUE);
Mais exemplos
A partir da pg_cron versão 1.4, você pode usar as cron.schedule_in_database funções e cron.alter_job para agendar seu trabalho em um banco de dados específico e atualizar uma agenda existente, respectivamente.
A cron_schedule_in_database função permite o nome de usuário como um parâmetro opcional. Definir o nome de usuário para um valor não nulo requer privilégio de superusuário PostgreSQL e não é suportado no Banco de Dados do Azure para servidor flexível PostgreSQL. Exemplos anteriores mostram a execução dessa função com um parâmetro de nome de usuário opcional omitido ou definido como null, que executa o trabalho no contexto do usuário agendando o trabalho, que deve ter azure_pg_admin privilégios de função.
Para apagar dados antigos no sábado às 3:30 am (GMT) no banco de dados DBName.
SELECT cron.schedule_in_database('JobName', '30 3 * * 6', $$DELETE FROM events WHERE event_time < now() - interval '1 week'$$,'DBName');Para atualizar ou alterar o nome da base de dados no agendamento existente
SELECT cron.alter_job(job_id:=MyJobID,database:='NewDBName');
pg_failover_slots
A pg_failover_slots extensão aprimora o Banco de Dados do Azure para servidor flexível PostgreSQL ao operar com replicação lógica e servidores habilitados para alta disponibilidade. Ele efetivamente aborda o desafio dentro do mecanismo PostgreSQL padrão que não preserva slots de replicação lógica após um failover. A manutenção desses slots é fundamental para evitar pausas de replicação ou incompatibilidades de dados durante alterações na função de servidor principal, garantindo a continuidade operacional e a integridade dos dados.
A extensão simplifica o processo de failover gerenciando a transferência, a limpeza e a sincronização necessárias dos slots de replicação, proporcionando assim uma transição perfeita durante as alterações de função de servidor. A extensão é suportada para PostgreSQL versões 11 a 16.
Você pode encontrar mais informações e instruções sobre como usar a pg_failover_slots extensão em sua página no GitHub.
Para habilitar a pg_failover_slots extensão para sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL, você precisa modificar a configuração do servidor incluindo a extensão nas bibliotecas de pré-carregamento compartilhadas do servidor e ajustando um parâmetro de servidor específico. Segue-se o processo:
Atualize o
shared_preload_librariesparâmetro para adicionar opg_failover_slotsàs bibliotecas de pré-carregamento compartilhadas do servidor.Altere o parâmetro
hot_standby_feedbackserver paraon.
Quaisquer alterações no parâmetro exigem uma reinicialização do shared_preload_libraries servidor para entrar em vigor.
Usando o portal do Azure:
Selecione sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.
No menu de recursos, na seção Configurações , selecione Parâmetros do servidor.
Procure o
shared_preload_librariesparâmetro e edite seu valor para incluirpg_failover_slots.Procure o
hot_standby_feedbackparâmetro e defina seu valor comoon.Selecione Salvar para preservar as alterações. Agora, você tem a opção de Salvar e reiniciar.
- Escolha esta opção para garantir que as alterações entrem em vigor, uma vez que a modificação
shared_preload_librariesrequer uma reinicialização do servidor.
- Escolha esta opção para garantir que as alterações entrem em vigor, uma vez que a modificação
Ao selecionar Salvar e reiniciar, o servidor reinicializa automaticamente, aplicando as alterações feitas. Quando o servidor estiver online novamente, a extensão estará habilitada pg_failover_slots e operacional em sua instância de servidor flexível principal do Banco de Dados do Azure para PostgreSQL, pronta para lidar com slots de replicação lógica durante failovers.
pg_hint_plan
A pg_hint_plan extensão torna possível ajustar os planos de execução do PostgreSQL usando as chamadas "dicas" nos comentários SQL, como:
/*+ SeqScan(a) */
A pg_hint_plan extensão lê frases de sugestão em um comentário do formulário especial fornecido com a instrução SQL de destino. A forma particular começa com a sequência de caracteres "/*+" e termina com "*/". As frases de dica consistem em nomes de dicas e seguintes parâmetros entre parênteses e delimitados por espaços. Novas linhas para legibilidade podem delimitar cada frase de sugestão.
Exemplo:
/*+
HashJoin(a b)
SeqScan(a)
*/
SELECT *
FROM pgbench_branches b
JOIN pgbench_accounts an ON b.bid = a.bid
ORDER BY a.aid;
O exemplo anterior faz com que o planejador use os resultados de uma seqscan tabela a para combinar com a tabela b como um hashjoinarquivo .
Para instalar pg_hint_plano , além de permitir listá-lo, como mostrado em como usar extensões PostgreSQL-use-postgresql-extensions), você precisa incluí-lo nas bibliotecas de pré-carregamento compartilhadas do servidor. Uma alteração no parâmetro do Postgres shared_preload_libraries requer uma reinicialização do servidor para entrar em vigor. Você pode alterar parâmetros usando o portal do Azure ou a CLI do Azure.
Usando o portal do Azure:
Selecione sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.
No menu de recursos, na seção Configurações , selecione Parâmetros do servidor.
Procure o
shared_preload_librariesparâmetro e edite seu valor para incluirpg_hint_plan.Selecione ** Salvar ** para preservar suas alterações. Agora você tem a opção de Salvar e reiniciar.
- Escolha esta opção para garantir que as alterações entrem em vigor, uma vez que a modificação
shared_preload_librariesrequer uma reinicialização do servidor.
- Escolha esta opção para garantir que as alterações entrem em vigor, uma vez que a modificação
Agora você pode habilitar pg_hint_plan seu Banco de Dados do Azure para banco de dados de servidor flexível PostgreSQL. Conecte-se ao banco de dados e emita o seguinte comando:
CREATE EXTENSION pg_hint_plan;
pg_prewarm
A pg_prewarm extensão carrega dados relacionais no cache. Pré-aquecer seus caches significa que suas consultas têm melhores tempos de resposta na primeira execução após uma reinicialização. A funcionalidade de aquecimento automático para o servidor flexível PostgreSQL não está atualmente disponível no Banco de Dados do Azure.
pg_repack
Quando eles tentam usar essa extensão pela primeira vez, uma pergunta típica é: Uma extensão ou um executável do lado do cliente é pg_repack como psql ou pg_dump?
A resposta para isso é que são as duas coisas. pg_repack/lib contém o código para a extensão, incluindo o esquema e os artefatos SQL que ele cria, e a C biblioteca que implementa o código de várias dessas funções. Por outro lado, pg_repack/bin mantém o código para o aplicativo cliente, que sabe como interagir com os artefatos de programação criados pela extensão. Este aplicativo cliente visa facilitar a complexidade de interagir com as diferentes interfaces apresentadas pela extensão do lado do servidor, oferecendo ao usuário algumas opções de linha de comando que são mais fáceis de entender. O aplicativo cliente é inútil sem a extensão criada no banco de dados para o qual é apontado. A extensão do lado do servidor por si só seria totalmente funcional, mas exigiria que o usuário compreendesse um padrão de interação complicado que consiste em executar consultas para recuperar dados que são usados como entrada para funções implementadas pela extensão.
Permissão negada para reempacotamento de esquema
Atualmente, como concedemos permissões para o esquema de reempacotamento criado por essa extensão, só há suporte para executar pg_repack a funcionalidade a partir do contexto do azure_pg_admin.
Você pode notar que, se o proprietário de uma tabela, que não azure_pg_adminé, tentar executar pg_repack, ele acaba recebendo um erro como o seguinte:
NOTICE: Setting up workers.conns
ERROR: pg_repack failed with error: ERROR: permission denied for schema repack
LINE 1: select repack.version(), repack.version_sql()
Para evitar esse erro, execute pg_repack a partir do contexto de azure_pg_admin.
pg_stat_statements
A extensão pg_stat_statements oferece uma visão de todas as consultas que são executadas em seu banco de dados. Isso é útil para entender o desempenho da carga de trabalho de consulta em um sistema de produção.
A extensão pg_stat_statements é pré-carregada em shared_preload_libraries cada instância de servidor flexível do Banco de Dados do Azure para PostgreSQL para fornecer um meio de controlar as estatísticas de execução da instrução SQL.
Por motivos de segurança, você deve permitir a lista da extensão pg_stat_statements e instalá-la usando o comando CREATE EXTENSION.
A configuração pg_stat_statements.track, que controla quais instruções são contadas pela extensão, assume topcomo padrão , o que significa que todas as instruções emitidas diretamente pelos clientes são rastreadas. Os outros dois níveis de rastreamento são none e all. Esta definição é configurável como parâmetro do servidor.
Há uma compensação entre as informações de execução de consulta que a pg_stat_statements extensão fornece no desempenho do servidor à medida que registra cada instrução SQL. Se você não estiver usando ativamente a pg_stat_statements extensão, recomendamos que defina pg_stat_statements.track como none. Alguns serviços de monitoramento de terceiros podem se basear pg_stat_statements para fornecer informações sobre o desempenho da consulta, portanto, confirme se esse é o seu caso.
postgres_fdw
A postgres_fdw extensão permite que você se conecte de uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL a outro ou outro banco de dados no mesmo servidor. O servidor flexível do Banco de Dados do Azure para PostgreSQL dá suporte a conexões de entrada e saída para qualquer servidor PostgreSQL. O servidor de envio precisa permitir conexões de saída com o servidor de recebimento. Da mesma forma, o servidor de recebimento precisa permitir conexões do servidor de envio.
Se você planeja usar essa extensão, recomendamos implantar seus servidores com integração de rede virtual. Por padrão, a integração de rede virtual permite conexões entre servidores na rede virtual. Você também pode optar por usar grupos de segurança de rede de rede virtual para personalizar o acesso.
pgstattuple
Ao usar a pgstattuple extensão para tentar obter estatísticas de tupla pg_toast de objetos mantidos no esquema em versões do Postgres 11 a 13, você recebe um erro "permissão negada para pg_toast de esquema".
Permissão negada para o esquema pg_toast
Os clientes que usam as versões 11 a 13 do PostgreSQL no Banco de Dados do Azure para Servidor Flexível não podem usar a pgstattuple extensão em objetos dentro do pg_toast esquema.
No PostgreSQL 16 e 17, a pg_read_all_data função é concedida automaticamente ao azure_pg_admin, permitindo pgstattuple funcionar corretamente. No PostgreSQL 14 e 15, os clientes podem conceder manualmente a pg_read_all_data função para azure_pg_admin obter o mesmo resultado. No entanto, no PostgreSQL 11 a 13, a pg_read_all_data função não existe.
Os clientes não podem conceder diretamente as permissões necessárias. Se você precisar ser capaz de executar pgstattuple para acessar objetos no esquema, prossiga para criar uma solicitação de suporte do pg_toast Azure.
Escala de tempoDB
A timescaleDB extensão é um banco de dados de séries temporais empacotado como uma extensão para PostgreSQL. Ele fornece funções analíticas orientadas ao tempo e otimizações e dimensiona o Postgres para cargas de trabalho de séries temporais.
Saiba mais sobre TimescaleDB, uma marca registada da Timescale, Inc.
Instalar o TimescaleDB
Além de instalar a timescaleDB extensão e permitir listá-la, você precisa incluí-la nas bibliotecas de pré-carregamento compartilhadas do servidor. Uma alteração no parâmetro do Postgres shared_preload_libraries requer uma reinicialização do servidor para entrar em vigor. Você pode alterar parâmetros usando o portal do Azure ou a CLI do Azure.
Usando o portal do Azure:
Selecione sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.
No menu de recursos, na seção Configurações , selecione Parâmetros do servidor.
Procure o
shared_preload_librariesparâmetro e edite seu valor para incluirTimescaleDB.Selecione ** Salvar ** para preservar suas alterações. Agora você tem a opção - Salvar e reiniciar. Escolha esta opção para garantir que as alterações entrem em vigor, uma vez que a modificação
shared_preload_librariesrequer uma reinicialização do servidor.
Agora você pode habilitar o TimescaleDB em seu Banco de Dados do Azure para banco de dados de servidor flexível PostgreSQL. Conecte-se ao banco de dados e emita o seguinte comando:
CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;
Gorjeta
Se vir um erro, confirme que reiniciou o servidor depois de guardar shared_preload_libraries.
Agora você pode criar uma hipertabela TimescaleDB do zero ou migrar dados de séries cronológicas existentes no PostgreSQL.
Restaurar um banco de dados Timescale usando pg_dump e pg_restore
Para restaurar um banco de dados de Escala de Tempo usando pg_dump e pg_restore, você deve executar dois procedimentos auxiliares no banco de dados de destino: timescaledb_pre_restore() e timescaledb_post restore().
Primeiro, prepare o banco de dados de destino:
--create the new database where you want to perform the restore
CREATE DATABASE tutorial;
\c tutorial --connect to the database
CREATE EXTENSION timescaledb;
SELECT timescaledb_pre_restore();
Agora, você pode executar pg_dump no banco de dados original e, em seguida, fazer pg_restoreo . Após a restauração, execute o seguinte comando no banco de dados restaurado:
SELECT timescaledb_post_restore();
Para obter mais informações sobre o método de restauração com o banco de dados habilitado para Timescale, consulte a documentação Timescale.
Restaurar um banco de dados Timescale usando timescaledb-backup
Ao executar o procedimento, você pode obter permissões negadas ao atualizar o SELECT timescaledb_post_restore() sinalizador timescaledb.restoreing. Isso se deve à permissão limitada ALTER DATABASE nos serviços de banco de dados Cloud PaaS. Nesse caso, você pode executar um método alternativo usando a timescaledb-backup ferramenta para fazer backup e restaurar o banco de dados Timescale. Timescaledb-backup é um programa que torna o despejo e a restauração de um banco de dados TimescaleDB mais simples, menos propenso a erros e mais eficiente.
Para fazer isso, você deve fazer o seguinte:
Instale as ferramentas conforme detalhado aqui.
Crie um Banco de Dados do Azure de destino para instância de servidor flexível e banco de dados PostgreSQL.
Habilite a extensão de escala de tempo.
Conceda a
azure_pg_adminfunção ao usuário que é usada pelo ts-restore.Execute ts-restore para restaurar o banco de dados.
Mais detalhes sobre esses utilitários podem ser encontrados aqui.
Extensões e atualização da versão principal
O servidor flexível do Banco de Dados do Azure para PostgreSQL introduziu um recurso de atualização de versão principal in-loco que executa uma atualização in-loco da instância flexível do servidor do Banco de Dados do Azure para PostgreSQL com apenas uma seleção. A atualização da versão principal in-loco simplifica o processo de atualização flexível do servidor do Banco de Dados do Azure para PostgreSQL, minimizando a interrupção para usuários e aplicativos que acessam o servidor. As atualizações de versão principal in-loco não suportam extensões específicas e há algumas limitações para atualizar determinadas extensões.
As extensões anon, Apache AGE, dblink, orafce, pgaudit, e postgres_fdwtimescaledb não têm suporte para todas as versões flexíveis do Servidor do Banco de Dados do Azure para PostgreSQL ao usar o recurso de atualização de versão principal in-loco.
Partilhe as suas sugestões e bugs com a equipa de produto da Base de Dados do Azure para PostgreSQL.