Compartilhar via

Início Rápido: Usar Python para consultar um banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada de SQL do Azure

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

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

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

Pré-requisitos

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

Configurando

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 de 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 arquivos

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

  2. No arquivo .env, adicione uma entrada para sua string 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"

    Dica

    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 no Fabric, 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 seu cenário. Para obter mais informações sobre cadeias de conexão e sua sintaxe, consulte DSN e as palavras-chave e atributos da cadeia de conexão.

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

  4. Adicione o código seguinte:

    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)

Executar o código

  1. No prompt de comando, execute o comando a seguir:

    python sqltest.py

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

    Se você receber um erro, faça o seguinte:

    • Verifique se você está usando o nome de servidor, banco de dados e usuário, além da senha, corretos.

    • Se você estiver executando o código em 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