Microsoft MVP성태의 닷넷 이야기
스크립트: 55. 파이썬 - pyodbc를 이용한 SQL Server 연결 사용법 [링크 복사], [링크+제목 복사],
조회: 13505
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)

파이썬 - pyodbc를 이용한 SQL Server 연결 사용법

PEP 249 문서에서는 paramstyle을 5가지 정의하고 있는데요, 전에 설명했던 대로 psycopg2MySQLdb는 pyformat, format 2가지 방식만 지원을 합니다.

하지만 이번 글에서 소개하는 pyodbc는 특이하게 qmark 방식만을 구현하는데요, ^^ 간단하게 우선 윈도우 환경에서 실습을 해보겠습니다.

우선 pyodbc를 설치하고,

// Microsoft 문서
// ; https://learn.microsoft.com/en-us/sql/connect/python/pyodbc/python-sql-driver-pyodbc

// ODBC Driver 18.0 for SQL Server Released
// ; https://techcommunity.microsoft.com/t5/sql-server-blog/odbc-driver-18-0-for-sql-server-released/ba-p/3169228

// pyodbc: https://pypi.org/project/pyodbc/
c:\temp> python -m pip install pyodbc

예제 코드를 작성해 실행하면 끝입니다. ODBC니까 다양하게 접속할 수 있지만 여기서는 (pymssql로도 가능한) Microsoft SQL Server로의 예제를 작성해 보겠습니다.

import pyodbc

connection_string = "Driver={SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw;"

conn = pyodbc.connect(connection_string)
cursor = conn.cursor()

cursor.execute("SELECT * FROM mytable WHERE age > ?", 1)
row = cursor.fetchone() 
while row: 
    print(row)
    row = cursor.fetchone()

conn.close()

보는 바와 같이 "qmark" 형식의 쿼리를 실행했고, "?"에 대응하는 인자를 execute 함수에 함께 전달하면 됩니다.




참고로, 리눅스의 경우 단순히 "pip install pyodbc" 설치만 하면 사용 시 이런 오류가 발생합니다.

"libodbc.so.2: cannot open shared object file: No such file or directory" 

문서에도 자세하게 나오지만 unixodbc 설치하면 됩니다. ^^

// WSL + Ubuntu 20.04

$ sudo apt install unixodbc

또한, 이 글의 예제로 든 Microsoft SQL 서버로 연결하는 코드를 실행하면 한 번 더 에러가 발생하는데요,

$ python3 test.py
Traceback (most recent call last):
  File "test.py", line 9, in <module>
    conn = pyodbc.connect(connection_string)
pyodbc.Error: ('01000', "[01000] [unixODBC][Driver Manager]Can't open lib 'SQL Server' : file not found (0) (SQLDriverConnect)")

오류 원인은, 연결 문자열인 "Driver={SQL Server};...[생략]...;"에 지정한 "SQL Server" 드라이버가 "DATA SOURCES"에 등록이 안 돼 있기 때문입니다.

$ odbcinst -j
unixODBC 2.3.11
DRIVERS............: /etc/odbcinst.ini
SYSTEM DATA SOURCES: /etc/odbc.ini
FILE DATA SOURCES..: /etc/ODBCDataSources
USER DATA SOURCES..: /home/testusr/.odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8

$ cat /etc/odbcinst.ini
$ cat /etc/odbc.ini
$ ls -l /etc/ODBCDataSources
total 0
$ cat /home/testusr/.odbc.ini
cat: /home/testusr/.odbc.ini: No such file or directory

따라서 "Microsoft ODBC driver for SQL Server"를 설치해야 하는데요, 공식 문서에서 자세하게 설명하고 있습니다. ^^

Install the Microsoft ODBC driver for SQL Server (Linux)
; https://learn.microsoft.com/en-us/sql/connect/odbc/linux-mac/installing-the-microsoft-odbc-driver-for-sql-server

