Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Dalam mulai cepat ini, Anda menggunakan Python untuk menyambungkan ke Azure SQL Database, Azure SQL Managed Instance, atau synapse SQL database dan menggunakan pernyataan T-SQL untuk meminta data.
dokumentasi mssql-python | sumber kode mssql-python | Paket (PyPi)
Prasyarat
Untuk menyelesaikan mulai cepat ini, Anda memerlukan:
Akun Azure dengan langganan aktif. Buat akun secara gratis.
Database
Anda bisa menggunakan salah satu mulai cepat ini untuk membuat lalu mengonfigurasi database:
Perbuatan SQL Database SQL Managed Instance SQL Server di VM Azure Azure Synapse Analytics Buat Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell Templat penyebaran Templat penyebaran Templat penyebaran Templat penyebaran Konfigurasikan Aturan firewall IP tingkat server Konektivitas dari komputer virtual Pengaturan konektivitas Konektivitas dari lokal Menyambungkan ke instans SQL Server Mendapatkan informasi koneksi Azure SQL Azure SQL SQL VM Synapse SQL Python 3
Jika Anda belum memiliki Python, instal manajer paket runtime Python dan Python Package Index (PyPI) dari python.org.
Lebih memilih untuk tidak menggunakan lingkungan Anda sendiri? Buka sebagai devcontainer menggunakan GitHub Codespaces.
Database di SQL Server, Azure SQL Database, atau database SQL di Fabric dengan
AdventureWorks2025skema sampel dan string koneksi yang valid.
Persiapan
Ikuti langkah-langkah ini untuk mengonfigurasi lingkungan pengembangan Anda untuk mengembangkan aplikasi menggunakan mssql-python driver Python.
Nota
Driver ini menggunakan protokol Aliran Data Tabular (TDS), yang diaktifkan secara default di SQL Server, database SQL di Fabric dan Azure SQL Database. Tidak diperlukan konfigurasi tambahan.
Menginstal paket mssql-python
mssql-python Dapatkan paket dari PyPI.
Buka command prompt di direktori kosong.
Pasang paket
mssql-pythontersebut.
Menginstal paket python-dotenv
Dapatkan python-dotenv dari PyPI.
Di direktori yang sama, instal
python-dotenvpaket.pip install python-dotenv
Periksa paket yang terinstal
Anda dapat menggunakan alat baris perintah PyPI untuk memverifikasi bahwa paket yang Anda maksudkan diinstal.
Periksa daftar paket yang diinstal dengan
pip list.pip list
Membuat file baru
Di direktori saat ini, buat file baru bernama
.env.Di dalam file
.env, tambahkan entri untuk string koneksi Anda yang bernamaSQL_CONNECTION_STRING. Ganti contoh di sini dengan nilai string koneksi Anda yang sebenarnya.SQL_CONNECTION_STRING="Server=<server_name>;Database={<database_name>};Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"Tip
String koneksi yang digunakan di sini sebagian besar tergantung pada jenis database SQL yang Anda sambungkan. Jika Anda menyambungkan ke Azure SQL Database atau database SQL di Fabric, gunakan string koneksi ODBC dari tab string koneksi. Anda mungkin perlu menyesuaikan jenis autentikasi tergantung pada skenario Anda. Untuk informasi selengkapnya tentang string koneksi dan sintaksnya, lihat DSN dan Kata Kunci dan Atribut String Koneksi.
Di editor teks, buat file baru bernama sqltest.py.
Tambahkan kode berikut.
from os import getenv from dotenv import load_dotenv from mssql_python import connect load_dotenv() with connect(getenv("SQL_CONNECTION_STRING")) as conn: with conn.cursor() as cursor: cursor.execute("SELECT TOP 3 name, collation_name FROM sys.databases") rows = cursor.fetchall() for row in rows: print(row.name, row.collation_name)
Menjalankan kode
Di jendela perintah, jalankan perintah berikut ini:
python sqltest.pyVerifikasi bahwa database dan kolasenya dikembalikan, lalu tutup jendela perintah.
Jika Anda menerima kesalahan:
Verifikasi bahwa nama server, nama database, nama pengguna, dan kata sandi yang Anda gunakan sudah benar.
Jika Anda menjalankan kode dari lingkungan lokal, verifikasi bahwa firewall sumber daya Azure yang coba Anda akses dikonfigurasi untuk mengizinkan akses dari alamat IP lingkungan Anda.