libpq 개요

libpq란?

libpq is the C application programmer’s interface to PostgreSQL. libpq is a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries.
– PostgreSQL JDBC공식 문서 –

libpq는 C 언어로 작성된 프로그램이 PostgreSQL 데이터베이스에 연결하고 쿼리를 처리할 수 있도록 해주는 라이브러리 입니다.

<aside> C++, Perl, Python 등 여러 프로그래밍 언어로 작성된 대부분의 클라이언트 인터페이스에서는 libpq를 이용합니다!

libpq를 사용하는 클라이언트 프로그램에서는 반드시 libpq-fe.h 헤더 파일을 포함해주어야 사용이 가능합니다.

</aside>

libpq 버전 및 PostgreSQL 서버 버전 확인

libpq는 구 버전의 PostgreSQL의 호환성도 고려해 만들어지기 때문에, libpq의 버전이 PostgreSQL 서버 버전보다 높아도 상관 없지만, 반대로 낮을 경우 필요한 기능이 구현되지 않았을 수 있으므로 확인이 필요합니다.

libpq 버전 확인

libpq 버전은 PQlibVersion(void) 함수를 이용하여 확인할 수 있습니다.

int PQlibVersion(void)

The result of this function can be used to determine, at run time, whether specific functionality is available in the currently loaded version of libpq. The function can be used, for example, to determine which connection options are available in [PQconnectdb](<https://www.postgresql.org/docs/14/libpq-connect.html#LIBPQ-PQCONNECTDB>).

The result is formed by multiplying the library’s major version number by 10000 and adding the minor version number. For example, version 10.1 will be returned as 100001, and version 11.0 will be returned as 110000.

Prior to major version 10, PostgreSQL used three-part version numbers in which the first two parts together represented the major version. For those versions, [PQlibVersion](<https://www.postgresql.org/docs/14/libpq-misc.html#LIBPQ-PQLIBVERSION>) uses two digits for each part; for example version 9.1.5 will be returned as 90105, and version 9.2.0 will be returned as 90200.

Therefore, for purposes of determining feature compatibility, applications should divide the result of [PQlibVersion](<https://www.postgresql.org/docs/14/libpq-misc.html#LIBPQ-PQLIBVERSION>) by 100 not 10000 to determine a logical major version number. In all release series, only the last two digits differ between minor releases (bug-fix releases).

아래와 같은 샘플 코드를 이용하여 확인할 수 있습니다.

#include <stdio.h>
#include <stdlib.h>
#include “libpq-fe.h”

int main(int argc, char **argv)
{
printf(“%d”, PQlibVersion());
return 0;
}

데이터베이스 서버 버전 확인

데이터베이스 서버 버전은 아래와 같은 방법들로 확인할 수 있습니다.’

1. 데이터베이스 서버에서 직접 확인하는 방법

[root@localhost:~]# ps -ef | grep postgres
opensql 19228 1 0 Mar19 ? 00:00:03 /usr/pgsql-14/bin/postgres
opensql 19229 19228 0 Mar19 ? 00:00:00 postgres: logger
opensql 19231 19228 0 Mar19 ? 00:00:00 postgres: checkpointer
opensql 19232 19228 0 Mar19 ? 00:00:05 postgres: background writer
opensql 19233 19228 0 Mar19 ? 00:00:05 postgres: walwriter
opensql 19234 19228 0 Mar19 ? 00:00:02 postgres: autovacuum launcher
opensql 19235 19228 0 Mar19 ? 00:00:00 postgres: archiver
opensql 19236 19228 0 Mar19 ? 00:00:03 postgres: stats collector
opensql 19237 19228 0 Mar19 ? 00:00:00 postgres: logical replication launcher
root 32041 115451 0 21:26 pts/1 00:00:00 grep –color=auto postgres

현재 기동중인 PostgreSQL 프로세스를 확인합니다.
/usr/pgsql-14/bin/postgres 서버 프로그램을 사용중인 것을 확인할 수 있습니다.
–version 옵션을 이용하여 메이저 버전과 마이너 버전을 확인할 수 있습니다.

[root@localhost:~]# /usr/pgsql-14/bin/postgres –version
postgres (PostgreSQL) 14.2

더욱 자세한 빌드 옵션을 확인하고 싶다면 아래의 유틸리티를 이용할 수 있습니다.

[root@localhost:~]# /usr/pgsql-14/bin/pg_config
BINDIR = /usr/pgsql-14/bin
DOCDIR = /usr/pgsql-14/doc
HTMLDIR = /usr/pgsql-14/doc/html
INCLUDEDIR = /usr/pgsql-14/include
PKGINCLUDEDIR = /usr/pgsql-14/include
INCLUDEDIR-SERVER = /usr/pgsql-14/include/server
LIBDIR = /usr/pgsql-14/lib
PKGLIBDIR = /usr/pgsql-14/lib
LOCALEDIR = /usr/pgsql-14/share/locale
MANDIR = /usr/pgsql-14/share/man
SHAREDIR = /usr/pgsql-14/share
SYSCONFDIR = /etc/sysconfig/pgsql
PGXS = /usr/pgsql-14/lib/pgxs/src/makefiles/pgxs.mk
CONFIGURE = ‘–enable-rpath’ ‘–prefix=/usr/pgsql-14’ ‘–includedir=/usr/pgsql-14/include’ ‘–mandir=/usr/pgsql-14/share/man’ ‘–datadir=/usr/pgsql-14/share’ ‘–libdir=/usr/pgsql-14/lib’ ‘–with-lz4’ ‘–with-icu’ ‘–with-llvm’ ‘–with-perl’ ‘–with-python’ ‘–with-tcl’ ‘–with-tclconfig=/usr/lib64’ ‘–with-openssl’ ‘–with-pam’ ‘–with-gssapi’ ‘–with-includes=/usr/include’ ‘–with-libraries=/usr/lib64’ ‘–enable-nls’ ‘–enable-dtrace’ ‘–with-uuid=e2fs’ ‘–with-libxml’ ‘–with-libxslt’ ‘–with-ldap’ ‘–with-selinux’ ‘–with-systemd’ ‘–with-system-tzdata=/usr/share/zoneinfo’ ‘–sysconfdir=/etc/sysconfig/pgsql’ ‘–docdir=/usr/pgsql-14/doc’ ‘–htmldir=/usr/pgsql-14/doc/html’ ‘CFLAGS=-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong –param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic’ ‘LLVM_CONFIG=/usr/lib64/llvm5.0/bin/llvm-config’ ‘CLANG=/opt/rh/llvm-toolset-7/root/usr/bin/clang’ ‘PKG_CONFIG_PATH=:/usr/lib64/pkgconfig:/usr/share/pkgconfig’ ‘PYTHON=/usr/bin/python3’
CC = gcc -std=gnu99
CPPFLAGS = -D_GNU_SOURCE -I/usr/include/libxml2 -I/usr/include
CFLAGS = -Wall -Wmissing-prototypes -Wpointer-arith -Wdeclaration-after-statement -Werror=vla -Wendif-labels -Wmissing-format-attribute -Wformat-security -fno-strict-aliasing -fwrapv -fexcess-precision=standard -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong –param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic
CFLAGS_SL = -fPIC
LDFLAGS = -L/usr/lib64/llvm5.0/lib -L/usr/lib64 -Wl,–as-needed -Wl,-rpath,’/usr/pgsql-14/lib’,–enable-new-dtags
LDFLAGS_EX =
LDFLAGS_SL =
LIBS = -lpgcommon -lpgport -lselinux -llz4 -lxslt -lxml2 -lpam -lssl -lcrypto -lgssapi_krb5 -lz -lreadline -lpthread -lrt -ldl -lm
VERSION = PostgreSQL 14.2

2. psql 또는 pgAdmin4와 같은 클라이언트 툴에서 Query를 이용하여 확인하는 방법

PostgreSQL은 Database Cluster 초기화 시에 version() 함수가 들어있습니다.
version() 함수를 이용하면 버전 정보를 조회할 수 있습니다.

[opensql@localhost:~]$ psql
psql (14.2)
Type “help” for help.

postgres=# SELECT version();

version
—————————————————————————————————————————————–

PostgreSQL 14.2 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-44), 64-bit
(1 row)

libpq 다운로드

PostgreSQL 패키지에 포함되어 빌드 됩니다.
PostgreSQL Community 버전 공식 다운로드 페이지를 이용하시면 됩니다.
https://www.postgresql.org/download/

Linux의 경우 OS에 맞게 PostgreSQL Repository에서 postgresql14 클라이언트를 설치하여 개발에 사용할 수 있습니다.

[root@two ~]# yum list libpq5 –showduplicates Loaded plugins: fastestmirror, langpacks, remove-with-leaves Loading mirror speeds from cached hostfile

• base: mirror.kakao.com
• centos-sclo-rh: mirror.kakao.com
• epel: ftp.riken.jp
• extras: mirror.kakao.com
• updates: mirror.kakao.com Available Packages libpq5.x86_64 15.1-42PGDG.rhel7 pgdg-common libpq5.x86_64 15.2-42.1PGDG.rhel7 pgdg-common

libpq 사용방법

libpq를 사용하는 클라이언트 프로그램에서는 반드시 libpq-fe.h 헤더 파일을 포함해주어야 사용이 가능합니다!!
아래의 실습 과정을 통해서 사용 방법을 알아 보도록 하겠습니다.

실습 환경

OS	CentOS 7.9
PostgreSQL Server	14.2
C Compiler	gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-44)

실습

1. 실습 환경에 필요한 C Compiler 및 PostgreSQL Development Package를 설치합니다.

yum 패키지 매니저 사용을 위해 root 계정을 사용 하겠습니다.
실습에서는 gcc Compiler를 사용하도록 하겠습니다.

2. 설치된 패키지를 확인합니다.
gcc 버전 확인

[root@localhost ~]# gcc –version
gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-44)
Copyright (C) 2015 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

