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.

Pré-requisitos

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

Para explorar ainda mais o Python e o banco de dados no Banco de Dados SQL do Azure, confira Bibliotecas do Banco de Dados SQL do Azure para Python, o repositório pyodbc e um exemplo de pyodbc.

Criar um código para consultar o banco de dados

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

  2. Adicione o código seguinte: Obter as informações de conexão da seção pré-requisitos e substituir seus 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()
    

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.
    • Verifique se o driver ODBC instalado tem a mesma versão da 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 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.

Próximas etapas