pyodbc_sqlalchemy_macOS 👨‍💻🚀☕️

Fuente: 🗃️

GitHub - Connecting to SQL Server from Mac OSX

https://github.com/mkleehammer/pyodbc/wiki/Connecting-to-SQL-Server-from-Mac-OSX

Install the Microsoft ODBC driver for SQL Server (macOS)

https://learn.microsoft.com/en-us/sql/connect/odbc/linux-mac/install-microsoft-odbc-driver-sql-server-macos?view=sql-server-ver16#17

Important

Antes de comenzar, es fundamental tener un entorno de Python configurado adecuadamente. En el repositorio conda_environments_install, proporciono una guía detallada sobre cómo configurar entornos conda según el proyecto en el que estés trabajando, asegurando que todas las dependencias necesarias se encuentren dentro del mismo. Si aún no estás familiarizado con el uso de entornos, te recomiendo revisarlo.

Pasos a seguir para instalacion

• Instalar Homebrew

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
  

• Instalar Controladores ODBC

• MICROSOFT

  1 - Agregar repositorio de Microsoft:

  brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
  

  2 - Actualizar Homebrew:

  brew update
  

  3 - Instalar msodbcsql18 y mssql-tools18:

  HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18
  

Note

msodbcsql18: Es el controlador ODBC específico para SQL Server, proporcionando conectividad ODBC a bases de datos SQL Server. mssql-tools18: Incluye herramientas como sqlcmd y bcp para interactuar con SQL Server desde la línea de comandos. Compatibilidad otros sitemas

• MySQL brew install mysql-connector-odbc
• PostgreSQL brew install psqlodbc
• SQLite brew install qliteodbc

• Configuracion del entorno

  • Agrega la ruta de las bibliotecas de Homebrew a DYLD_LIBRARY_PATH en macOS

  export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
  

Codigo prueba en python para conexión

Warning

Se requiere coordinar con los Administradores de bases de datos para que te asignen un usuario no autenticado que te permita establecer una conexión segura a la base de datos desde macOS utilizando Python

• Creacion de archivo odbc.ini

  • Este archivo nos ayuda a crear las credenciales en el y no quemarlas dentro del codigo python, lo mas recomendable seria poder utilizar una boveda compartida o cloud para gestionarlas desde ahi, pero de momento podriamos hacerlo de la siguiente forma: crear el archivo /usr/local/etc/odbc.ini

  [SQLSERVER113]
  Description = My SQL Server
  Driver = ODBC Driver 18 for SQL Server
  Server = <TU_SERVIDOR> #.113
  Database = <TU_BASE_DE_DATOS>
  UID = <TU_USUARIO>
  PWD = <TU_CONTRASEÑA>
  TrustServerCertificate = yes
  

  • Codigo python con pyodbc

import pyodbc
import configparser

config = configparser.ConfigParser()
config.read('/usr/local/etc/odbc.ini')
db_config = config['SQLSERVER113']

conn_str = (
    f'DRIVER={db_config["Driver"]};'
    f'SERVER={db_config["Server"]};'
    f'DATABASE={db_config["Database"]};'
    f'UID={db_config["UID"]};'
    f'PWD={db_config["PWD"]};'
    f'TrustServerCertificate={db_config["TrustServerCertificate"]};'
)

try:
    connection = pyodbc.connect(conn_str)
    print("Connected to the database!")
    connection.close()
except Exception as e:
    print(f"Failed to connect to the database: {e}")

• Codigo python con SQLAlchemy

import urllib
import configparser
import pandas as pd
from sqlalchemy import create_engine, text
from sqlalchemy.exc import SQLAlchemyError

# ------------------------------------------------
# configure crednentials
# ------------------------------------------------
config = configparser.ConfigParser()
config.read('/usr/local/etc/odbc.ini')
db_config = config['SQLSERVER113']

# Cadena de conexión ODBC
odbc_str = (
    f'DRIVER={db_config["Driver"]};SERVER={db_config["Server"]},{db_config["PORT"]};DATABASE={db_config["Database"]};UID={db_config["UID"]};PWD={db_config["PWD"]};TrustServerCertificate={db_config["TrustServerCertificate"]};Encrypt=yes'
    )

# Convertir a formato compatible con SQLAlchemy
connection_string = f'mssql+pyodbc:///?odbc_connect={urllib.parse.quote_plus(odbc_str)}'

def get_driver_list():
    """_summary_

    Returns:
        _type_: _description_
    """
    import pyodbc

    print("List of ODBC Drivers:")
    print("------------------------")
    dlist = pyodbc.drivers()
    for drvr in dlist:
        print(drvr)
    print("------------------------")
    return 0

def test_connection():
    try:
        query = text("SELECT @@version;")
        engine = create_engine(connection_string)
        conn = engine.connect()
        
        df = pd.read_sql(query, conn)
        print(df.iloc[0, 0])
        print('Connection SUCCESSFUL')
        conn.close()
        return 0
    except SQLAlchemyError as err:
        print("Error", err.__cause__)
        return -1

def get_engine(echo=True):
    """_summary_

    Returns:
        _type_: _description_
    """
    try:
        engine = create_engine(connection_string, echo=echo)
        return engine

    except SQLAlchemyError as err:
        print("error", err.__cause__)
        return -1

def get_conn():
    """_summary_

    Returns:
        _type_: _description_
    """
    try:
        engine = get_engine(echo=False)
        conn = engine.connect()
        return conn

    except SQLAlchemyError as err:
        print("error", err.__cause__)
        return -1

if __name__ == "__main__":
    test_connection()