Gerenciar extensões do 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. Selecione as extensões que você deseja permitirlist, entre as disponíveis no azure.extensions parâmetro, e selecione Salvar.

   

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:

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. Inclua as bibliotecas que deseja adicionar no valor de shared_preload_librariese selecione Salvar.

   

4. Como shared_preload_librariesé um parâmetro estático do servidor, ele requer uma reinicialização do servidor para que as alterações entrem em vigor.

   

CLI do Azure

Você pode definir shared_preload_libraries usando o comando conjunto de parâmetros da CLI.

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

E pode reiniciar o servidor usando o comando conjunto de parâmetros da CLI.

az postgres flexible-server restart --resource-group <resource_group> --name <server>

Criar extensões

Depois que uma extensão é permitida e, se a extensão exigir, também é adicionada ao shared_load_libraries, ela pode ser criada ou instalada em cada banco de dados no qual deve ser usada.

1. Para criar uma extensão, um usuário deve ser um membro da azure_pg_admin função.

2. Execute o comando CREATE EXTENSION para criar ou 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 em extensões com suporte por nome ou em extensões suportadas por versão do PostgreSQL. Esta informação também está disponível através da execução SHOW azure.extensions;. As extensões não incluídas nessas listas não têm suporte no Banco de Dados do Azure para o servidor flexível PostgreSQL. Não é possível criar ou carregar suas próprias extensões no Banco de Dados do Azure para servidor flexível PostgreSQL.

Extensões de gota

Para soltar uma extensão, primeiro certifique-se de permitlistá-la .

1. Para descartar uma extensão, um usuário deve ser membro da azure_pg_admin função.

2. Execute o comando DROP EXTENSION para soltar ou desinstalar uma extensão específica. Este comando descarta os objetos empacotados na extensão do seu banco de dados.

Atualizar as 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.

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.

Ver extensões instaladas

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

SELECT * FROM pg_extension;

Possíveis erros

A extensão "%s" não está listada como permitida para usuários "azure_pg_admin" no Banco de Dados do Azure para PostgreSQL

Este erro ocorre quando executa um CREATE EXTENSION comando ou DROP EXTENSION referente a uma extensão que não está na lista permitida ou a uma extensão que ainda não tem suporte na instância da Base de Dados do Azure para servidor flexível no qual está a executar o comando.

Apenas os membros do "azure_pg_admin" estão autorizados a usar CREATE EXTENSION

Este erro ocorre quando o usuário que executa um CREATE EXTENSION comando não é um membro da azure_pg_admin função.

Apenas os membros do "azure_pg_admin" estão autorizados a usar a DROP EXTENSION

Este erro ocorre quando o usuário que executa um DROP EXTENSION comando não é um membro da azure_pg_admin função.

Conteúdos relacionados

• Como usar extensões.
• Considerações especiais com extensões.
• Lista de extensões por nome.