O LibreOffice Base pode funcionar como uma interface para um banco de dados PostgreSQL existente, permitindo navegar pelas tabelas, criar consultas e gerar formulários ou relatórios sem precisar mover os dados para um banco de dados Base embutido. Para a maioria das instalações atuais, a maneira mais simples é através da conexão direta do LibreOffice com o PostgreSQL. O JDBC ainda é útil como alternativa quando seu ambiente exige um driver Java ou quando o conector direto não está disponível.
Cenário ilustrativo: imagine uma pequena equipe de operações chamada Northwind Field Services. Seu servidor PostgreSQL contém um banco de dados chamado sales_ops. O banco de dados é executado em db.example.internal, escuta na porta 5432, e a equipe possui uma função somente leitura chamada analyst_ro. O exemplo é fictício e serve apenas para mostrar como as decisões de configuração se encaixam.
Os passos abaixo seguem a Ajuda atual do LibreOffice para conexões PostgreSQL e JDBC e a documentação atual do servidor PostgreSQL. Em outubro de 2026, o LibreOffice listava a versão 26.8.0 como a versão mais recente e a 26.2.6 como a versão anterior estável; os rótulos exatos ou a posição dos botões podem variar ligeiramente de acordo com o sistema operacional e a versão. Consulte as notas de versão oficiais do LibreOffice e a ajuda de conexão PostgreSQL do LibreOffice para obter a redação atual.
Antes de começar: Reúna os quatro valores de conexão.
Normalmente, você precisa de quatro informações do administrador do PostgreSQL:
- Nome do banco de dados , como por exemplo
sales_ops:
- Nome do servidor ou endereço IP , como por exemplo
db.example.internal:
- A porta geralmente é a mesma,
5432a menos que o administrador a tenha alterado.
- Login do PostgreSQL e seu método de autenticação ou senha.
Não presuma que um servidor que aceita conexões locais do PostgreSQL também aceitará uma conexão do LibreOffice de outro computador. O PostgreSQL listen_addressescontrola quais interfaces de rede aceitam conexões TCP/IP, enquanto o LibreOffice pg_hba.confcontrola quais endereços de clientes, bancos de dados, usuários e métodos de autenticação são permitidos. O PostgreSQL documenta ambos os comportamentos em sua documentação de configurações de conexão e autenticação de clientes .
Passo 1: Abra o Base e escolha um banco de dados PostgreSQL existente.
Inicie o LibreOffice Base e crie um novo documento de banco de dados Base. No Assistente de Banco de Dados, escolha Conectar a um banco de dados existente e selecione PostgreSQL como o tipo de banco de dados. O Assistente de Banco de Dados do LibreOffice oferece suporte explícito à conexão de um documento Base a um banco de dados existente, em vez de criar um novo banco de dados incorporado.
Legenda: O Assistente de Banco de Dados está configurado para se conectar a um banco de dados PostgreSQL existente em vez de criar um novo banco de dados incorporado.
No exemplo da Northwind Field Services, isso significa que o Base armazenará informações de conexão e objetos do Base, como consultas, formulários e relatórios, enquanto as tabelas de negócios propriamente ditas permanecerão no PostgreSQL.
Etapa 2: Insira o nome do banco de dados, o servidor e a porta.
Na página de conexão do PostgreSQL, insira o nome do banco de dados, o servidor e a porta fornecidos pelo seu administrador. No exemplo em execução, esses valores são sales_ops, db.example.internal, e 5432.
Legenda: Página de conexão direta com o PostgreSQL, mostrando o nome do banco de dados, o servidor e a porta padrão do PostgreSQL como exemplos.
O LibreOffice também permite uma string de conexão específica para PostgreSQL em vez de preencher os campos básicos. A ajuda oficial mostra formatos como `<nome_da_string>` dbname=MyDatabase host=myHost port=5432e ` postgresql://myHost:port/MyDatabase<nome_da_string>`. Isso pode ser útil quando um administrador fornece parâmetros adicionais específicos do driver. O LibreOffice observa que os valores `<nome_da_string>` user=e password=`<nome_da_string>` nessa string de conexão são ignorados e a autenticação é solicitada no momento da conexão.
Passo 3: Insira o usuário do PostgreSQL e teste a conexão.
Insira a função do PostgreSQL que deve ser usada a partir do Base. Uma conta somente leitura ou com privilégios mínimos geralmente é um ponto de partida mais seguro do que um proprietário de banco de dados ou superusuário quando o objetivo é gerar relatórios ou realizar análises. No exemplo, a função é analyst_ro.
Legenda: A autenticação está configurada com a função de exemplo somente leitura e o teste de conexão reporta sucesso.
Use o recurso Testar Conexão antes de salvar o documento Base. Um teste bem-sucedido confirma que o Base consegue acessar o servidor e autenticar com a função fornecida. Isso não comprova que a função tem permissão para ler todas as tabelas que você espera usar, portanto, a visibilidade das tabelas ainda precisa ser verificada após a conexão ser estabelecida.
Se o teste falhar, guarde a mensagem exata. Erros como no pg_hba.conf entry, password authentication failed, user does not exist, ou têm causas diferentes. A página de solução de problemas de autenticaçãodatabase does not exist do PostgreSQL explica essas mensagens e recomenda verificar o log do servidor quando o erro do lado do cliente não for suficiente.
Etapa 4: Salvar o documento do banco de dados base
Após o teste ser aprovado, escolha se deseja registrar o banco de dados no LibreOffice e se deseja abri-lo imediatamente para edição. O registro é útil quando outros componentes do LibreOffice precisam se referir à fonte de dados pelo nome. Em seguida, clique em Concluir e salve o documento Base como um .odbarquivo.
Legenda: A página final do assistente permite registrar a fonte de dados PostgreSQL e abrir o documento Base salvo para edição.
Nesta configuração, o .odbarquivo não é uma cópia do banco de dados PostgreSQL. Considere-o como o documento de banco de dados do LibreOffice que contém a definição de conexão e os objetos Base. Se você mover o .odbarquivo para outro computador, esse computador ainda precisará de acesso à rede, credenciais válidas e quaisquer drivers ou certificados necessários.
Etapa 5: Confirme se as tabelas esperadas estão visíveis.
Abra o documento Base salvo e selecione Tabelas . Você deverá ver os objetos aos quais a função PostgreSQL tem permissão de acesso. No exemplo fictício, as tabelas esperadas podem incluir customers, orders, products, e order_items.
Legenda: A visualização das tabelas base é a primeira verificação prática de que a função PostgreSQL conectada consegue visualizar os objetos de esquema esperados.
Se a conexão for bem-sucedida, mas as tabelas estiverem faltando, geralmente isso não é mais um problema de rede. Verifique os privilégios da função PostgreSQL, a visibilidade do esquema e o caminho de pesquisa do esquema. Antes de alterar as permissões por conta própria, pergunte ao administrador do banco de dados quais esquemas e objetos a conta deve visualizar.
Etapa 6: Execute uma pequena consulta somente leitura antes de criar formulários ou relatórios.
Antes de criar uma solução Base maior, execute uma consulta simples de leitura em uma tabela pequena. Por exemplo:
SELECT customer_id, full_name, city
FROM customers
ORDER BY full_name;
Legenda: Uma pequena consulta SELECT é uma verificação funcional útil depois que as tabelas do PostgreSQL se tornam visíveis no Base.
Esta verificação vai além do teste de conexão inicial: ela verifica se o Base consegue executar SQL através da conexão, se a função consegue ler o objeto de destino e se as linhas retornadas são utilizáveis na interface de consulta do Base. Comece com SELECTinstruções SELECT se estiver validando um banco de dados de produção. Não teste inserindo, atualizando ou excluindo registros reais, a menos que isso faça parte explicitamente dos seus requisitos de acesso.
Etapa 7: Configurar TLS quando a política do banco de dados exigir criptografia
Para um banco de dados remoto ou de produção, siga os requisitos de TLS da sua organização em vez de presumir que uma conexão não criptografada seja aceitável. O PostgreSQL oferece suporte a conexões cliente/servidor criptografadas quando o SSL está habilitado no servidor, e os administradores podem exigir regras de host específicas para SSL . Os detalhes de configuração oficiais estão na documentação de SSL/TLSpg_hba.conf do PostgreSQL .
A conexão direta do LibreOffice com o PostgreSQL aceita parâmetros de conexão específicos do driver, mas nem todos os parâmetros de conexão do PostgreSQL são necessariamente tratados pelo gerenciador de drivers do LibreOffice. Se você precisar de verificação de certificado, certificados de cliente ou um modo SSL específico para determinadas políticas, confirme a string de conexão exata com o administrador do banco de dados e consulte a documentação do LibreOffice para a sua versão instalada. Nesse ponto, copiar uma string de conexão genérica da Internet pode gerar uma falsa sensação de segurança.
Legenda: Um erro de autenticação que menciona pg_hba.conf e o estado SSL aponta para a política de conexão do lado do servidor, e não simplesmente para um nome de documento Base digitado incorretamente.
Etapa 8: Use JDBC somente quando precisar do caminho do driver Java.
Se a opção direta de conexão com o PostgreSQL não estiver disponível em seu ambiente ou se um administrador padronizar especificamente o uso do JDBC, o Base pode se conectar por meio de um driver JDBC. Essa opção adiciona a configuração do Java e do driver, portanto, é melhor considerá-la uma alternativa deliberada, e não um pré-requisito para todas as conexões com o PostgreSQL.
Baixe o driver JDBC do PostgreSQL somente do site oficial do pgJDBC . A documentação do pgJDBC afirma que o arquivo JAR do driver deve estar no classpath do Java. A ajuda do JDBC do LibreOffice instrui os usuários a adicionar o caminho do driver em Ferramentas > Opções > LibreOffice > Avançado > Classpath e reiniciar o LibreOffice em seguida.
Legenda: O recurso de fallback para JDBC requer um ambiente de execução Java e o arquivo JAR do JDBC do PostgreSQL no classpath do LibreOffice.
Para o PostgreSQL, o pgJDBC documenta URLs no formato `<nome_do_servidor>` jdbc:postgresql://host:port/database. Com o servidor fictício, seria ` <nome_do_servidor> jdbc:postgresql://db.example.internal:5432/sales_ops`. A classe do driver JDBC do PostgreSQL é org.postgresql.Driver`<nome_do_driver>`; aplicações Java modernas podem carregá-la através do mecanismo de provedor de serviços do Java quando o arquivo JAR estiver presente, embora o assistente JDBC do LibreOffice ainda possa solicitar um valor para a classe do driver. Consulte o guia de configuração do pgJDBC , a documentação sobre URLs de conexão do pgJDBC e a ajuda do JDBC do LibreOffice .
Tabela de Solução Rápida de Problemas
| Sintoma | A próxima verificação mais útil |
| Conexão recusada ou tempo limite excedido | Confirme o nome do servidor, a porta, o caminho do firewall, o PostgreSQL listen_addressese se o servidor está realmente escutando nessa interface. |
no pg_hba.conf entry | Peça ao administrador para verificar a regra correspondente de host/banco de dados/usuário e se a conexão deve usar SSL. |
| Falha na autenticação da senha | Verifique a função e a senha do PostgreSQL; não assuma que o nome da conta do sistema operacional seja a função do banco de dados. |
| A conexão funciona, mas faltam tabelas. | Verifique os privilégios da função, a visibilidade do esquema e o caminho de esquema/pesquisa esperado. |
| Não foi possível carregar a classe do driver JDBC. | Confirme se o arquivo JAR do pgJDBC está no classpath do LibreOffice, se o Java está habilitado e se o LibreOffice foi reiniciado. |
| Funciona em um computador, mas não em outro. | Compare a acessibilidade de DNS/rede, as regras de IP do cliente pg_hba.conf, os certificados, a configuração local de Java/JDBC (se utilizada) e as credenciais salvas. |
Como deve ser uma configuração bem-sucedida
Um critério de sucesso útil não é simplesmente "o teste de conexão ter sido aprovado". No exemplo da Northwind Field Services, a configuração está realmente pronta quando o documento Base é reaberto sem problemas, a analyst_roconta consegue visualizar apenas os objetos PostgreSQL pretendidos, uma pequena SELECTconsulta retorna as linhas esperadas e a conexão atende aos requisitos de criptografia e autenticação da organização.
Se você chegar ao ponto em que consultas básicas funcionam, mas formulários ou relatórios Base mais complexos expõem limitações específicas de tipo de dados, desempenho ou driver, pare de tratar o problema como uma questão de conectividade. Nesse estágio, compare o conector PostgreSQL direto com o JDBC para a carga de trabalho específica e teste a consulta ou o tipo de dados exato que importa. O método de conexão deve atender à política do banco de dados e aos recursos do Base que você realmente usa, e não se tornar um fim em si mesmo.