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 Azure
Instâ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.
Pré-requisitos
Para concluir este guia de início rápido, você precisa:
Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Um banco de dados onde você executará uma consulta.
Você pode usar um destes guias de início rápido para criar e configurar um banco de dados:
Ação Banco de dados SQL Instância Gerida do SQL SQL Server na VM do Azure Azure Synapse Analytics Criar Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell Modelo de implantação Modelo de implantação Modelo de implantação Modelo de implantação Configurar Regra de firewall IP no nível do servidor Conectividade de uma VM Configurações de conectividade Conectividade a partir de instalações no local conectar-se a uma instância do SQL Server Obter informações de conexão Azure SQL Azure SQL SQL VM Synapse SQL Python 3 e software relacionado
Ação macOS Linux Windows Instale o driver ODBC, sqlcmd e o driver Python para SQL Server pt-PT: Configurar um ambiente de desenvolvimento em Python para pyodbc Configurar um ambiente de desenvolvimento para Python pyodbc Configure um ambiente para desenvolvimento em Python com pyodbc. Instale o Python e outros pacotes necessários Utilize sudo apt-get install python python-pip gcc g++ build-essential
.Informações adicionais driver ODBC da Microsoft no macOS driver ODBC da Microsoft no Linux driver ODBC da Microsoft no Windows
Para explorar ainda mais o Python e o banco de dados no Banco de Dados SQL do Azure, consulte bibliotecas do Banco de Dados SQL do Azure para Python, o repositório pyodbc e um exemplo de pyodbc .
Criar código para consultar seu banco de dados
Em um editor de texto, crie um novo arquivo chamado sqltest.py.
Adicione o seguinte código. Obtenha as informações de conexão na seção de pré-requisitos e substitua seus próprios valores por <servidor>, <banco de dados>, <nome de usuário>e <senha>.
import pyodbc server = '<server>.database.windows.net' database = '<database>' username = '<username>' password = '{<password>}' driver= '{ODBC Driver 17 for SQL Server}' with pyodbc.connect('DRIVER='+driver+';SERVER=tcp:'+server+';PORT=1433;DATABASE='+database+';UID='+username+';PWD='+ password) as conn: with conn.cursor() as cursor: cursor.execute("SELECT TOP 3 name, collation_name FROM sys.databases") row = cursor.fetchone() while row: print (str(row[0]) + " " + str(row[1])) row = cursor.fetchone()
Execute o código
Em um prompt de comando, execute o seguinte comando:
python sqltest.py
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.
- Verifique se o driver ODBC instalado é a mesma versão que a variável
driver
no código acima. Por exemplo, o código mostra 17, mas você pode ter instalado uma versão diferente. - 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.