Cómo conectar LibreOffice Base a una base de datos PostgreSQL

LibreOffice Base puede funcionar como interfaz para una base de datos PostgreSQL existente, lo que permite explorar tablas, crear consultas y generar formularios o informes sin necesidad de transferir los datos a una base de datos Base integrada. Para la mayoría de las instalaciones actuales, la opción más sencilla es la conexión directa de LibreOffice a PostgreSQL. JDBC sigue siendo útil como alternativa cuando el entorno requiere un controlador Java o cuando el conector directo no está disponible.

Escenario ilustrativo: imaginemos un pequeño equipo de operaciones llamado Northwind Field Services. Su servidor PostgreSQL contiene una base de datos llamada sales_ops. La base de datos se ejecuta en db.example.internal, escucha en el puerto 5432, y el equipo tiene un rol de solo lectura llamado analyst_ro. El ejemplo es ficticio y se utiliza únicamente para mostrar cómo encajan las decisiones de configuración.

Los pasos que se describen a continuación siguen la ayuda actual de LibreOffice para conexiones PostgreSQL y JDBC, así como la documentación actual del servidor PostgreSQL. A octubre de 2026, LibreOffice indica que la versión 26.8.0 es la más reciente y la 26.2.6 la versión anterior, que es más estable; la ubicación exacta de las etiquetas o los botones puede variar ligeramente según el sistema operativo y la versión. Consulte las notas de la versión oficial de LibreOffice y la ayuda de LibreOffice para la conexión PostgreSQL para obtener la terminología actualizada.

Antes de comenzar: Reúna los cuatro valores de conexión

Normalmente, necesitas cuatro datos del administrador de PostgreSQL:

• Nombre de la base de datos , como por ejemplo sales_ops:
• Nombre del servidor o dirección IP , como por ejemplo db.example.internal:
• Puerto , normalmente 5432a menos que el administrador lo haya cambiado.
• Nombre de usuario de PostgreSQL y su método de autenticación o contraseña.

No asuma que un servidor que acepta conexiones locales de PostgreSQL también aceptará una conexión de LibreOffice desde otro equipo. PostgreSQL listen_addressescontrola qué interfaces de red aceptan conexiones TCP/IP, mientras que pg_hba.confcontrola qué direcciones de cliente, bases de datos, usuarios y métodos de autenticación están permitidos. PostgreSQL documenta ambos comportamientos en su configuración de conexión y en la documentación de autenticación de clientes .

Paso 1: Abra Base y elija una base de datos PostgreSQL existente.

Inicie LibreOffice Base y cree un nuevo documento de base de datos. En el Asistente para bases de datos, seleccione « Conectar a una base de datos existente» y, a continuación, elija PostgreSQL como tipo de base de datos. El Asistente para bases de datos de LibreOffice admite explícitamente la conexión de un documento de Base a una base de datos existente, en lugar de crear una nueva base de datos integrada.

Leyenda: El Asistente de bases de datos está configurado para conectarse a una base de datos PostgreSQL existente en lugar de crear una nueva base de datos integrada.

En el ejemplo de Northwind Field Services, esto significa que Base almacenará la información de conexión y los objetos de Base, como consultas, formularios e informes, mientras que las tablas de negocio propiamente dichas permanecerán en PostgreSQL.

Paso 2: Introduzca el nombre de la base de datos, el servidor y el puerto.

En la página de conexión de PostgreSQL, introduzca el nombre de la base de datos, el servidor y el puerto proporcionados por su administrador. En el ejemplo que se muestra, esos valores son sales_ops, db.example.internal, y 5432.

Leyenda: Página de conexión directa a PostgreSQL con el nombre de la base de datos de ejemplo, el servidor y el puerto predeterminado de PostgreSQL.

