Bagikan melalui


Mulai cepat: Menggunakan Python untuk mengkueri database di Azure SQL Database atau Azure SQL Managed Instance

Berlaku untuk:Azure SQL Database Azure SQL Managed InstanceAzure 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:

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.

  1. Buka command prompt di direktori kosong.

  2. Pasang paket mssql-python tersebut.

    pip install mssql-python
    

Menginstal paket python-dotenv

Dapatkan python-dotenv dari PyPI.

  1. Di direktori yang sama, instal python-dotenv paket.

    pip install python-dotenv
    

Periksa paket yang terinstal

Anda dapat menggunakan alat baris perintah PyPI untuk memverifikasi bahwa paket yang Anda maksudkan diinstal.

  1. Periksa daftar paket yang diinstal dengan pip list.

    pip list
    

Membuat file baru

  1. Di direktori saat ini, buat file baru bernama .env.

  2. Di dalam file .env, tambahkan entri untuk string koneksi Anda yang bernama SQL_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.

  3. Di editor teks, buat file baru bernama sqltest.py.

  4. 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

  1. Di jendela perintah, jalankan perintah berikut ini:

    python sqltest.py
    
  2. Verifikasi 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.