postgresql14 확인
# 컴파일에 필요한 include 디렉토리와 실행에 필요한 lib 디렉토리를 확인할 수 있습니다.

[root@localhost ~]# /usr/pgsql-14/bin/pg_config
BINDIR = /usr/pgsql-14/bin
DOCDIR = /usr/pgsql-14/doc
HTMLDIR = /usr/pgsql-14/doc/html
INCLUDEDIR = /usr/pgsql-14/include
PKGINCLUDEDIR = /usr/pgsql-14/include
INCLUDEDIR-SERVER = /usr/pgsql-14/include/server
LIBDIR = /usr/pgsql-14/lib
PKGLIBDIR = /usr/pgsql-14/lib
LOCALEDIR = /usr/pgsql-14/share/locale
MANDIR = /usr/pgsql-14/share/man
SHAREDIR = /usr/pgsql-14/share
SYSCONFDIR = /etc/sysconfig/pgsql
PGXS = /usr/pgsql-14/lib/pgxs/src/makefiles/pgxs.mk
CONFIGURE = ‘–enable-rpath’ ‘–prefix=/usr/pgsql-14’ ‘–includedir=/usr/pgsql-14/include’ ‘–mandir=/usr/pgsql-14/share/man’ ‘–datadir=/usr/pgsql-14/share’ ‘–libdir=/usr/pgsql-14/lib’ ‘–with-lz4’ ‘–with-icu’ ‘–with-llvm’ ‘–with-perl’ ‘–with-python’ ‘–with-tcl’ ‘–with-tclconfig=/usr/lib64’ ‘–with-openssl’ ‘–with-pam’ ‘–with-gssapi’ ‘–with-includes=/usr/include’ ‘–with-libraries=/usr/lib64’ ‘–enable-nls’ ‘–enable-dtrace’ ‘–with-uuid=e2fs’ ‘–with-libxml’ ‘–with-libxslt’ ‘–with-ldap’ ‘–with-selinux’ ‘–with-systemd’ ‘–with-system-tzdata=/usr/share/zoneinfo’ ‘–sysconfdir=/etc/sysconfig/pgsql’ ‘–docdir=/usr/pgsql-14/doc’ ‘–htmldir=/usr/pgsql-14/doc/html’ ‘CFLAGS=-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong –param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic’ ‘LLVM_CONFIG=/usr/lib64/llvm5.0/bin/llvm-config’ ‘CLANG=/opt/rh/llvm-toolset-7/root/usr/bin/clang’ ‘PKG_CONFIG_PATH=:/usr/lib64/pkgconfig:/usr/share/pkgconfig’ ‘PYTHON=/usr/bin/python3’
CC = gcc -std=gnu99
CPPFLAGS = -D_GNU_SOURCE -I/usr/include/libxml2 -I/usr/include
CFLAGS = -Wall -Wmissing-prototypes -Wpointer-arith -Wdeclaration-after-statement -Werror=vla -Wendif-labels -Wmissing-format-attribute -Wformat-security -fno-strict-aliasing -fwrapv -fexcess-precision=standard -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong –param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic
CFLAGS_SL = -fPIC
LDFLAGS = -L/usr/lib64/llvm5.0/lib -L/usr/lib64 -Wl,–as-needed -Wl,-rpath,’/usr/pgsql-14/lib’,–enable-new-dtags
LDFLAGS_EX =
LDFLAGS_SL =
LIBS = -lpgcommon -lpgport -lselinux -llz4 -lxslt -lxml2 -lpam -lssl -lcrypto -lgssapi_krb5 -lz -lreadline -lpthread -lrt -ldl -lm
VERSION = PostgreSQL 14.2