LibreOffice también permite usar una cadena de conexión específica para PostgreSQL en lugar de rellenar los campos básicos. La ayuda oficial muestra formatos como dbname=MyDatabase host=myHost port=5432y postgresql://myHost:port/MyDatabase. Esto puede ser útil cuando un administrador proporciona parámetros adicionales específicos del controlador. LibreOffice indica que los valores user=y password=en esta cadena de conexión se ignoran y se solicita autenticación al momento de la conexión.

Paso 3: Introduzca el usuario de PostgreSQL y pruebe la conexión.

Introduzca el rol de PostgreSQL que se debe usar desde Base. Una cuenta de solo lectura o con privilegios mínimos suele ser un punto de partida más seguro que un propietario de la base de datos o un superusuario cuando el objetivo es generar informes o realizar análisis. En el ejemplo, el rol es analyst_ro.

Leyenda: La autenticación está configurada con el rol de solo lectura de ejemplo y la prueba de conexión informa que se realizó correctamente.

Utilice la función Probar conexión antes de guardar el documento Base. Una prueba exitosa confirma que Base puede conectarse al servidor y autenticarse con el rol especificado. Sin embargo, esto no garantiza que el rol tenga permiso para leer todas las tablas que se esperan utilizar, por lo que aún es necesario verificar la visibilidad de las tablas una vez establecida la conexión.

Si la prueba falla, conserve el mensaje exacto. Errores como no pg_hba.conf entry, password authentication failed, user does not exist, o tienen diferentes causas. La página de solución de problemas de autenticacióndatabase does not exist de PostgreSQL explica estos mensajes y recomienda revisar el registro del servidor cuando el error del cliente no sea suficiente.

Paso 4: Guardar el documento de la base de datos base.

Tras superar la prueba, elija si desea registrar la base de datos en LibreOffice y abrirla inmediatamente para editarla. El registro resulta útil cuando otros componentes de LibreOffice necesitan referirse a la fuente de datos por su nombre. A continuación, haga clic en Finalizar y guarde el documento base como un .odbarchivo.

Leyenda: La página final del asistente permite registrar la fuente de datos PostgreSQL y abrir el documento Base guardado para su edición.

En esta configuración, el .odbarchivo no es una copia de la base de datos PostgreSQL. Trátelo como el documento de base de datos de LibreOffice que contiene la definición de conexión y los objetos Base. Si mueve el .odbarchivo a otro equipo, este seguirá necesitando acceso a la red, credenciales válidas y los controladores o certificados necesarios.

Paso 5: Confirme que las tablas esperadas sean visibles.

Abra el documento Base guardado y seleccione Tablas . Debería ver los objetos a los que el rol de PostgreSQL tiene permiso para acceder. En el ejemplo ficticio, las tablas esperadas podrían incluir customers, orders, products, y order_items.

Leyenda: La vista de tablas base es la primera comprobación práctica de que el rol de PostgreSQL conectado puede ver los objetos de esquema esperados.

Si la conexión se establece correctamente pero faltan tablas, generalmente ya no se trata de un problema de red. Verifique los privilegios del rol de PostgreSQL, la visibilidad del esquema y la ruta de búsqueda del esquema. Antes de modificar los permisos, pregunte al administrador de la base de datos qué esquemas y objetos debería ver la cuenta.

Paso 6: Ejecute una pequeña consulta de solo lectura antes de crear formularios o informes.

Antes de crear una solución Base más grande, ejecute una consulta simple de solo lectura en una tabla pequeña. Por ejemplo:

SELECT customer_id, full_name, city
FROM customers
ORDER BY full_name;

Leyenda: Una pequeña consulta SELECT es una comprobación funcional útil después de que las tablas de PostgreSQL sean visibles en Base.

Esto verifica más que la prueba de conexión inicial: comprueba que Base pueda ejecutar SQL a través de la conexión, que el rol pueda leer el objeto de destino y que las filas devueltas sean utilizables en la interfaz de consulta de Base. Comience con SELECTsentencias si está validando una base de datos de producción. No realice pruebas insertando, actualizando o eliminando registros reales a menos que esto forme parte explícitamente de sus requisitos de acceso.

