파이썬 - PostgreSQL 환경 구성

파이썬에서 PostgreSQL 서버로 접속하려면 다음과 같이 libpq-dev와 psycopg2 구성 요소를 설치하면 됩니다.

$ sudo apt install libpq-dev

$ pip install psycopg2
// 또는,
$ pip install psycopg2-binary

이하 사용법은 역시 dbapi2 인터페이스를 따르므로 그에 따라 코딩을 하시면 됩니다.

그런데, 이번에는 parameterized query를 실습해봤는데요,

PEP 249 – Python Database API Specification v2.0
 - paramstyle
; https://peps.python.org/pep-0249/#paramstyle

재미있게도 이게 딱히 고정돼 있지 않고 5개의 방식으로 다양하게 지원할 수 있다는 점이 눈에 띕니다.

qmark   Question mark style, e.g. ...WHERE name=?
numeric Numeric, positional style, e.g. ...WHERE name=:1
named   Named style, e.g. ...WHERE name=:name
format  ANSI C printf format codes, e.g. ...WHERE name=%s
pyformat    Python extended format codes, e.g. ...WHERE name=%(name)s

그러니까, 해당 db provider 측에서 저 5개의 방법 중 골라서 지원하면 된다는 의미인 듯합니다. 실제로 테스트해보면 psycopg2의 경우 pyformat, format 방식만 지원하고,

def test_postgre_1(request):
    import psycopg2
    db = psycopg2.connect(host='...', dbname='...', user='...', password='...', port=5432)
    cursor = db.cursor()

    sql = "DELETE FROM TestTable WHERE Age=(%s)"
    cursor.execute(sql, (50,))
    db.commit()

    sql = "INSERT INTO TestTable(Name, Age) VALUES( %(P1)s, %(P2)s )"
    cursor.execute(sql, {'P1': 'test', 'P2': 50})
    db.commit()

그 외의 qmark, numeric, named 방식을 사용하면 이런 오류가 발생합니다.

# operator does not exist: integer =?
# LINE 1: DELETE FROM TestTable WHERE Age=?
# sql = "DELETE FROM TestTable WHERE Age=?"

# psycopg2.errors.SyntaxError: syntax error at or near ":"
# LINE 1: DELETE FROM TestTable WHERE Age=:1
# sql = "DELETE FROM TestTable WHERE Age=:1"

# psycopg2.errors.SyntaxError: syntax error at or near ":"
# LINE 1: DELETE FROM TestTable WHERE Age=:Age
# sql = "DELETE FROM TestTable WHERE Age=:Age"

따라서 dbapi2를 따르는 db 모듈이라고 해도 문서를 확인해 봐야 하는 것입니다. 가령, psycopg2의 경우 psycopg2.paramstyle 속성으로 알 수 있다고 하는데요,

psycopg2.paramstyle
; https://www.psycopg.org/docs/module.html#psycopg2.paramstyle

import psycopg2
print(psycopg2.paramstyle)  # 출력 결과: pyformat

위와 같이 pyformat을 출력하는데, 테스트한 결과에 따르면 분명히 "format" 방식도 지원하긴 합니다. 음... 왜 하나만 출력하는 것인지는 저도 잘 모르겠습니다. ^^;

---

만약 "pip install psycopg2" 실행 시 다음과 같은 오류가 발생한다면?

  ERROR: Command errored out with exit status 1:
     command: /usr/bin/python3 -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-install-ggfd50_u/psycopg2/setup.py'"'"'; __file__='"'"'/tmp/pip-install-ggfd50_u/psycopg2/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' egg_info --egg-base /tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info
         cwd: /tmp/pip-install-ggfd50_u/psycopg2/
    Complete output (23 lines):
    running egg_info
    creating /tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info/psycopg2.egg-info
    writing /tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info/psycopg2.egg-info/PKG-INFO
    writing dependency_links to /tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info/psycopg2.egg-info/dependency_links.txt
    writing top-level names to /tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info/psycopg2.egg-info/top_level.txt
    writing manifest file '/tmp/pip-install-ggfd50_u/psycopg2/pip-egg-info/psycopg2.egg-info/SOURCES.txt'

    Error: pg_config executable not found.

    pg_config is required to build psycopg2 from source.  Please add the directory
    containing pg_config to the $PATH or specify the full executable path with the
    option:

        python setup.py build_ext --pg-config /path/to/pg_config build ...

    or with the pg_config option in 'setup.cfg'.

    If you prefer to avoid building psycopg2 from source, please install the PyPI
    'psycopg2-binary' package instead.

    For further information please check the 'doc/src/install.rst' file (also at
    <https://www.psycopg.org/docs/install.html>).

    ----------------------------------------
ERROR: Command errored out with exit status 1: python setup.py egg_info Check the logs for full command output.

(우분투의 경우) "libpq-dev" 구성 요소를 설치하지 않았기 때문입니다. Windows 환경이라면 PostgreSQL 구성 요소가 필요한데,

Windows installers - Interactive installer by EDB
; https://www.postgresql.org/download/windows/
; https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

설치까지 할 필요는 없고 압축 해제 후,

c:\temp> postgresql-14.3-1-windows-x64.exe --extract-only yes

pg_config.exe가 있는 "C:\Program Files\PostgreSQL\14\bin\" 경로를 PATH 환경 변수를 이용해 연결하면 됩니다.

---

[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[최초 등록일: 6/15/2022]
[최종 수정일: 8/3/2023]


이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

by SeongTae Jeong, mailto:techsharer at outlook.com