Cum se conectează LibreOffice Base la o bază de date PostgreSQL

LibreOffice Base poate funcționa ca un front-end pentru o bază de date PostgreSQL existentă, astfel încât să puteți răsfoi tabele, să creați interogări și să construiți formulare sau rapoarte fără a muta datele într-o bază de date Base încorporată. Pentru majoritatea instalărilor actuale, cea mai curată rută este conexiunea directă PostgreSQL a LibreOffice. JDBC este încă util ca soluție de rezervă atunci când mediul dvs. necesită un driver Java sau când conectorul direct nu este disponibil.

Scenariu ilustrativ: imaginați-vă o mică echipă de operațiuni numită Northwind Field Services. Serverul său PostgreSQL conține o bază de date numită sales_ops. Baza de date rulează pe db.example.internal, ascultă pe portul 5432, iar echipa are un rol doar de citire numit analyst_ro. Exemplul este fictiv și este folosit doar pentru a arăta cum se îmbină deciziile de configurare.

Pașii de mai jos respectă instrucțiunile actuale ale Ajutorului LibreOffice pentru conexiunile PostgreSQL și JDBC și documentația actuală a serverului PostgreSQL. Începând cu octombrie 2026, LibreOffice listează versiunea 26.8.0 ca fiind cea mai recentă ramură și 26.2.6 ca fiind ramura anterioară matură; etichetele exacte sau amplasarea butoanelor pot varia ușor în funcție de sistemul de operare și de versiune. Consultați notele oficiale de lansare LibreOffice și ajutorul pentru conexiunile LibreOffice PostgreSQL pentru formularea actuală.

Înainte de a începe: Adunați cele patru valori de conexiune

În mod normal, aveți nevoie de patru informații de la administratorul PostgreSQL:

• Numele bazei de date , cum ar fi sales_ops.
• Numele serverului sau adresa IP , cum ar fi db.example.internal.
• Port , de obicei 5432cu excepția cazului în care administratorul l-a modificat.
• Conectare PostgreSQL și metoda de autentificare sau parola sa.

Nu presupuneți că un server care acceptă conexiuni PostgreSQL locale va accepta și o conexiune LibreOffice de la un alt computer. PostgreSQL listen_addressescontrolează ce interfețe de rețea acceptă conexiuni TCP/IP, în timp ce pg_hba.confcontrolează ce adrese de client, baze de date, utilizatori și metode de autentificare sunt permise. PostgreSQL documentează ambele comportamente în setările de conexiune și în documentația de autentificare a clientului .

Pasul 1: Deschideți Base și alegeți o bază de date PostgreSQL existentă

Porniți LibreOffice Base și creați un nou document de bază de date Base. În Expertul pentru baze de date, alegeți Conectare la o bază de date existentă , apoi selectați PostgreSQL ca tip de bază de date. Expertul pentru baze de date din LibreOffice acceptă în mod explicit conectarea unui document Base la o bază de date existentă, în loc să creați unul nou, încorporat.

Legendă: Expertul pentru baze de date este configurat să se conecteze la o bază de date PostgreSQL existentă, în loc să creeze o nouă bază de date încorporată.

Pentru exemplul Northwind Field Services, aceasta înseamnă că Base va stoca informațiile de conexiune și obiectele Base, cum ar fi interogările, formularele și rapoartele, în timp ce tabelele de business propriu-zise rămân în PostgreSQL.

Pasul 2: Introduceți numele bazei de date, serverul și portul

Pe pagina de conexiune PostgreSQL, introduceți numele bazei de date, serverul și portul furnizate de administrator. În exemplul care rulează, aceste valori sunt sales_ops, db.example.internalși 5432.

Legendă: Pagina de conexiune directă PostgreSQL cu numele bazei de date exemplu, serverul și portul PostgreSQL implicit.