Paso 7: Configurar TLS cuando la política de la base de datos requiere cifrado.

Para una base de datos remota o de producción, siga los requisitos TLS de su organización en lugar de asumir que una conexión no cifrada es aceptable. PostgreSQL admite conexiones cliente/servidor cifradas cuando SSL está habilitado en el servidor, y los administradores pueden requerir reglas de host específicas de SSL en . Los detalles de configuración autorizados se encuentran en la documentación SSL/TLSpg_hba.conf de PostgreSQL .

La conexión directa de LibreOffice a PostgreSQL acepta parámetros de conexión específicos del controlador, pero no todos los parámetros de conexión de PostgreSQL son gestionados necesariamente por el administrador de controladores de LibreOffice. Si necesita verificación de certificados, certificados de cliente o un modo SSL específico para una política, confirme la cadena de conexión exacta con su administrador de base de datos y la documentación de LibreOffice para la versión instalada. En este punto, copiar una cadena de conexión genérica a Internet puede generar una falsa sensación de seguridad.

Leyenda: Un error de autenticación que menciona pg_hba.conf y el estado SSL apunta a la política de conexión del servidor, no simplemente a un nombre de documento Base mal escrito.

Paso 8: Utilice JDBC solo cuando necesite la ruta del controlador Java.

Si la opción de conexión directa a PostgreSQL no está disponible en su entorno o si un administrador estandariza específicamente el uso de JDBC, Base puede conectarse mediante un controlador JDBC. Este método requiere la instalación de Java y la configuración del controlador, por lo que se recomienda considerarlo como una alternativa deliberada en lugar de un requisito previo para cada conexión a PostgreSQL.

Descargue el controlador JDBC de PostgreSQL únicamente desde el sitio web oficial de pgJDBC . La documentación de pgJDBC indica que el archivo JAR del controlador debe estar en la ruta de clases de Java. La ayuda de JDBC de LibreOffice recomienda agregar la ruta del controlador en Herramientas > Opciones > LibreOffice > Avanzado > Ruta de clases y reiniciar LibreOffice posteriormente.

Leyenda: La función de reserva JDBC requiere un entorno de ejecución de Java y el archivo JAR JDBC de PostgreSQL en la ruta de clases de LibreOffice.

Para PostgreSQL, pgJDBC documenta las URL en el formato jdbc:postgresql://host:port/database. Con el servidor ficticio, sería jdbc:postgresql://db.example.internal:5432/sales_ops. La clase del controlador JDBC de PostgreSQL es org.postgresql.Driver; las aplicaciones Java modernas pueden cargarla a través del mecanismo de proveedor de servicios de Java cuando el JAR está presente, aunque el asistente JDBC de LibreOffice aún puede solicitar un valor de clase de controlador. Consulte la guía de configuración de pgJDBC , la documentación de URL de conexión de pgJDBC y la ayuda de JDBC de LibreOffice .

Tabla de solución rápida de problemas

Cómo debería ser una configuración exitosa

Un criterio de éxito útil no es simplemente que "la prueba de conexión haya sido superada". En el ejemplo de Northwind Field Services, la configuración está realmente lista cuando el documento base se vuelve a abrir correctamente, la analyst_rocuenta solo puede ver los objetos PostgreSQL previstos, una pequeña SELECTconsulta devuelve las filas esperadas y la conexión cumple con los requisitos de cifrado y autenticación de la organización.

Si llegas al punto en que las consultas básicas funcionan, pero los formularios o informes más complejos de Base presentan limitaciones de tipo de datos, rendimiento o específicas del controlador, deja de tratar el problema como un problema de conectividad. En ese caso, compara el conector directo de PostgreSQL con JDBC para la carga de trabajo específica y prueba la consulta o el tipo de datos exacto que importa. El método de conexión debe adaptarse a la política de la base de datos y a las funciones de Base que realmente utilizas, no convertirse en un fin en sí mismo.