[root@localhost ~]# ls -lah /usr/pgsql-14
total 12K
drwxr-xr-x. 6 root root 56 Mar 21 22:23 .
drwxr-xr-x. 14 root root 171 Mar 21 22:11 ..
drwxr-xr-x. 2 root root 4.0K Mar 21 22:23 bin
drwxr-xr-x. 6 root root 4.0K Mar 21 22:24 include
drwxr-xr-x. 5 root root 4.0K Mar 21 22:24 lib
drwxr-xr-x. 6 root root 122 Mar 21 22:23 share

3. 테스트를 위한 샘플 코드를 작성합니다.
아래는 PostgreSQL 소스 코드에 포함되어 있는 샘플 코드입니다.

pg_catalog 스키마의 pg_database 테이블을 조회합니다.

/*

*src/test/examples/testlibpq.c
*
*
* testlibpq.c
*
* Test the C version of libpq, the PostgreSQL frontend library.
*/
#include <stdio.h>
#include <stdlib.h>
#include “libpq-fe.h”

static void
exit_nicely(PGconn *conn)
{
PQfinish(conn);
exit(1);
}

int
main(int argc, char **argv)
{
const char *conninfo;
PGconn *conn;
PGresult *res;
int nFields;
int i, j;

/*
* If the user supplies a parameter on the command line, use it as the
* conninfo string; otherwise default to setting dbname=postgres and using
* environment variables or defaults for all other connection parameters.
*/
if (argc > 1)
conninfo = argv[1];

else
conninfo = “dbname = postgres”;

/* Make a connection to the database */
conn = PQconnectdb(conninfo);

/* Check to see that the backend connection was successfully made */
if (PQstatus(conn) != CONNECTION_OK)
{
fprintf(stderr, “%s”, PQerrorMessage(conn)); exit_nicely(conn);
}

/* Set always-secure search path, so malicious users can’t take control. */
res = PQexec(conn, “SELECT pg_catalog.set_config(‘search_path’, ”, false)”);
if (PQresultStatus(res) != PGRES_TUPLES_OK)
{
fprintf(stderr, “SET failed: %s”, PQerrorMessage(conn));
PQclear(res);
exit_nicely(conn);
}

/*
* Should PQclear PGresult whenever it is no longer needed to avoid memory
* leaks
*/
PQclear(res);

/*
* Our test case here involves using a cursor, for which we must be inside
* a transaction block. We could do the whole thing with a single
* PQexec() of “select * from pg_database”, but that’s too trivial to make
* a good example.
*/

/* Start a transaction block */
res = PQexec(conn, “BEGIN”);
if (PQresultStatus(res) != PGRES_COMMAND_OK)
{
fprintf(stderr, “BEGIN command failed: %s”, PQerrorMessage(conn));
PQclear(res);
exit_nicely(conn);
}
PQclear(res);


/*
* Fetch rows from pg_database, the system catalog of databases
*/
res = PQexec(conn, “DECLARE myportal CURSOR FOR select * from pg_database”);
if (PQresultStatus(res) != PGRES_COMMAND_OK)
{
fprintf(stderr, “DECLARE CURSOR failed: %s”, PQerrorMessage(conn));
PQclear(res);
exit_nicely(conn);
}
PQclear(res);

res = PQexec(conn, “FETCH ALL in myportal”);
if (PQresultStatus(res) != PGRES_TUPLES_OK)
{
fprintf(stderr, “FETCH ALL failed: %s”, PQerrorMessage(conn));
PQclear(res);
exit_nicely(conn);
}
/* first, print out the attribute names */
nFields = PQnfields(res);
for (i = 0; i < nFields; i++)
printf(“%-15s”, PQfname(res, i));
printf(“nn”);

/* next, print out the rows */
for (i = 0; i < PQntuples(res); i++)
{
for (j = 0; j < nFields; j++)
printf(“%-15s”, PQgetvalue(res, i, j));
printf(“n”);
}

PQclear(res);

/* close the portal … we don’t bother to check for errors … */
res = PQexec(conn, “CLOSE myportal”);
PQclear(res);

/* end the transaction */
res = PQexec(conn, “END”);
PQclear(res);

/* close the connection to the database and cleanup */
PQfinish(conn);

return 0;

}