문서상으로는 비록 "Microsoft ODBC 18"의 경우 우분투에서 18.04 ~ 23.04 버전은 지원이 안 된다고 나오지만,

if ! [[ "18.04 20.04 22.04 23.04" == *"$(lsb_release -rs)"* ]];
then
    echo "Ubuntu $(lsb_release -rs) is not currently supported.";
    exit;
fi

현재는 해당 버전의 패키지가 존재하기 때문에 저 라인을 건너 뛰고 실행하시면 됩니다.

$ cat mssql_driver.sh
wget https://packages.microsoft.com/keys/microsoft.asc | sudo tee /etc/apt/trusted.gpg.d/microsoft.asc

curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list > /etc/apt/sources.list.d/mssql-release.list

apt-get update
ACCEPT_EULA=Y apt-get install -y msodbcsql18
# optional: for bcp and sqlcmd
ACCEPT_EULA=Y apt-get install -y mssql-tools18
echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
source ~/.bashrc
# optional: for unixODBC development headers
sudo apt-get install -y unixodbc-dev

$ sudo ./mssql_driver.sh

이후 "Microsoft ODBC Driver 18 for SQL Server" 이름을 가진 driver가 설치된 것을 확인할 수 있고,

$ cat /etc/odbcinst.ini
[ODBC Driver 18 for SQL Server]
Description=Microsoft ODBC Driver 18 for SQL Server
Driver=/opt/microsoft/msodbcsql18/lib64/libmsodbcsql-18.3.so.1.1
UsageCount=1

윈도우에서 실행했던 소스코드에서 연결 문자열의 Driver만 바꿔준 후,

# connection_string = "Driver={SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw;"
connection_string = "Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw;"

실행하면 이제 다음과 같은 오류가 나옵니다. ^^;

$ python3 test.py
Traceback (most recent call last):
  File "test.py", line 10, in <module>
    conn = pyodbc.connect(connection_string)
pyodbc.OperationalError: ('08001', '[08001] [Microsoft][ODBC Driver 18 for SQL Server]SSL Provider: [error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed:self signed certificate] (-1) (SQLDriverConnect)')

예의 그 인증서 오류입니다. ^^ 그런데 이상하군요, 연결 문자열에서 TrustServerCertificate 또는 Encrypt 옵션을 추가하면,

connection_string = "TrustServerCertificate=true;Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw"

# 또는,

connection_string = "Encrypt=true;Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw"

실행 시 해당 옵션들이 지원이 안 되는 듯한 오류가 나옵니다.

$ python3 test.py
Traceback (most recent call last):
  File "test.py", line 10, in <module>
    conn = pyodbc.connect(connection_string)
pyodbc.OperationalError: ('08001', "[08001] [Microsoft][ODBC Driver 18 for SQL Server]Invalid value specified for connection string attribute 'TrustServerCertificate' (0) (SQLDriverConnect)")

$ python3 test.py
Traceback (most recent call last):
  File "test.py", line 10, in <module>
    conn = pyodbc.connect(connection_string)
pyodbc.OperationalError: ('08001', "[08001] [Microsoft][ODBC Driver 18 for SQL Server]Invalid value specified for connection string attribute 'Encrypt' (0) (SQLDriverConnect)")

왜냐하면 윈도우 환경의 연결 문자열과는 달리 "True/False"가 아닌 pyodbc가 정한 "Yes/No"로 값을 설정해야 하기 때문입니다. ^^;

// PYODBC + MS SQL SERVER connection with Encrypt=yes not connecting
// ; https://stackoverflow.com/questions/62390326/pyodbc-ms-sql-server-connection-with-encrypt-yes-not-connecting

connection_string = "TrustServerCertificate=Yes;Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw"

# 또는,

connection_string = "Encrypt=No;Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw"

정리하면, 리눅스 환경의 경우 다음과 같은 예제 코드로 테스트하시면 됩니다.

import pyodbc

connection_string = "Driver={ODBC Driver 18 for SQL Server};Server=10.10.10.5;Database=TestDB;Uid=sa;Pwd=testpw;TrustServerCertificate=Yes"

