Microsoft MVP성태의 닷넷 이야기
스크립트: 55. 파이썬 - pyodbc를 이용한 SQL Server 연결 사용법 [링크 복사], [링크+제목 복사],
조회: 5087
글쓴 사람
정성태 (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

비밀번호

댓글 작성자
 




1  2  3  4  5  6  7  8  9  [10]  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13419정성태9/25/20233795스크립트: 56. 파이썬 - RuntimeError: dictionary changed size during iteration
13418정성태9/25/20234802닷넷: 2146. C# - ConcurrentDictionary 자료 구조의 동기화 방식
13417정성태9/19/20234203닷넷: 2145. C# - 제네릭의 형식 매개변수에 속한 (매개변수를 가진) 생성자를 호출하는 방법
13416정성태9/19/20233840오류 유형: 877. redis-py - MISCONF Redis is configured to save RDB snapshots, ...
13415정성태9/18/20234356닷넷: 2144. C# 12 - 컬렉션 식(Collection Expressions)
13414정성태9/16/20234240디버깅 기술: 193. Windbg - ThreadStatic 필드 값을 조사하는 방법
13413정성태9/14/20234517닷넷: 2143. C# - 시스템 Time Zone 변경 시 이벤트 알림을 받는 방법
13412정성태9/14/20237741닷넷: 2142. C# 12 - 인라인 배열(Inline Arrays) [1]
13411정성태9/12/20234226Windows: 252. 권한 상승 전/후 따로 관리되는 공유 네트워크 드라이브 정보
13410정성태9/11/20235789닷넷: 2141. C# 12 - Interceptor (컴파일 시에 메서드 호출 재작성) [1]
13409정성태9/8/20234576닷넷: 2140. C# - Win32 API를 이용한 모니터 전원 끄기
13408정성태9/5/20234550Windows: 251. 임의로 만든 EXE 파일을 포함한 ZIP 파일의 압축을 해제할 때 Windows Defender에 의해 삭제되는 경우
13407정성태9/4/20234297닷넷: 2139. C# - ParallelEnumerable을 이용한 IEnumerable에 대한 병렬 처리
13406정성태9/4/20234313VS.NET IDE: 186. Visual Studio Community 버전의 라이선스
13405정성태9/3/20234730닷넷: 2138. C# - async 메서드 호출 원칙
13404정성태8/29/20234289오류 유형: 876. Windows - 키보드의 등호(=, Equals sign) 키가 눌리지 않는 경우
13403정성태8/21/20234394오류 유형: 875. The following signatures couldn't be verified because the public key is not available: NO_PUBKEY EB3E94ADBE1229CF
13402정성태8/20/20234252닷넷: 2137. ILSpy의 nuget 라이브러리 버전 - ICSharpCode.Decompiler
13401정성태8/19/20234410닷넷: 2136. .NET 5+ 환경에서 P/Invoke의 성능을 높이기 위한 SuppressGCTransition 특성 [1]
13400정성태8/10/20234235오류 유형: 874. 파이썬 - pymssql을 윈도우 환경에서 설치 불가
13399정성태8/9/20233989닷넷: 2135. C# - 지역 변수로 이해하는 메서드 매개변수의 값/참조 전달
13398정성태8/3/20235087스크립트: 55. 파이썬 - pyodbc를 이용한 SQL Server 연결 사용법
13397정성태7/23/20234481닷넷: 2134. C# - 문자열 연결 시 string.Create를 이용한 GC 할당 최소화
13396정성태7/22/20234226스크립트: 54. 파이썬 pystack 소개 - 메모리 덤프로부터 콜 스택 열거
13395정성태7/20/20234016개발 환경 구성: 685. 로컬에서 개발 중인 ASP.NET Core/5+ 웹 사이트에 대해 localhost 이외의 호스트 이름으로 접근하는 방법
13394정성태7/16/20233930오류 유형: 873. Oracle.ManagedDataAccess.Client - 쿼리 수행 시 System.InvalidOperationException
1  2  3  4  5  6  7  8  9  [10]  11  12  13  14  15  ...