Partilhar via

Guia de início rápido: usar Python para consultar um banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada SQL do Azure

Aplica-se a:Banco de Dados SQL do AzureInstância Gerenciada SQL do Azure do Azure Synapse Analytics

Neste início rápido, você usa Python para se conectar ao Banco de Dados SQL do Azure, à Instância Gerenciada SQL do Azure ou ao banco de dados SQL Synapse e usa instruções T-SQL para consultar dados.

Documentação do mssql-python | Código fonte do mssql-python | Pacote (PyPi)

Pré-requisitos

Para concluir este guia de início rápido, você precisa:

Preparação

Siga estas etapas para configurar seu ambiente de desenvolvimento para desenvolver um aplicativo usando o mssql-python driver Python.

Observação

Esse driver usa o protocolo TDS (Tabular Data Stream ), que é habilitado por padrão no SQL Server, no banco de dados SQL no Fabric e no Banco de Dados SQL do Azure. Nenhuma configuração extra é necessária.

Instalar o pacote mssql-python

Obtenha o pacote mssql-python do PyPI.

  1. Abra um prompt de comando em um diretório vazio.

  2. Instale o pacote mssql-python.

    pip install mssql-python

Instalar o pacote python-dotenv

Obtenha o python-dotenv do PyPI.

  1. No mesmo diretório, instale o python-dotenv pacote.

    pip install python-dotenv

Verifique os pacotes instalados

Você pode usar a ferramenta de linha de comando PyPI para verificar se os pacotes pretendidos estão instalados.

  1. Verifique a lista de pacotes instalados com pip list.

    pip list

Criar novos ficheiros

  1. No diretório atual, crie um novo arquivo chamado .env.

  2. Dentro do .env arquivo, adicione uma entrada para sua cadeia de conexão chamada SQL_CONNECTION_STRING. Substitua o exemplo aqui pelo valor real da cadeia de conexão.

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

    Sugestão

    A cadeia de conexão usada aqui depende em grande parte do tipo de banco de dados SQL ao qual você está se conectando. Se você estiver se conectando a um Banco de Dados SQL do Azure ou a um banco de dados SQL na Malha, use a cadeia de conexão ODBC na guia Cadeias de conexão. Talvez seja necessário ajustar o tipo de autenticação dependendo do cenário. Para obter mais informações sobre cadeias de conexão e sua sintaxe, consulte Palavras-chave e atributos de DSN e cadeia de conexão.

  3. Em um editor de texto, crie um novo arquivo chamado sqltest.py.

  4. Adicione o seguinte código.

    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)

Execute o código

  1. Em um prompt de comando, execute o seguinte comando:

    python sqltest.py

  2. Verifique se os bancos de dados e seus agrupamentos são retornados e feche a janela de comando.

    Se receber um erro:

    • Verifique se o nome do servidor, o nome do banco de dados, o nome de usuário e a senha que você está usando estão corretos.

    • Se você estiver executando o código de um ambiente local, verifique se o firewall do recurso do Azure que você está tentando acessar está configurado para permitir o acesso do endereço IP do seu ambiente.

Conteúdo relacionado

  • Last updated on