How to Connect LibreOffice Base to a PostgreSQL Database

LibreOffice Base can work as a front end for an existing PostgreSQL database, so you can browse tables, create queries, and build forms or reports without moving the data into an embedded Base database. For most current installations, the cleanest route is LibreOffice's direct PostgreSQL connection. JDBC is still useful as a fallback when your environment requires a Java driver or when the direct connector is unavailable.

Illustrative scenario: imagine a small operations team called Northwind Field Services. Its PostgreSQL server contains a database named sales_ops. The database runs on db.example.internal, listens on port 5432, and the team has a read-only role named analyst_ro. The example is fictional and is used only to show how the setup decisions fit together.

The steps below follow the current LibreOffice Help for PostgreSQL and JDBC connections and PostgreSQL's current server documentation. As of October 2026, LibreOffice lists 26.8.0 as the latest branch and 26.2.6 as the mature previous branch; exact labels or button placement can vary slightly by operating system and release. See the official LibreOffice release notes and LibreOffice PostgreSQL connection help for the current wording.

Before You Start: Gather the Four Connection Values

You normally need four pieces of information from the PostgreSQL administrator:

• Database name, such as sales_ops.
• Server name or IP address, such as db.example.internal.
• Port, usually 5432 unless the administrator changed it.
• PostgreSQL login and its authentication method or password.

Do not assume that a server accepting local PostgreSQL connections will also accept a LibreOffice connection from another computer. PostgreSQL's listen_addresses controls which network interfaces accept TCP/IP connections, while pg_hba.conf controls which client addresses, databases, users, and authentication methods are allowed. PostgreSQL documents both behaviors in its connection settings and client authentication documentation.

Step 1: Open Base and Choose an Existing PostgreSQL Database

Start LibreOffice Base and create a new Base database document. In the Database Wizard, choose Connect to an existing database, then select PostgreSQL as the database type. LibreOffice's Database Wizard explicitly supports connecting a Base document to an existing database rather than creating a new embedded one.

Caption: The Database Wizard is set to connect to an existing PostgreSQL database rather than create a new embedded database.

Northwind Field Servicesの例では、これはBaseが接続情報とクエリ、フォーム、レポートなどのBaseオブジェクトを格納し、実際の業務テーブルはPostgreSQLに残ることを意味します。

ステップ2：データベース名、サーバー、ポート番号を入力します。

PostgreSQL接続ページで、管理者から提供されたデータベース名、サーバー、ポートを入力します。実行例では、これらの値はsales_ops、、、db.example.internalおよびです5432。

キャプション：データベース名、サーバー、デフォルトのPostgreSQLポートの例を含む、PostgreSQLへの直接接続ページ。

LibreOfficeでは、基本フィールドに入力する代わりに、PostgreSQL固有の接続文字列を使用することもできます。公式ヘルプには、dbname=MyDatabase host=myHost port=5432やなどの形式が示されていますpostgresql://myHost:port/MyDatabase。これは、管理者から追加のドライバ固有のパラメータが提供される場合に便利です。LibreOfficeは、この接続文字列内のuser=およびのpassword=値は無視され、接続時に認証が要求されることに注意してください。

ステップ3：PostgreSQLユーザーを入力して接続をテストする

Base から使用する PostgreSQL ロールを入力します。レポート作成や分析が目的の場合、データベース所有者やスーパーユーザーよりも読み取り専用または最小権限のアカウントの方が通常は安全な開始点となります。この例では、ロールは ですanalyst_ro。

キャプション：認証はサンプル読み取り専用ロールで構成されており、接続テストは成功を報告しています。

Baseドキュメントを保存する前に、接続テストを実行してください。テストが成功すれば、Baseがサーバーに接続し、指定されたロールで認証できることが確認できます。ただし、このテストは、そのロールが使用予定のすべてのテーブルを読み取る権限を持っていることを証明するものではありません。そのため、接続が確立された後も、テーブルの可視性を確認する必要があります。

テストが失敗した場合は、正確なメッセージを記録してください。、、、などのエラーにno pg_hba.conf entryはそれぞれ異なる原因があります。PostgreSQLの認証トラブルシューティングページでpassword authentication failedは、これらのメッセージについて説明し、クライアント側のエラーだけでは不十分な場合はサーバーログを確認することを推奨しています。user does not existdatabase does not exist

ステップ4：ベースデータベースドキュメントを保存する

テストに合格したら、データベースをLibreOfficeに登録するかどうか、そしてすぐに編集のために開くかどうかを選択します。登録は、他のLibreOfficeコンポーネントがデータソースを名前で参照する必要がある場合に便利です。その後、「完了」をクリックして、ベースドキュメントを.odbファイルとして保存します。

キャプション：最後のウィザードページでは、PostgreSQLデータソースを登録し、保存済みのBaseドキュメントを開いて編集できます。

この.odbファイルは、この設定におけるPostgreSQLデータベースのコピーではありません。接続定義とBaseオブジェクトを保持するLibreOffice側のデータベースドキュメントとして扱ってください。この.odbファイルを別のコンピュータに移動する場合、そのコンピュータにはネットワークアクセス、有効な認証情報、および必要なドライバや証明書が引き続き必要です。

ステップ5：期待されるテーブルが表示されていることを確認する