LibreOffice permite, de asemenea, un șir de conexiune specific PostgreSQL în loc să completeze câmpurile de bază. Ajutorul oficial afișează formulare precum dbname=MyDatabase host=myHost port=5432și postgresql://myHost:port/MyDatabase. Acest lucru poate fi util atunci când un administrator vă oferă parametri suplimentari specifici driverului. LibreOffice notează că valorile user=și password=din acest șir de conexiune sunt ignorate și se solicită autentificarea la momentul conectării.

Pasul 3: Introduceți utilizatorul PostgreSQL și testați conexiunea

Introduceți rolul PostgreSQL care ar trebui utilizat din Base. Un cont doar pentru citire sau cu privilegii minime este de obicei un punct de plecare mai sigur decât un proprietar de bază de date sau un superutilizator atunci când scopul este raportarea sau analiza. În exemplu, rolul este analyst_ro.

Legendă: Autentificarea este configurată cu exemplul de rol doar în citire, iar testul de conexiune raportează succesul.

Folosiți opțiunea Testare conexiune înainte de a salva documentul Base. Un test reușit confirmă faptul că Base poate accesa serverul și se poate autentifica cu rolul furnizat. Nu dovedește că rolul are permisiunea de a citi fiecare tabel pe care vă așteptați să îl utilizați, așadar vizibilitatea tabelului trebuie verificată în continuare după deschiderea conexiunii.

Dacă testul eșuează, păstrați mesajul exact. Erori precum no pg_hba.conf entry, password authentication failed, user does not exist, sau au cauze diferite. Pagina de depanare a autentificăriidatabase does not exist PostgreSQL explică aceste mesaje și recomandă verificarea jurnalului serverului atunci când eroarea de pe partea clientului nu este suficientă.

Pasul 4: Salvați documentul bazei de date de bază

După ce testul trece, alegeți dacă doriți să înregistrați baza de date la LibreOffice și dacă doriți să o deschideți imediat pentru editare. Înregistrarea este utilă atunci când alte componente LibreOffice trebuie să se refere la sursa de date după nume. Apoi faceți clic pe Finalizare și salvați documentul Base ca .odbfișier.

Legendă: Pagina finală a expertului poate înregistra sursa de date PostgreSQL și poate deschide documentul Base salvat pentru editare.

Fișierul .odbnu este o copie a bazei de date PostgreSQL în această configurație. Tratați-l ca documentul bazei de date LibreOffice care conține definiția conexiunii și obiectele Base. Dacă mutați fișierul .odbpe un alt computer, computerul respectiv are nevoie în continuare de acces la rețea, acreditări valide și orice drivere sau certificate necesare.

Pasul 5: Confirmați că tabelele așteptate sunt vizibile

Deschideți documentul Base salvat și selectați Tabele . Ar trebui să vedeți obiectele la care are permisiunea de a accesa rolul PostgreSQL. În exemplul fictiv, tabelele așteptate ar putea include customers, orders, productsși order_items.

Legendă: Vizualizarea tabelelor de bază este prima verificare practică a faptului că rolul PostgreSQL conectat poate vedea obiectele schemei așteptate.

Dacă conexiunea reușește, dar lipsesc tabele, de obicei aceasta nu mai este o problemă de rețea. Verificați privilegiile rolului PostgreSQL, vizibilitatea schemei și calea de căutare a schemei. Întrebați administratorul bazei de date ce scheme și obiecte se așteaptă ca contul să vadă înainte de a schimba permisiunile.

Pasul 6: Executați o interogare mică doar în citire înainte de a crea formulare sau rapoarte

Înainte de a crea o soluție Base mai mare, executați o interogare simplă doar în citire pe un tabel mic. De exemplu:

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

Legendă: O interogare SELECT de scurtă durată este o verificare funcțională utilă după ce tabelele PostgreSQL devin vizibile în Base.

Aceasta verifică mai mult decât testul inițial de conexiune: verifică dacă Base poate executa SQL prin conexiune, dacă rolul poate citi obiectul țintă și dacă rândurile returnate sunt utilizabile în interfața de interogare Base. Începeți cu SELECTinstrucțiuni dacă validați o bază de date de producție. Nu testați prin inserarea, actualizarea sau ștergerea de înregistrări reale, cu excepția cazului în care acest lucru face parte în mod explicit din cerințele dvs. de acces.

