Procedimiento para usar extensiones de PostgreSQL para Azure Database for PostgreSQL

SE APLICA A: Azure Database for PostgreSQL con servidor flexible

El servidor flexible de Azure Database for PostgreSQL le permite ampliar la funcionalidad de la base de datos mediante extensiones. Las extensiones agrupan varios objetos SQL relacionados en un solo paquete que se puede cargar o quitar de la base de datos con un comando. Después de cargarse en la base de datos, las extensiones funcionan como características integradas.

Permitir extensiones

Antes de instalar extensiones en el servidor flexible de Azure Database for PostgreSQL, debe agregar a la lista de permitidos estas extensiones para su uso.

Portal

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en sección Configuración, seleccione Parámetros del servidor.

3. Busque el parámetro azure.extensions.

4. Seleccione las extensiones que quiera permitir.

   

CLI de Azure

Puede permitir extensiones mediante el comando parameter set de la 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>

Plantilla de Resource Manager

Mediante la plantilla de ARM:

En el ejemplo siguiente se agregan las extensiones dblink, dict_xsyn, pg_buffercache a la lista de permitidos en un servidor cuyo nombre es 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"
            }
        }
    ]
}

Cargar bibliotecas

shared_preload_libraries es un parámetro de configuración de servidor que determina qué bibliotecas deben cargarse cuando se inicia el servidor flexible de Azure Database for PostgreSQL. Las bibliotecas que usan memoria compartida deben cargarse a través de este parámetro. Si la extensión se debe agregar a las bibliotecas de precarga compartida, siga estos pasos:

Mediante Azure Portal:

1. Seleccione la instancia de servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en sección Configuración, seleccione Parámetros del servidor.

3. Busque el parámetro shared_preload_libraries.

4. Seleccione las bibliotecas que desea agregar.

   

Puede establecer shared_preload_libraries mediante el comando parameter set de la CLI.

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>

Crear extensión

Una vez que las extensiones estén permitidas y cargadas, se deben instalar en cada base de datos en la que se vayan a usar.

1. Para crear una extensión, un usuario debe ser miembro del rol azure_pg_admin. Un miembro del rol de azure_pg_admin puede conceder privilegios a otros usuarios para crear extensiones.

2. Ejecute el comando CREATE EXTENSION para instalar una extensión determinada. Este comando carga los objetos empaquetados en la base de datos.

Nota:

Las extensiones de terceros que se ofrecen en el servidor flexible de Azure Database for PostgreSQL tienen una licencia de código abierto. Actualmente, no ofrecemos extensiones de terceros ni versiones de extensiones con modelos de licencia premium o propietarios.

La instancia de servidor flexible de Azure Database for PostgreSQL admite un subconjunto de extensiones de PostgreSQL clave, como se muestra en la tabla siguiente. Esta información también está disponible al ejecutar SHOW azure.extensions;. Las extensiones no enumeradas en este documento no se admiten en el servidor flexible de Azure Database for PostgreSQL. No puede crear o cargar una extensión propia en el servidor flexible de Azure Database for PostgreSQL.

Actualización de extensiones de PostgreSQL

Las actualizaciones locales de las extensiones de base de datos se permiten mediante un comando sencillo. Esta característica permite a los clientes actualizar automáticamente sus extensiones de terceros a las versiones más recientes, y mantener sistemas actuales y seguros sin esfuerzo manual.

Actualización de extensiones

Para actualizar una extensión instalada a la versión más reciente disponible compatible con Azure, use el siguiente comando SQL:

ALTER EXTENSION <extension_name> UPDATE;

Este comando simplifica la administración de extensiones de base de datos, ya que permite a los usuarios actualizar manualmente a la versión más reciente aprobada por Azure, lo que mejora la compatibilidad y la seguridad.

Extensiones instaladas

Para enumerar las extensiones instaladas actualmente en la base de datos, use el siguiente comando SQL:

SELECT * FROM pg_extension;

Vea la lista de extensiones disponibles.

Limitaciones

Aunque la actualización de extensiones es sencilla, existen ciertas limitaciones:

• Selección de una versión específica: el comando no admite la actualización a versiones intermedias de una extensión.

  • Actualiza constantemente a la versión más reciente disponible.

• Cambio a una versión anterior: no admite el cambio de una extensión a una versión anterior. Si es necesario cambiar a una versión anterior, es posible que se necesite asistencia de soporte técnico y depende de la disponibilidad de la versión anterior.

Comparta sugerencias y errores con el equipo de productos de Azure Database for PostgreSQL.

Contenido relacionado

• Versiones de extensión
• Consideraciones sobre extensiones
• Foro de comentarios