Hızlı Başlangıç: Python için mssql-python sürücüsüne bağlanma

Bu hızlı başlangıçta, bir Python betiğini oluşturduğunuz ve örnek verilerle yüklediğiniz bir veritabanına bağlarsınız. mssql-python Python sürücüsünü kullanarak veritabanınıza bağlanır ve verileri okuma ve yazma gibi temel işlemleri gerçekleştirirsiniz.

Sürücü, mssql-python Windows makinelerinde dış bağımlılık gerektirmez. Sürücü, ihtiyaç duyduğu her şeyi tek pip bir yüklemeyle yükler ve yükseltmeye ve test etmeye vaktiniz olmayan diğer betikleri bozmadan yeni betikler için sürücünün en son sürümünü kullanmanıza olanak sağlar.

mssql-python belgeleri | mssql-python kaynak kodu | Paket (PyPi) | Visual Studio Code

Önkoşullar

Python 3
- Eğer Python zaten yüklü değilse, python.org'dan Python çalışma zamanı ve Python Paket Dizini (PyPI) paket yöneticisini yükleyin.
- Kendi ortamınızı kullanmamak mı tercih ediyorsunuz? GitHub Codespaces kullanarak devcontainer olarak açın.
(İsteğe bağlı) Azure Command-Line Arabirimi (CLI)
SQL Server, Azure SQL Veritabanı veya Fabric'deki SQL veritabanında, örnek bir şema ve geçerli bir bağlantı dizesi.

Kurulum

Python sürücüsünü kullanarak mssql-python bir uygulama geliştirmek üzere geliştirme ortamınızı yapılandırmak için bu adımları izleyin.

Uyarı

Bu sürücü SQL Server'da, Doku'daki SQL veritabanında ve Azure SQL Veritabanı'nda varsayılan olarak etkinleştirilen Tablosal Veri Akışı (TDS) protokollerini kullanır. Ek yapılandırma gerekmez.

mssql-python paketini yükleme

mssql-python Paketi PyPI'dan alın.

Boş bir dizinde bir komut istemi açın.

mssql-python paketini yükleyin.

pip install mssql-python

apk add libtool krb5-libs krb5-dev
pip install mssql-python

apt-get install -y libltdl7 libkrb5-3 libgssapi-krb5-2
pip install mssql-python

dnf install -y libtool-ltdl krb5-libs
pip install mssql-python

zypper install -y libltdl7 libkrb5-3 libgssapi-krb5-2
pip install mssql-python

zypper install -y libltdl7
pip install mssql-python

brew install openssl
pip install mssql-python

python-dotenv paketini yükleme

PyPI'den python-dotenv alın.

Aynı dizinde paketi yükleyin python-dotenv .
```
pip install python-dotenv
```

Yüklü paketleri denetleme

Hedeflenen paketlerinizin yüklendiğini doğrulamak için PyPI komut satırı aracını kullanabilirsiniz.

ile pip listyüklü paketlerin listesini denetleyin.
```
pip list
```

SQL veritabanı oluşturma

Bu hızlı başlangıç için Microsoft SQL Server'da AdventureWorks2025 Basit şeması, Doku'daki SQL veritabanı veya Azure SQL Veritabanı gerekir.

Azure portalını kullanarak dakikalar içinde SQL veritabanı oluşturma

Yeni dosya oluşturma

app.py adlı yeni bir dosya oluşturun.

Modül docstring ekleyin.

"""
Connects to a SQL database using mssql-python
"""

dahil olmak üzere mssql-pythonpaketleri içeri aktarma.

from os import getenv
from dotenv import load_dotenv
from mssql_python import connect

mssql-python.connect bir SQL veritabanına bağlanmak için işlevini kullanın.
```
load_dotenv()
conn = connect(getenv("SQL_CONNECTION_STRING"))
```
Geçerli dizinde adlı .envyeni bir dosya oluşturun.
dosyasının içine .env bağlantı dizeniz için adlı SQL_CONNECTION_STRINGbir girdi ekleyin. Buradaki örneği gerçek bağlantı dizesi değerinizle değiştirin.
```
SQL_CONNECTION_STRING="Server=<server_name>;Database={<database_name>};Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"
```
Tavsiye