4. 소스 코드를 컴파일 합니다.
gcc를 이용하여 testlibpq.c를 컴파일 하도록 하겠습니다.
gcc -I/usr/pgsql-14/include -I/usr/pgsql-14/include/internal -L/usr/pgsql-14/lib -lpq -o testlibpq testlibpq.c

[root@localhost:~]# gcc -I/usr/pgsql-14/include -I/usr/pgsql-14/include/internal -L/usr/pgsql-14/lib -lpq -o testlibpq testlibpq.c -v
Using built-in specs.
COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/lto-wrapper
Target: x86_64-redhat-linux
Configured with: ../configure –prefix=/usr –mandir=/usr/share/man –infodir=/usr/share/info –with-bugurl=http://bugzilla.redhat.com/bugzilla –enable-bootstrap –enable-shared –enable-threads=posix –enable-checking=release –with-system-zlib –enable-__cxa_atexit –disable-libunwind-exceptions –enable-gnu-unique-object –enable-linker-build-id –with-linker-hash-style=gnu –enable-languages=c,c++,objc,obj-c++,java,fortran,ada,go,lto –enable-plugin –enable-initfini-array –disable-libgcj –with-isl=/builddir/build/BUILD/gcc-4.8.5-20150702/obj-x86_64-redhat-linux/isl-install –with-cloog=/builddir/build/BUILD/gcc-4.8.5-20150702/obj-x86_64-redhat-linux/cloog-install –enable-gnu-indirect-function –with-tune=generic –with-arch_32=x86-64 –build=x86_64-redhat-linux
Thread model: posix
gcc version 4.8.5 20150623 (Red Hat 4.8.5-44) (GCC)
COLLECT_GCC_OPTIONS=’-I’ ‘/usr/pgsql-14/include’ ‘-I’ ‘/usr/pgsql-14/include/internal’ ‘-L/usr/pgsql-14/lib’ ‘-o’ ‘testlibpq’ ‘-v’ ‘-mtune=generic’ ‘-march=x86-64’
/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/cc1 -quiet -v -I /usr/pgsql-14/include -I /usr/pgsql-14/include/internal testlibpq.c -quiet -dumpbase testlibpq.c -mtune=generic -march=x86-64 -auxbase testlibpq -version -o /tmp/cc4zSGwE.s
GNU C (GCC) version 4.8.5 20150623 (Red Hat 4.8.5-44) (x86_64-redhat-linux)
compiled by GNU C version 4.8.5 20150623 (Red Hat 4.8.5-44), GMP version 6.0.0, MPFR version 3.1.1, MPC version 1.0.1
GGC heuristics: –param ggc-min-expand=96 –param ggc-min-heapsize=124459
ignoring nonexistent directory “/usr/lib/gcc/x86_64-redhat-linux/4.8.5/include-fixed”
ignoring nonexistent directory “/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../x86_64-redhat-linux/include”

