LibreOffice Base를 PostgreSQL 데이터베이스에 연결하는 방법

LibreOffice Base는 기존 PostgreSQL 데이터베이스의 프런트엔드 역할을 할 수 있으므로, 데이터를 내장된 Base 데이터베이스로 옮기지 않고도 테이블을 탐색하고, 쿼리를 작성하고, 폼이나 보고서를 만들 수 있습니다. 대부분의 최신 설치 환경에서는 LibreOffice의 PostgreSQL 직접 연결이 가장 깔끔한 방법입니다. 환경에 Java 드라이버가 필요하거나 직접 연결을 사용할 수 없는 경우에는 JDBC를 대체 수단으로 사용할 수 있습니다.

예시 시나리오: Northwind Field Services라는 소규모 운영팀이 있다고 가정해 보겠습니다. 이 팀의 PostgreSQL 서버에는 라는 이름의 데이터베이스가 있습니다 sales_ops. 이 데이터베이스는 에서 실행되고 db.example.internal, 포트 에서 수신 대기하며 5432, 팀은 라는 이름의 읽기 전용 역할을 가지고 있습니다 analyst_ro. 이 예시는 가상의 시나리오이며, 설정 결정이 어떻게 이루어지는지 보여주기 위한 것입니다.

아래 단계는 PostgreSQL 및 JDBC 연결에 대한 LibreOffice 도움말과 PostgreSQL 서버 문서의 최신 버전을 따릅니다. 2026년 10월 현재 LibreOffice는 26.8.0을 최신 버전으로, 26.2.6을 안정적인 이전 버전으로 명시하고 있습니다. 정확한 레이블이나 버튼 위치는 운영 체제 및 릴리스 버전에 따라 약간씩 다를 수 있습니다. 최신 내용은 LibreOffice 공식 릴리스 노트 와 LibreOffice PostgreSQL 연결 도움말을 참조하십시오.

시작하기 전에: 네 가지 연결 가치를 수집하세요

일반적으로 PostgreSQL 관리자로부터 다음 네 가지 정보를 얻어야 합니다.

• 데이터베이스 이름 (예: sales_ops).
• 서버 이름 또는 IP 주소 (예: db.example.internal).
• 일반적으로 포트는5432 관리자가 변경하지 않은 경우 그대로입니다.
• PostgreSQL 로그인 및 인증 방법 또는 비밀번호.

로컬 PostgreSQL 연결을 허용하는 서버가 다른 컴퓨터의 LibreOffice 연결도 허용할 것이라고 가정하지 마십시오. PostgreSQL은 listen_addressesTCP/IP 연결을 허용하는 네트워크 인터페이스를 제어하고, pg_hba.conf허용되는 클라이언트 주소, 데이터베이스, 사용자 및 인증 방법을 제어합니다. PostgreSQL은 연결 설정 및 클라이언트 인증 문서 에서 이러한 두 가지 동작에 대해 설명합니다 .

1단계: Base를 열고 기존 PostgreSQL 데이터베이스를 선택합니다.

LibreOffice Base를 실행하고 새 Base 데이터베이스 문서를 만드세요. 데이터베이스 마법사에서 ' 기존 데이터베이스에 연결'을 선택한 다음 데이터베이스 유형으로 PostgreSQL을 선택합니다 . LibreOffice의 데이터베이스 마법사는 새 내장 데이터베이스를 생성하는 대신 기존 데이터베이스에 Base 문서를 연결하는 기능을 명시적으로 지원합니다.

설명: 데이터베이스 마법사가 새 내장 데이터베이스를 생성하는 대신 기존 PostgreSQL 데이터베이스에 연결하도록 설정되어 있습니다.

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, password authentication failed, user does not exist, 또는 와 같은 오류 database does not exist는 원인이 다릅니다. PostgreSQL 인증 문제 해결 페이지 에서는 이러한 메시지에 대해 설명하고 클라이언트 측 오류만으로는 해결되지 않을 경우 서버 로그를 확인하도록 권장합니다.

4단계: 기본 데이터베이스 문서를 저장합니다.

테스트가 통과되면 데이터베이스를 LibreOffice에 등록할지, 그리고 바로 편집 모드로 열지 여부를 선택하십시오. 등록은 다른 LibreOffice 구성 요소에서 데이터 소스를 이름으로 참조해야 할 때 유용합니다. 그런 다음 마침을 클릭 하고 기본 문서를 .odb파일로 저장하십시오.

캡션: 마법사의 마지막 페이지에서 PostgreSQL 데이터 소스를 등록하고 저장된 기본 문서를 편집 모드로 열 수 있습니다.