Burada kullanılan bağlantı dizesi büyük ölçüde bağlandığınız SQL veritabanının türüne bağlıdır. Fabric’de bir Azure SQL Veritabanı veya bir SQL Veritabanı’na bağlanıyorsanız, bağlantı dizeleri sekmesindeki ODBC bağlantı dizesini kullanın. Senaryonuza bağlı olarak kimlik doğrulama türünü ayarlamanız gerekebilir. Bağlantı dizeleri ve söz dizimi hakkında daha fazla bilgi için bkz. bağlantı dizesi söz dizimi başvurusu.

Sorgu yürütme

Sorguyu yürütmek ve sonuçları ayrıştırmak için SQL sorgu dizesi kullanın.

SQL sorgu dizesi için bir değişken oluşturun.

SQL_QUERY = """
SELECT
TOP 5 c.CustomerID,
c.CompanyName,
COUNT(soh.SalesOrderID) AS OrderCount
FROM
SalesLT.Customer AS c
LEFT OUTER JOIN SalesLT.SalesOrderHeader AS soh ON c.CustomerID = soh.CustomerID
GROUP BY
c.CustomerID,
c.CompanyName
ORDER BY
OrderCount DESC;
"""

Veritabanındaki bir sorgudan sonuç kümesi almak için kullanın cursor.execute .
```
cursor = conn.cursor()
cursor.execute(SQL_QUERY)
```
Uyarı

Bu işlev temelde herhangi bir sorguyu kabul eder ve cursor.fetchone() kullanımıyla yinelenebilen bir sonuç kümesi döndürür.
Veritabanındaki tüm kayıtları almak için cursor.fetchall, bir foreach döngü ile kullanın. Ardından kayıtları yazdırın.
```
records = cursor.fetchall()
for r in records:
  print(f"{r.CustomerID}\t{r.OrderCount}\t{r.CompanyName}")
```
Dosyayı app.py.

Tavsiye

macOS'ta Microsoft Entra Kimlik Doğrulaması'nı kullanmak için az login aracılığıyla çalıştırarak oturum açmanız gerekir.

Bir terminal açın ve uygulamayı test edin.

python app.py

Beklenen çıktı budur.

29485   1       Professional Sales and Service
29531   1       Remarkable Bike Store
29546   1       Bulk Discount Store
29568   1       Coalition Bike Company
29584   1       Futuristic Bikes

İşlem olarak bir satır ekle

Bir INSERT deyimini güvenli bir şekilde gerçekleştirin ve parametreleri aktarın. Parametrelerin değer olarak geçirilmesi uygulamanızı SQL ekleme saldırılarına karşı korur.

randrange kitaplığından random içeri aktarmasını app.py üst kısmına ekleyin.
```
from random import randrange
```
app.py Sonuna rastgele bir ürün numarası oluşturmak için kod ekleyin.
```
productNumber = randrange(1000)
```
Tavsiye

Burada rastgele bir ürün numarası oluşturmak, bu örneği birden çok kez çalıştırabilmenizi sağlar.

SQL deyimi dizesi oluşturun.

SQL_STATEMENT = """
INSERT SalesLT.Product (
Name,
ProductNumber,
StandardCost,
ListPrice,
SellStartDate
) OUTPUT INSERTED.ProductID
VALUES (?, ?, ?, ?, CURRENT_TIMESTAMP)
"""

cursor.execute kullanarak ifadeyi yürütün.

cursor.execute(
   SQL_STATEMENT,
   (
      f'Example Product {productNumber}',
      f'EXAMPLE-{productNumber}',
      100,
      200
   )
)

cursor.fetchone kullanarak tek sonucu alın, sonucun benzersiz tanımlayıcısını yazdırın ve ardından connection.commit kullanarak işlemi bir işlem olarak onaylayın.
```
result = cursor.fetchone()
print(f"Inserted Product ID : {result['ProductID']}")
conn.commit()
```
Tavsiye

İsteğe bağlı olarak, işlemi geri almak için kullanabilirsiniz connection.rollback .
cursor.close ve connection.close kullanarak imleci ve bağlantıyı kapatın.
```
cursor.close()
conn.close()
```
Dosyayı app.py ve uygulamayı yeniden test edin.
```
python app.py
```
Beklenen çıktı budur.
```
Inserted Product ID : 1001
```

Sonraki adım

Fikirlere mssql-python katkıda bulunmak veya sorunları bildirmek için daha fazla örnek için sürücü GitHub deposunu ziyaret edin.

GitHub'da mssql-python sürücüsü

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-11-18