Microsoft MVP성태의 닷넷 이야기
스크립트: 55. 파이썬 - pyodbc를 이용한 SQL Server 연결 사용법 [링크 복사], [링크+제목 복사]
조회: 3254
글쓴 사람
정성태 (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)
13490정성태12/19/20231392개발 환경 구성: 698. Golang - GLIBC 의존을 없애는 정적 빌드 방법
13489정성태12/19/20231179개발 환경 구성: 697. GoLand에서 ldflags 지정 방법
13488정성태12/18/20231187오류 유형: 884. HTTP 500.0 - 명령행에서 실행한 ASP.NET Core 응용 프로그램을 실행하는 방법
13487정성태12/16/20231399개발 환경 구성: 696. C# - 리눅스용 AOT 빌드를 docker에서 수행 [1]
13486정성태12/15/20231223개발 환경 구성: 695. Nuget config 파일에 값 설정/삭제 방법
13485정성태12/15/20231224오류 유형: 883. dotnet build/restore - error : Root element is missing
13484정성태12/14/20231344개발 환경 구성: 694. Windows 디렉터리 경로를 WSL의 /mnt 포맷으로 구하는 방법
13483정성태12/14/20231504닷넷: 2184. C# - 하나의 resource 파일을 여러 프로그램에서 (AOT 시에도) 사용하는 방법파일 다운로드1
13482정성태12/13/20231847닷넷: 2183. C# - eFriend Expert OCX 예제를 .NET Core/5+ Console App에서 사용하는 방법 [2]파일 다운로드1
13481정성태12/13/20231551개발 환경 구성: 693. msbuild - .NET Core/5+ 프로젝트에서 resgen을 이용한 리소스 파일 생성 방법파일 다운로드1
13480정성태12/12/20231583개발 환경 구성: 692. Windows WSL 2 + Chrome 웹 브라우저 설치
13479정성태12/11/20231567개발 환경 구성: 691. WSL 2 (Ubuntu) + nginx 환경 설정
13477정성태12/8/20231724닷넷: 2182. C# - .NET 7부터 추가된 Int128, UInt128 [1]파일 다운로드1
13476정성태12/8/20231542닷넷: 2181. C# - .NET 8 JsonStringEnumConverter의 AOT를 위한 개선파일 다운로드1
13475정성태12/7/20231566닷넷: 2180. .NET 8 - 함수 포인터에 대한 Reflection 정보 조회파일 다운로드1
13474정성태12/6/20231470개발 환경 구성: 690. 닷넷 코어/5+ 버전의 ilasm/ildasm 실행 파일 구하는 방법 - 두 번째 이야기
13473정성태12/5/20231580닷넷: 2179. C# - 값 형식(Blittable)을 메모리 복사를 이용해 바이트 배열로 직렬화/역직렬화파일 다운로드1
13472정성태12/4/20231452C/C++: 164. Visual C++ - InterlockedCompareExchange128 사용 방법
13471정성태12/4/20231501Copilot - To enable GitHub Copilot, authorize this extension using GitHub's device flow
13470정성태12/2/20231702닷넷: 2178. C# - .NET 8부터 COM Interop에 대한 자동 소스 코드 생성 도입파일 다운로드1
13469정성태12/1/20231536닷넷: 2177. C# - (Interop DLL 없이) CoClass를 이용한 COM 개체 생성 방법파일 다운로드1
13468정성태12/1/20231474닷넷: 2176. C# - .NET Core/5+부터 달라진 RCW(Runtime Callable Wrapper) 대응 방식파일 다운로드1
13467정성태11/30/20231498오류 유형: 882. C# - Unhandled exception. System.Runtime.InteropServices.COMException (0x800080A5)파일 다운로드1
13466정성태11/29/20231630닷넷: 2175. C# - DllImport 메서드의 AOT 지원을 위한 LibraryImport 옵션
13465정성태11/28/20231457개발 환경 구성: 689. MSBuild - CopyToOutputDirectory가 "dotnet publish" 시에는 적용되지 않는 문제파일 다운로드1
13464정성태11/28/20231594닷넷: 2174. C# - .NET 7부터 UnmanagedCallersOnly 함수 export 기능을 AOT 빌드에 통합파일 다운로드1
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...