mssql-python 이 드라이버는 Microsoft Fabric SQL Server, Azure SQL Database, Azure SQL Managed Instance, SQL 데이터베이스에 대한 Microsoft 공식 Python 드라이버입니다. Windows, Linux, macOS에서 pip을 사용해 드라이버를 설치하세요.
사전 요구 사항
- 이 드라이버는 Python 3.10 이상이 필요하며, 이전 Python 버전은 지원하지 않습니다.
- pip 패키지 관리자(Python 3.4+에 포함됨).
중요합니다
mssql-python 드라이버는 DDBC (Direct Database Connectivity)를 사용하며, ODBC 계층을 내부적으로 번들링하고 관리합니다. Microsoft ODBC 드라이버 for SQL Server를 별도로 설치할 필요는 없습니다.
PyPi에서 설치
PIP를 사용해 드라이버를 설치하세요:
pip install mssql-python
기존 설치를 업그레이드하려면 다음을 수행합니다.
pip install --upgrade mssql-python
특정 버전을 설치하려면
pip install mssql-python==1.11.0
설치 확인
설치 후에는 드라이버가 제대로 작동하는지 확인하세요:
import mssql_python
print(f"mssql-python version: {mssql_python.__version__}")
print(f"DB-API level: {mssql_python.apilevel}")
print(f"Thread safety: {mssql_python.threadsafety}")
print(f"Parameter style: {mssql_python.paramstyle}")
예상 출력:
mssql-python version: 1.11.0
DB-API level: 2.0
Thread safety: 1
Parameter style: pyformat
플랫폼별 참고 사항
Windows
드라이버는 필요한 모든 부품이 포함된 사전 제작된 바퀴로 배송됩니다.
Linux
드라이버는 Kerberos 인증 및 동적 로딩을 위해 특정 시스템 라이브러리를 요구합니다. 배포판의 패키지 관리자를 사용해 설치하세요:
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install libltdl7 libkrb5-3 libgssapi-krb5-2
레드 햇/센트OS/페도라:
sudo dnf install libtool-ltdl krb5-libs
비고
RHEL 8 및 기타 glibc 2.28 호환 배포판(AlmaLinux 8, Rocky Linux 8)에서는 드라이버가 PyPI에 배포된 표준 manylinux_2_28 휠에서 설치됩니다.
알파인 리눅스:
apk add libltdl krb5-libs
macOS
드라이버는 Apple Silicon(arm64) 및 Intel(x86_64) Mac 모두에서 네이티브로 실행되는 universal2 팻 바이너리 형태로 제공됩니다. 별도의 유닉스 ODBC 설치가 필요하지 않습니다.
드라이버는 OpenSSL을 필요로 합니다. 홈브류를 사용해 설치하세요:
brew install openssl
SSL 관련 오류가 발생하면 OpenSSL이 제대로 연결되었는지 확인하세요:
export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"
export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"
가상 환경
충돌을 피하기 위해 Python 패키지를 가상 환경에 설치하세요:
# Create a virtual environment
python -m venv .venv
# Activate it (Windows)
.venv\Scripts\activate
# Activate it (Linux/macOS)
source .venv/bin/activate
# Install the driver
pip install mssql-python
개발용 설치
드라이버에 기여할 개발 의존성을 가진 드라이버를 설치하려면:
git clone https://github.com/microsoft/mssql-python.git
cd mssql-python
pip install -e ".[dev]"
설치 문제 해결
PIP 설치 실패, "매칭 배포판 없음"
Python 3.10 이상을 사용하고 있는지 확인하세요:
python --version
구버전 Python을 사용 중이라면 Python을 업그레이드하거나 pyenv로 여러 버전을 관리하세요.
설치 후 가져오기 오류
만약 보인ModuleNotFoundError: No module named 'mssql_python'다면, 패키지를 설치한 Python 환경을 동일하게 사용하고 있는지 확인하세요.
pip show mssql-python
Linux/macOS에서의 권한 오류
권한 오류가 발생하면 sudo pip를 사용하지 마세요. 대신 가상 환경이나 플래그를 --user 사용하세요.
pip install --user mssql-python