Pasul 7: Configurați TLS atunci când politica bazei de date necesită criptare

Pentru o bază de date la distanță sau de producție, urmați cerințele TLS ale organizației dvs., în loc să presupuneți că o conexiune necriptată este acceptabilă. PostgreSQL acceptă conexiuni client/server criptate atunci când SSL este activat pe server, iar administratorii pot solicita reguli gazdă specifice SSL în [data] pg_hba.conf. Detaliile de configurare autoritară se află în documentația SSL/TLS a PostgreSQL .

Conexiunea PostgreSQL directă a LibreOffice acceptă parametri de conexiune specifici driverului, dar nu toți parametrii de conexiune PostgreSQL sunt neapărat gestionați de managerul de drivere LibreOffice. Dacă aveți nevoie de verificarea certificatului, certificate client sau un mod SSL specific politicii, confirmați șirul exact de conexiune cu administratorul bazei de date și cu documentația LibreOffice pentru versiunea instalată. Acesta este un punct în care copierea unui șir generic de conexiune la internet poate crea un fals sentiment de securitate.

Legendă: O eroare de autentificare care menționează pg_hba.conf și starea SSL indică politica de conexiune la server, nu doar un nume de document Base introdus greșit.

Pasul 8: Folosiți JDBC doar atunci când aveți nevoie de calea driverului Java

Dacă opțiunea PostgreSQL direct nu este disponibilă în mediul dvs. sau dacă un administrator standardizează în mod specific JDBC, Base se poate conecta printr-un driver JDBC. Această cale adaugă configurarea Java și a driverului, așa că este mai bine să fie tratată ca o alternativă deliberată, decât ca o condiție prealabilă pentru fiecare conexiune PostgreSQL.

Descărcați driverul PostgreSQL JDBC doar de pe site-ul oficial pgJDBC . Documentația pgJDBC precizează că fișierul JAR al driverului trebuie să se afle pe calea de clase Java. Ajutorul JDBC din LibreOffice instruiește utilizatorii să adauge calea driverului sub Instrumente > Opțiuni > LibreOffice > Avansat > Cale de clase și să repornească LibreOffice ulterior.

Legendă: Soluția JDBC necesită un runtime Java și fișierul JAR PostgreSQL JDBC pe calea de clase a LibreOffice.

Pentru PostgreSQL, pgJDBC documentează URL-urile sub forma jdbc:postgresql://host:port/database. Cu serverul fictiv, aceasta ar fi jdbc:postgresql://db.example.internal:5432/sales_ops. Clasa driverului PostgreSQL JDBC este org.postgresql.Driver; aplicațiile Java moderne o pot încărca prin mecanismul furnizorului de servicii Java atunci când este prezent JAR-ul, deși expertul JDBC din LibreOffice poate solicita în continuare o valoare a clasei driverului. Consultați ghidul de configurare pgJDBC , documentația URL-ului de conexiune pgJDBC și ajutorul LibreOffice JDBC .

Tabel de depanare rapidă

Cum ar trebui să arate o configurare reușită

Un criteriu de succes util nu este doar „testul de conexiune reușit”. În exemplul Northwind Field Services, configurarea este cu adevărat gata atunci când documentul Base se redeschide fără probleme, contul analyst_ropoate vedea doar obiectele PostgreSQL dorite, o SELECTinterogare mică returnează rândurile așteptate, iar conexiunea îndeplinește cerințele de criptare și autentificare ale organizației.

Dacă ajungeți în punctul în care interogările de bază funcționează, dar formularele sau rapoartele Base mai complexe expun limitări specifice tipului de date, performanței sau driverelor, nu mai tratați problema ca pe o problemă de conectivitate. În acel moment, comparați conectorul PostgreSQL direct cu JDBC pentru sarcina de lucru specifică și testați exact interogarea sau tipul de date care contează. Metoda de conectare ar trebui să servească politicii bazei de date și funcțiilor Base pe care le utilizați efectiv, nu să devină un scop în sine.