#include “…” search starts here:
#include <…> search starts here:
/usr/pgsql-14/include
/usr/pgsql-14/include/internal
/usr/lib/gcc/x86_64-redhat-linux/4.8.5/include
/usr/local/include
/usr/include
End of search list.
GNU C (GCC) version 4.8.5 20150623 (Red Hat 4.8.5-44) (x86_64-redhat-linux)
compiled by GNU C version 4.8.5 20150623 (Red Hat 4.8.5-44), GMP version 6.0.0, MPFR version 3.1.1, MPC version 1.0.1
GGC heuristics: –param ggc-min-expand=96 –param ggc-min-heapsize=124459
Compiler executable checksum: 231b3394950636dbfe0428e88716bc73
COLLECT_GCC_OPTIONS=’-I’ ‘/usr/pgsql-14/include’ ‘-I’ ‘/usr/pgsql-14/include/internal’ ‘-L/usr/pgsql-14/lib’ ‘-o’ ‘testlibpq’ ‘-v’ ‘-mtune=generic’ ‘-march=x86-64’
as -v -I /usr/pgsql-14/include -I /usr/pgsql-14/include/internal –64 -o /tmp/ccZKJRM4.o /tmp/cc4zSGwE.s
GNU assembler version 2.27 (x86_64-redhat-linux) using BFD version version 2.27-44.base.el7
COMPILER_PATH=/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/:/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/:/usr/libexec/gcc/x86_64-redhat-linux/:/usr/lib/gcc/x86_64-redhat-linux/4.8.5/:/usr/lib/gcc/x86_64-redhat-linux/
LIBRARY_PATH=/usr/lib/gcc/x86_64-redhat-linux/4.8.5/:/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../lib64/:/lib/../lib64/:/usr/lib/../lib64/:/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../:/lib/:/usr/lib/
COLLECT_GCC_OPTIONS=’-I’ ‘/usr/pgsql-14/include’ ‘-I’ ‘/usr/pgsql-14/include/internal’ ‘-L/usr/pgsql-14/lib’ ‘-o’ ‘testlibpq’ ‘-v’ ‘-mtune=generic’ ‘-march=x86-64’
/usr/libexec/gcc/x86_64-redhat-linux/4.8.5/collect2 –build-id –no-add-needed –eh-frame-hdr –hash-style=gnu -m elf_x86_64 -dynamic-linker /lib64/ld-linux-x86-64.so.2 -o testlibpq /usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../lib64/crt1.o /usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../lib64/crti.o /usr/lib/gcc/x86_64-redhat-linux/4.8.5/crtbegin.o -L/usr/pgsql-14/lib -L/usr/lib/gcc/x86_64-redhat-linux/4.8.5 -L/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../lib64 -L/lib/../lib64 -L/usr/lib/../lib64 -L/usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../.. -lpq /tmp/ccZKJRM4.o -lgcc –as-needed -lgcc_s –no-as-needed -lc -lgcc –as-needed -lgcc_s –no-as-needed /usr/lib/gcc/x86_64-redhat-linux/4.8.5/crtend.o /usr/lib/gcc/x86_64-redhat-linux/4.8.5/../../../../lib64/crtn.o

