Gestión de extensiones de PostgreSQL: instalación, versionado, actualización y volcado

Qué es

La documentación describe una extensión como un archivo de script con los comandos SQL que crean sus objetos, más un archivo de control con propiedades como la versión predeterminada, si es reubicable y si es trusted, opcionalmente junto con una biblioteca compartida. CREATE EXTENSION name [SCHEMA s] [VERSION v] [CASCADE] la carga en la base de datos actual; pg_available_extensions y pg_available_extension_versions muestran lo que ofrece la instalación del servidor. ALTER EXTENSION name UPDATE [TO v] ejecuta los scripts de actualización de quien la desarrolla, desde la versión instalada hasta la versión de destino. DROP EXTENSION elimina todos los objetos miembro a la vez, y pg_dump solo escribe el comando CREATE EXTENSION, no los miembros.

Por qué importa

Existen tres versiones al mismo tiempo: los archivos instalados en el servidor (normalmente un paquete del sistema operativo), la versión registrada en el catálogo de la base de datos y, para extensiones con código en C, la biblioteca cargada por el servidor en ejecución. Estas versiones se desalinean con las actualizaciones de paquetes, con pg_upgrade y cuando se restaura un volcado en un servidor cuyos archivos son más antiguos o no existen. Por eso un volcado depende de forma silenciosa de que los archivos de la extensión estén presentes en el momento de la restauración.

Cómo aplicarlo

• Instalar los archivos de la extensión por la misma vía que el servidor (paquetes del sistema operativo, o la lista de extensiones permitidas del servicio gestionado), y registrar las extensiones y versiones necesarias en el historial de migraciones para que un entorno nuevo las recree.
• Usar CREATE EXTENSION IF NOT EXISTS ... SCHEMA extensions en las migraciones cuando la extensión permita elegir el esquema (una que nombra un esquema en su archivo de control no puede sobrescribirse), de modo que los objetos miembro no oculten objetos de la aplicación y los search paths se mantengan limpios.
• La instalación normalmente requiere privilegios de superusuario; una extensión marcada como trusted puede instalarla cualquiera que tenga CREATE sobre la base de datos. La documentación advierte de que un script escrito sin cuidado puede explotarse mediante objetos troyanos en su esquema de instalación, por lo que conviene instalar en esquemas donde los usuarios no confiables no tengan privilegio CREATE.
• Después de las actualizaciones de paquetes, comparar installed_version con default_version en pg_available_extensions y ejecutar ALTER EXTENSION ... UPDATE en una ventana de mantenimiento; después de pg_upgrade, ejecutar el script de actualización que este genera.
• Los módulos que deben figurar en shared_preload_libraries (pg_stat_statements, auto_explain) solo surten efecto tras reiniciar el servidor; hay que planificarlo.
• Nunca modificar a mano los objetos miembro con CREATE OR REPLACE FUNCTION; la documentación indica que esos cambios no se vuelcan.

Trampas

Los nombres de extensión son únicos por base de datos, no por esquema. CASCADE instala las dependencias en sus versiones predeterminadas. Las extensiones que definen tipos de datos usados en tablas (postgis, hstore, vector) deben estar presentes antes de poder restaurar las tablas, o la restauración falla para esas tablas, no solo para las funciones. Los servicios gestionados publican listas de extensiones permitidas; una extensión que no está en la lista bloquea la migración a ese servicio.