Udostępnij za pomocą

Szybki start: wykonywanie zapytań względem bazy danych w usłudze Azure SQL Database lub Azure SQL Managed Instance przy użyciu języka Python

Dotyczy:Azure SQL Database Azure SQL Managed InstanceAzure Synapse Analytics

W tym przewodniku Szybki start użyjesz języka Python, aby nawiązać połączenie z usługą Azure SQL Database, usługą Azure SQL Managed Instance lub bazą danych Synapse SQL Database i używać instrukcji T-SQL do wykonywania zapytań o dane.

Dokumentacja mssql-python | Pakiet (PyPi)

Wymagania wstępne

Aby ukończyć ten przewodnik Szybki Start, musisz spełnić następujące warunki:

Konfigurowanie

Wykonaj następujące kroki, aby skonfigurować środowisko deweloperskie do tworzenia aplikacji przy użyciu mssql-python sterownika języka Python.

Uwaga / Notatka

Ten sterownik używa protokołu strumienia danych tabelarycznych (TDS), który jest domyślnie włączony w SQL Server, bazie danych SQL w Fabric oraz Azure SQL Database. Nie jest wymagana żadna dodatkowa konfiguracja.

Instalowanie pakietu mssql-python

mssql-python Pobierz pakiet z PyPI.

  1. Otwórz wiersz polecenia w pustym katalogu.

  2. Zainstaluj pakiet mssql-python.

    pip install mssql-python

Instalowanie pakietu python-dotenv

Pobierz element python-dotenv z PyPI.

  1. W tym samym katalogu zainstaluj pakiet python-dotenv.

    pip install python-dotenv

Sprawdzanie zainstalowanych pakietów

Możesz użyć narzędzia wiersza polecenia PyPI, aby sprawdzić, czy są zainstalowane zamierzone pakiety.

  1. Sprawdź listę zainstalowanych pakietów za pomocą polecenia pip list.

    pip list

Tworzenie nowych plików

  1. W bieżącym katalogu utwórz nowy plik o nazwie .env.

  2. W pliku .env dodaj wpis dla łańcucha połączenia o nazwie SQL_CONNECTION_STRING. Zastąp przykład wartością rzeczywistych parametrów połączenia.

    SQL_CONNECTION_STRING="Server=<server_name>;Database={<database_name>};Encrypt=yes;TrustServerCertificate=no;Authentication=ActiveDirectoryInteractive"

    Wskazówka

    Parametry połączenia używane w tym miejscu w dużej mierze zależą od typu bazy danych SQL, z którą nawiązujesz połączenie. Jeśli nawiązujesz połączenie z usługą Azure SQL Database lub bazą danych SQL w sieci szkieletowej, użyj parametrów połączenia ODBC z karty parametry połączenia. W zależności od scenariusza może być konieczne dostosowanie typu uwierzytelniania. Aby uzyskać więcej informacji na temat parametrów połączenia i ich składni, zobacz DSN i Parametry połączenia Słowa kluczowe i atrybuty.

  3. W edytorze tekstów utwórz nowy plik o nazwie sqltest.py.

  4. Dodaj następujący kod źródłowy języka.

    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)

Uruchamianie kodu

  1. W wierszu polecenia uruchom następujące polecenie:

    python sqltest.py

  2. Sprawdź, czy bazy danych i ich sortowania są zwracane, a następnie zamknij okno polecenia.

    Jeśli wystąpi błąd:

    • Sprawdź, czy używana nazwa serwera, nazwa bazy danych, nazwa użytkownika i hasło są poprawne.

    • Jeśli używasz kodu ze środowiska lokalnego, sprawdź, czy zapora zasobu platformy Azure, do którego próbujesz uzyskać dostęp, jest skonfigurowana tak, aby zezwolić na dostęp z adresu IP środowiska.

Treści powiązane

  • Last updated on