5. 실행 및 결과 확인

testlibpq를 실행하여 데이터베이스 접속을 확인해보도록 하겠습니다.
아래와 같이 pg_database 카탈로그 정보가 출력됩니다.

[root@localhost:~]# ./testlibpq
oid datname datdba encoding datcollate datctype datistemplate datallowconn datconnlimit datlastsysoid datfrozenxid datminmxid dattablespace datacl

14486 postgres 10 6 en_US.UTF-8 en_US.UTF-8 f t -1 14485 726 1 1663
1 template1 10 6 en_US.UTF-8 en_US.UTF-8 t t -1 14485 726 1 1663 {=c/postgres,postgres=CTc/postgres}
14485 template0 10 6 en_US.UTF-8 en_US.UTF-8 t f -1 14485 726 1 1663 {=c/postgres,postgres=CTc/postgres}

오류가 발생 한다면?

connection to server on socket “/var/run/postgresql/.s.PGSQL.5432” failed: No such file or directory
Is the server running locally and accepting connections on that socket?
오류가 발생해요!

답변 내용 : 왼쪽의 토글 스위치(▶)를 눌러서 확인 해주세요.
Unix Domain Socket을 통해 PostgreSQL에 접속을 시도 했으나 Unix Domain Socket 파일을 찾지 못해서 발생하는 오류입니다!
이 오류가 발생하는 여러 가지 원인을 설명 드리겠습니다.

