Como Conectar e Testar uma Conexão com SQL Server Usando Python

Se você está desenvolvendo aplicações ou analisando dados, em algum momento vai precisar se conectar a um banco de dados. Neste post, vou te mostrar como conectar o Python ao SQL Server usando a biblioteca pyodbc.

Considerando que você já tem instalado o SQL Server (clique aqui para saber mais), uma IDE e Python instalados, você pode abrir o visual studio code, abrir o terminal, e digitar: pip install pyodbc

Após a instalação da biblioteca você poderá testar o script abaixo no vs code, lembrando que se você alterou o nome padrão do servidor, não esqueça de substituí-lo abaixo no lugar de "localhost"

import pyodbc

try:
    # Conectando ao banco 'master' usando instância padrão no localhost
    conn = pyodbc.connect(
        'DRIVER={ODBC Driver 17 for SQL Server};'
        'SERVER=localhost;'
        'DATABASE=master;'
        'Trusted_Connection=yes;',
        timeout=5
    )

    print("✅ Conexão bem-sucedida!")

    # Teste: listar os bancos de dados disponíveis
    cursor = conn.cursor()
    cursor.execute("SELECT name FROM sys.databases")
    for row in cursor.fetchall():
        print("📂 Banco:", row.name)

    conn.close()

except Exception as e:
    print("❌ Erro ao conectar:", e)

Se o nome do servidor esta correto e o SQL esta funcionando normalmente e deu erro de conexão, possivelmente esta faltando o driver de conexão.

Para saber se você tem o driver, abra o cmd (prompt de comando) e digite: odbcad32.exe

Clique aqui para fazer o download

Depois disso, você poderá adicionar manualmente a conexão inserindo nome de usuário e senha, ou login pela conta do windows.

Se ainda asism não funcionar, reinicie o serviço do SQL digitando na lupa do windows: Configuration Manager, no menu do lado esquerdo clique em Serviços do SQL Server e em nome, selecione o serviço e clique com o botão direito para reiniciar.

Também é possível executar o script em python em uma IDE para identificar quais drivers estão instalados:

import pyodbc
print(pyodbc.drivers())

No cmd podemos ver o nome do nosso servidor: sqlcmd -L