파이썬 - 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 환경 변수를 이용해 연결하면 됩니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]