1. 데이터베이스 서버가 localhost가 아닌 다른 서버에 존재할 경우! ******실습 환경을 기준으로 설명을 드리자면, 실행 파일이 데이터베이스 서버에 있기 때문에 testlibpq 실행 시 파라미터를 주지 않고 실행하게 되면 같은 서버에 있는 5432 포트를 사용하는 Unix domain Socket인 /var/run/postgresql/.s.PGSQL.5432에 연결을 시도하게 됩니다. 따라서, 데이터베이스 서버가 다른 서버에 존재한다면 아래와 같이 연결 파라미터를 사용하시기 바랍니다. ./testlibpq 'host=192.168.1.11 user=postgres dbname=postgres port=5432’ 실습 환경을 기준으로 설명을 드리자면, 실행 파일이 데이터베이스 서버에 있기 때문에 파라미터를 주지 않고 실행하게 되면 같은 서버에 있는 5432 포트를 사용하는 Unix domain Socket인 /var/run/postgresql/.s.PGSQL.5432에 연결을 시도하게 됩니다.
2. 데이터베이스 서버가 기동중이지 않을 경우! 데이터베이스 서버가 기동중이지 않을 경우 Unix Domain Socket 파일이 생성되지 않습니다. 데이터베이스 기동 상태를 확인 해주시기 바랍니다.
3. 데이터베이스 서버의 Unix Domain Socket 위치 설정이 다를 경우! 데이터베이스 서버는 정상적으로 실행중인 것을 확인 했는데 접속이 불가능 할 경우가 있습니다. 이 경우에는 Unix Domain Socket의 위치를 확인 해주시면 됩니다. Unix Domain Socket은 PostgreSQL 클러스터의 Data 디렉토리 안에 있는 postgresql.conf 파일 또는 postgresql.auto.conf에 설정되어 있습니다. 아래의 파라미터를 확인 해주세요. unix_socket_directories = '/var/run/postgresql, /tmp’

실습 환경을 기준으로 설명을 드리자면, 실행 파일이 데이터베이스 서버에 있기 때문에 파라미터를 주지 않고 실행하게 되면 같은 서버에 있는 5432 포트를 사용하는 Unix domain Socket인 /var/run/postgresql/.s.PGSQL.5432에 연결을 시도하게 됩니다.

FATAL: no pg_hba.conf entry for host “192.168.123.123”, user “postgres”, database “postgres”, no encryption
오류가 발생해요!

답변 내용 : 왼쪽의 토글 스위치(▶)를 눌러서 확인 해주세요.

PostgreSQL의 pg_hba.conf에 연결 허용 설정이 되어있지 않아서 그렇습니다! pg_hba.conf에 접속 정보를 추가 해주세요! 아래는 TCP 연결을 통해 192.168.123.123 호스트로 부터 온 연결 요청에 대해서 모든 데이터베이스 및 모든 유저로 접속이 가능하고 패스워드는 입력하지 않아도 접속이 가능 하도록 설정하는 예시 입니다.

# TYPE DATABASE USER ADDRESS METHOD
host all all 192.168.123.123/32 trust

libpq에 대한 더욱 자세한 내용은 아래의 공식 매뉴얼을 참고 해주시기 바랍니다!

https://www.postgresql.org/docs/14/libpq.html

지금까지 ‘PostgreSQL의 (Interface) C lang – libpq’에 관해 알아보았습니다

‘PostgreSQL의 (Interface) JDBC’를 바로 이어서 확인해보세요!