conn = pyodbc.connect(connection_string)
cursor = conn.cursor()

cursor.execute("SELECT * FROM mytable WHERE age > ?", 1)
row = cursor.fetchone() 
while row: 
    print(row)
    row = cursor.fetchone()

conn.close()




참고로, 이러한 5가지 유형의 parameterized query를 변환해 주는 패키지가 있습니다.

SQL Params
; https://python-sql-parameters.readthedocs.io/en/latest/sqlparams.html




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

[연관 글]






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

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 166  167  168  169  170  171  172  173  174  [175]  176  177  178  179  180  ...
NoWriterDateCnt.TitleFile(s)
627정성태12/6/200823301VS.NET IDE: 58. VS.NET IDE 팁 - 커서 위치 이동 [1]
626정성태12/6/200823528오류 유형: 65. TF53018: The application tier XXXXXXX is attempting to connect to a data tier with an incompatible version
625정성태12/6/200823679오류 유형: 64. TFS 2008 SP1 설치 - MsiApplyMultiplePatches returned 0x643
624정성태12/5/200824689.NET Framework: 114. WPF 이벤트에 속한 핸들러 확인 [2]파일 다운로드1
623정성태12/4/200829039디버깅 기술: 22. VS.NET SP1 + .NET Framework 소스 코드 디버깅 [2]파일 다운로드1
622정성태12/1/200831276오류 유형: 63. WPF - XamlParseException 대응 방법 [2]
621정성태11/30/200823444Team Foundation Server: 27. TeamBuild + VDPROJ 셋업 프로젝트 [1]
620정성태11/30/200822318디버깅 기술: 21. 올바른 이벤트 예외 정보 출력
619정성태11/30/200822417디버깅 기술: 20. 예외 처리를 방해하는 WPF Modal 대화창파일 다운로드1
618정성태11/29/200822886.NET Framework: 113. 이벤트에 속한 이벤트 핸들러 확인파일 다운로드1
617정성태11/26/200828413.NET Framework: 112. How to Interop DISPPARAMS [2]파일 다운로드2
616정성태11/26/200822185디버깅 기술: 19. C++/CLI - F11 디버깅 시의 변수 초기화파일 다운로드1
615정성태11/9/200831898.NET Framework: 111. WPF - Window, UserControl 클래스 상속 [1]
614정성태11/9/200831855.NET Framework: 110. WPF - 전역 예외 처리 [4]파일 다운로드1
613정성태11/8/200821453.NET Framework: 109. WPF - SystemColors 색상표파일 다운로드1
612정성태11/1/200826717.NET Framework: 108. WPF + WCF 환경에서는 DataContract를 권장 [1]
611정성태10/31/200821065오류 유형: 62. WPF - Visual Studio 2008 비정상 종료
610정성태10/24/200823253Team Foundation Server: 26. TFS 2008 SP1 + SQL Server 2008 설치
609정성태10/24/200826985.NET Framework: 107. WPF - RadioButton 데이터 바인딩 해제 현상파일 다운로드2
608정성태10/23/200821696오류 유형: 61. TFS 연결 오류: TF31003, TF30331 오류
607정성태10/18/200819608Windows: 32. 자동 실행 경로에 ".." 가 포함된 경우
606정성태10/18/200821603.NET Framework: 106. WCF - 다중 서비스 호스트파일 다운로드1
605정성태10/18/200825048.NET Framework: 105. WPF - 닫기 버튼을 없애려면.
604정성태10/18/200825611오류 유형: 60. System.Management.ManagementException - Generic failure [1]
602정성태10/15/200827554오류 유형: 59. WPF - XAML 로딩 시 Visual Studio 비정상 종료 [1]
600정성태10/9/200832221디버깅 기술: 18. TFS Team Build + Source Server = 소스 코드 디버깅 [3]
... 166  167  168  169  170  171  172  173  174  [175]  176  177  178  179  180  ...