保存したベース ドキュメントを開き、[テーブル]を選択します。PostgreSQL ロールがアクセスを許可されているオブジェクトが表示されます。架空の例では、想定されるテーブルには、、、、およびが含まれる可能性がcustomersあります。ordersproductsorder_items

キャプション：ベーステーブルビューは、接続されているPostgreSQLロールが期待されるスキーマオブジェクトを参照できることを確認するための最初の実用的なチェックです。

接続は成功したがテーブルが見つからない場合、通常はネットワークの問題ではありません。PostgreSQLロールの権限、スキーマの可視性、およびスキーマ検索パスを確認してください。権限を自分で変更する前に、データベース管理者に、そのアカウントがどのスキーマとオブジェクトを参照できるかを確認してください。

ステップ6：フォームやレポートを作成する前に、小規模な読み取り専用クエリを実行する

より大規模なベースソリューションを作成する前に、小さなテーブルに対して単純な読み取り専用クエリを実行してください。例：

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

キャプション：PostgreSQLテーブルがBaseに表示されるようになった後、簡単なSELECTクエリを実行すると、便利な機能チェックができます。

これは、最初の接続テスト以上のことを検証します。Baseが接続を介してSQLを実行できること、ロールがターゲットオブジェクトを読み取れること、および返された行がBaseクエリインターフェイスで使用できることを確認します。SELECT本番データベースを検証する場合は、ステートメントから始めてください。アクセス要件に明示的に含まれていない限り、実際のレコードを挿入、更新、または削除してテストしないでください。

ステップ7：データベースポリシーで暗号化が必要な場合にTLSを設定する

リモートデータベースまたは本番データベースの場合は、暗号化されていない接続が許容されると想定するのではなく、組織のTLS要件に従ってください。PostgreSQLは、サーバーでSSLが有効になっている場合、暗号化されたクライアント/サーバー接続をサポートしており、管理者はSSL固有のホストルールを要求できますpg_hba.conf。設定の詳細については、PostgreSQLのSSL/TLSドキュメントを参照してください。

LibreOffice の PostgreSQL への直接接続は、ドライバ固有の接続パラメータを受け入れますが、すべての PostgreSQL 接続パラメータが LibreOffice ドライバマネージャによって必ずしも処理されるわけではありません。証明書の検証、クライアント証明書、またはポリシー固有の SSL モードが必要な場合は、データベース管理者と、インストールされているバージョンの LibreOffice のドキュメントを参照して、正確な接続文字列を確認してください。このような場合、一般的なインターネット接続文字列をコピーすると、誤った安心感を与えてしまう可能性があります。

キャプション：pg_hba.confとSSL状態に関する認証エラーは、単にベースドキュメント名の入力ミスではなく、サーバー側の接続ポリシーを示しています。

ステップ8：Javaドライバパスが必要な場合にのみJDBCを使用する

環境によってはPostgreSQLへの直接接続が利用できない場合や、管理者がJDBCを標準としている場合、BaseはJDBCドライバを介して接続できます。この方法ではJavaとドライバの設定が必要となるため、すべてのPostgreSQL接続の前提条件というよりは、意図的な代替手段として扱う方が適切です。

PostgreSQL JDBCドライバは、公式のpgJDBCサイトからのみダウンロードしてください。pgJDBCのドキュメントには、ドライバJARファイルがJavaクラスパス上に存在する必要があると記載されています。LibreOfficeのJDBCヘルプでは、ツール > オプション > LibreOffice > 詳細設定 > クラスパスでドライバパスを追加し、その後LibreOfficeを再起動するように指示されています。

キャプション：JDBCフォールバックには、LibreOfficeのクラスパス上にJavaランタイムとPostgreSQL JDBC JARが必要です。

PostgreSQLの場合、pgJDBCドキュメントではURLが の形式で記述されていますjdbc:postgresql://host:port/database。架空のサーバーの場合、 となりますjdbc:postgresql://db.example.internal:5432/sales_ops。PostgreSQL JDBCドライバクラスは です。org.postgresql.Driver最新のJavaアプリケーションは、JARファイルが存在する場合、Javaのサービスプロバイダメカニズムを介してこれをロードできますが、LibreOfficeのJDBCウィザードではドライバクラスの値を要求する場合があります。pgJDBCセットアップガイド、pgJDBC接続URLドキュメント、およびLibreOffice JDBCヘルプを参照してください。

クイックトラブルシューティング表

成功するセットアップとはどのようなものか

有用な成功基準は、単に「接続テストに合格した」ということではありません。Northwind Field Servicesの例では、Baseドキュメントが正常に再起動し、アカウントがanalyst_ro意図したPostgreSQLオブジェクトのみを表示でき、小さなSELECTクエリが期待どおりの行を返し、接続が組織の暗号化および認証要件を満たしたときに、セットアップが真に完了したと言えます。

基本的なクエリは正常に動作するものの、より複雑なBaseフォームやレポートでデータ型、パフォーマンス、またはドライバ固有の制限が露呈するような状況に陥った場合は、接続の問題として扱うのをやめてください。その段階では、特定のワークロードに対してPostgreSQLの直接コネクタとJDBCを比較し、重要なクエリやデータ型を正確にテストしてください。接続方法は、データベースポリシーと実際に使用するBase機能に役立つものでなければならず、それ自体が目的であってはなりません。