이 설정에서 해당 .odb파일은 PostgreSQL 데이터베이스의 복사본이 아닙니다. 연결 정의 및 기본 개체를 포함하는 LibreOffice 측 데이터베이스 문서로 간주하십시오. 파일을 .odb다른 컴퓨터로 이동하는 경우 해당 컴퓨터에도 네트워크 액세스, 유효한 자격 증명, 필요한 드라이버 또는 인증서가 필요합니다.

5단계: 예상했던 테이블이 표시되는지 확인합니다.

저장된 기본 문서를 열고 테이블을 선택합니다 . PostgreSQL 역할이 액세스할 수 있는 개체가 표시됩니다. 가상의 예에서 예상되는 테이블에는 customers, orders, products, 및 가 포함될 수 있습니다 order_items.

캡션: 기본 테이블 보기는 연결된 PostgreSQL 역할이 예상되는 스키마 객체를 볼 수 있는지 확인하는 첫 번째 실질적인 검사입니다.

연결은 성공했지만 테이블이 누락된 경우, 이는 일반적으로 네트워크 문제가 아닙니다. PostgreSQL 역할의 권한, 스키마 가시성 및 스키마 검색 경로를 확인하십시오. 권한을 직접 변경하기 전에 데이터베이스 관리자에게 해당 계정이 볼 수 있어야 하는 스키마와 객체가 무엇인지 문의하십시오.

6단계: 양식이나 보고서를 만들기 전에 간단한 읽기 전용 쿼리를 실행하세요.

더 큰 규모의 Base 솔루션을 만들기 전에 작은 테이블에 대해 간단한 읽기 전용 쿼리를 실행해 보세요. 예를 들면 다음과 같습니다.

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

캡션: PostgreSQL 테이블이 Base에 표시된 후에는 간단한 SELECT 쿼리를 사용하여 기능을 확인하는 것이 유용합니다.

이 테스트는 초기 연결 테스트 이상의 것을 검증합니다. Base가 해당 연결을 통해 SQL을 실행할 수 있는지, 역할이 대상 객체를 읽을 수 있는지, 그리고 반환된 행이 Base 쿼리 인터페이스에서 사용 가능한지 확인합니다. SELECT운영 데이터베이스를 검증하는 경우 SQL 문부터 시작하십시오. 액세스 요구 사항에 명시적으로 포함되지 않는 한 실제 레코드를 삽입, 업데이트 또는 삭제하는 방식으로 테스트하지 마십시오.

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 대체 기능을 사용하려면 Java 런타임과 LibreOffice의 클래스 경로에 PostgreSQL JDBC JAR 파일이 있어야 합니다.

PostgreSQL의 경우 pgJDBC는 URL을 `<postgreSQL_name>` 형식으로 문서화합니다 jdbc:postgresql://host:port/database. 가상의 서버를 예로 들면 `<postgreSQL_name>`이 됩니다 jdbc:postgresql://db.example.internal:5432/sales_ops. PostgreSQL JDBC 드라이버 클래스는 `<postgreSQL_name>`입니다 org.postgresql.Driver. 최신 Java 애플리케이션은 JAR 파일이 있는 경우 Java의 서비스 제공자 메커니즘을 통해 이 드라이버를 로드할 수 있지만, LibreOffice의 JDBC 마법사에서 드라이버 클래스 값을 요청할 수도 있습니다. 자세한 내용은 pgJDBC 설정 가이드 , pgJDBC 연결 URL 문서 및 LibreOffice JDBC 도움말을 참조하십시오 .

빠른 문제 해결 표

성공적인 설정의 모습은 다음과 같아야 합니다.

유용한 성공 기준은 단순히 "연결 테스트 통과"가 아닙니다. Northwind Field Services 사례에서처럼, 기본 문서가 제대로 다시 열리고, 계정이 analyst_ro의도한 PostgreSQL 객체만 볼 수 있고, 간단한 SELECT쿼리가 예상되는 행을 반환하고, 연결이 조직의 암호화 및 인증 요구 사항을 충족할 때 설정이 진정으로 준비된 것입니다.

기본 쿼리는 정상적으로 작동하지만, 더 복잡한 Base 폼이나 보고서에서 데이터 형식, 성능 또는 드라이버 관련 제약 사항이 드러나는 경우, 해당 문제를 연결 문제로만 생각하지 마십시오. 이 단계에서는 특정 워크로드에 대해 PostgreSQL 직접 커넥터와 JDBC를 비교하고, 중요한 쿼리 또는 데이터 형식을 정확하게 테스트하십시오. 연결 방식은 데이터베이스 정책과 실제로 사용하는 Base 기능을 지원하는 데 사용되어야 하며, 그 자체가 목적이 되어서는 안 됩니다.