Como usar extensões PostgreSQL para o Banco de Dados do Azure para PostgreSQL

APLICA-SE A: Banco de Dados do Azure para PostgreSQL - Servidor Flexível

O servidor flexível do Banco de Dados do Azure para PostgreSQL permite que você estenda a funcionalidade do seu banco de dados usando extensões. As extensões agrupam vários objetos SQL relacionados em um único pacote que pode ser carregado ou removido do banco de dados com um comando. Depois de serem carregadas no banco de dados, as extensões funcionam como recursos internos.

Permitir extensões

Antes de instalar extensões no Banco de Dados do Azure para servidor flexível PostgreSQL, você deve permitir que essas extensões sejam listadas para uso.

Portal

Usando o portal do Azure:

1. Selecione sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações , selecione Parâmetros do servidor.

3. Procure o azure.extensions parâmetro.

4. Selecione as extensões que deseja permitir.

   

CLI do Azure

Você pode permitir extensões por meio do comando conjunto de parâmetros da CLI.

    az postgres flexible-server parameter set --resource-group <resource_group>  --server-name <server> --subscription <subscription_id> --name azure.extensions --value <extension_name>,<extension_name>

Modelo do Resource Manager

Usando o modelo ARM:

O exemplo a seguir adiciona extensões à lista dblinkde permissões , dict_xsyn, pg_buffercache em um servidor cujo nome é postgres-test-server:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "flexibleServers_name": {
            "defaultValue": "postgres-test-server",
            "type": "String"
        },
        "azure_extensions_set_value": {
            "defaultValue": " dblink,dict_xsyn,pg_buffercache",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
            "apiVersion": "2021-06-01",
            "name": "[concat(parameters('flexibleServers_name'), '/azure.extensions')]",
            "properties": {
                "value": "[parameters('azure_extensions_set_value')]",
                "source": "user-override"
            }
        }
    ]
}

Carregar bibliotecas

shared_preload_libraries é um parâmetro de configuração de servidor que determina quais bibliotecas devem ser carregadas quando o servidor flexível do Banco de Dados do Azure para PostgreSQL é iniciado. Todas as bibliotecas que usam memória compartilhada devem ser carregadas por meio desse parâmetro. Se a extensão precisar ser adicionada às bibliotecas de pré-carregamento compartilhadas, siga estas etapas:

Usando o portal do Azure:

1. Selecione sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

2. No menu de recursos, na seção Configurações , selecione Parâmetros do servidor.

3. Procure o shared_preload_libraries parâmetro.

4. Selecione as bibliotecas que deseja adicionar.

   

Você pode definir shared_preload_libraries através do comando CLI parameter set .

az postgres flexible-server parameter set --resource-group <resource_group> --server-name <server> --subscription <subscription_id> --name shared_preload_libraries --value <extension_name>,<extension_name>

Criar extensão

Depois que as extensões são permitidas e carregadas, elas devem ser instaladas em cada banco de dados no qual devem ser usadas.

1. Para criar uma extensão, um usuário deve ser um membro da azure_pg_admin função. Um membro da azure_pg_admin função pode conceder privilégios a outros usuários para criar extensões.

2. Execute o comando CREATE EXTENSION para instalar uma extensão específica. Este comando carrega os objetos empacotados em seu banco de dados.

Nota

As extensões de terceiros oferecidas no Banco de Dados do Azure para o servidor flexível PostgreSQL são código licenciado de código aberto. Não oferecemos extensões de terceiros ou versões de extensão com modelos de licenciamento premium ou proprietários.

A instância flexível do servidor do Banco de Dados do Azure para PostgreSQL dá suporte a um subconjunto de extensões chave do PostgreSQL, conforme listado na tabela a seguir. Esta informação também está disponível através da execução SHOW azure.extensions;. Não há suporte para extensões não listadas neste documento no Banco de Dados do Azure para servidor flexível PostgreSQL. Não é possível criar ou carregar sua extensão no Banco de Dados do Azure para servidor flexível PostgreSQL.

Atualizando extensões do PostgreSQL

Um comando simples permite atualizações in-loco de extensões de banco de dados. Esse recurso permite que os clientes atualizem automaticamente suas extensões de terceiros para as versões mais recentes, mantendo os sistemas atuais e seguros sem esforço manual.

Atualizar extensões

Para atualizar uma extensão instalada para a versão mais recente disponível suportada pelo Azure, utilize o seguinte comando SQL:

ALTER EXTENSION <extension_name> UPDATE;

Este comando simplifica o gerenciamento de extensões de banco de dados, permitindo que os usuários atualizem manualmente para a versão mais recente aprovada pelo Azure, aprimorando a compatibilidade e a segurança.

Extensões instaladas

Para listar as extensões atualmente instaladas no banco de dados, use o seguinte comando SQL:

SELECT * FROM pg_extension;

Veja a lista de extensões disponíveis.

Limitações

Embora a atualização de extensões seja simples, há certas limitações:

• Seleção de uma versão específica: o comando não suporta a atualização para versões intermediárias de uma extensão.

  • Atualiza constantemente a última versão disponível.

• Downgrade: não suporta o downgrade de uma extensão para uma versão anterior. Se um downgrade for necessário, ele pode exigir assistência de suporte e depende da disponibilidade da versão anterior.

Partilhe as suas sugestões e bugs com a equipa de produto da Base de Dados do Azure para PostgreSQL.

Conteúdos relacionados

• Versões de extensão
• Considerações sobre extensão
• Fórum de comentários