Conexión ODBC entre Ubuntu 14.04 (Trusty Tahr) con SQL Server utilizando FreeTDS

Conexion ODBC vía isql

En el post anterior se mostró como realizar la conexión ODBC entre Ubuntu 14.04 (Trusty Tahr) con SQL Server utilizando el Microsoft® ODBC Driver 11 for Linux, lo cual debo decir que luego de realizar diversas pruebas es la mejor opción para conectarse a servidores MS SQL 2003 o mayores, en el presente post vamos a utilizar FreeTDS para realizar la conexión, esto sirve para quienes no desean utilizar el driver oficial de MS o si deben conectarse a un servidor MS SQL 2000 por ejemplo.

Preeliminares

Debo mencionar que los pasos detallados a continuación se los realiza en un Ubuntu 14.04 server al cual se le ha instalado/configurado lo detallado en el post anterior, revísese sobre todo los pasos que se utilizaron para instalar unixODBC pues es necesario tener instalado unixODBC antes de instalar FreeTDS

Instalación/Configuración de FreeTDS

• Instalar FreeTDS (con sudo o con usuario root)

# apt-get install freetds-bin freetds-common freetds-dev

• Probar la correcta instalación

# tsql -C

debe mostrar algo parecido a:

Compile-time settings (established with the "configure" script)
Version: freetds v0.91
freetds.conf directory: /etc/freetds
MS db-lib source compatibility: no
Sybase binary compatibility: yes
Thread safety: yes
iconv library: yes
TDS version: 4.2
iODBC: no
unixodbc: yes
SSPI "trusted" logins: no
Kerberos: yes

• Se necesita el archivo libtdsodbc.so para configurar FreeTDS, así que se procede a realizar la búsqueda en el terminal

# find / -name libtdsodbc.so

debería indicar lo siguiente (… pero…):

/usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so

• En mi máquina no lo encontró, así que instalo odbcinst1debian2 y tdsodbc:

# apt-get install odbcinst1debian2 tdsodbc

• Repito la búsqueda en el terminal

# find / -name libtdsodbc.so

Y ahora sí me muestra:

/usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so

• En este punto según los manuales que había encontrado se debería configurar /etc/odbcinst.ini, /etc/odbc.ini y /etc/freetds/freetds.conf pero esto no me funciona, así que he procedido a configurar /usr/local/etc/odbcinst.ini, /usr/local/etc/odbc.ini y /etc/freetds/freetds.conf
• /usr/local/etc/odbcinst.ini

# nano /usr/local/etc/odbcinst.ini

Agregar lo siguiente (en este archivo ya deben haber las líneas correspondientes a [SQL Server Native Client 11.0] que se incluyeron en el post anterior)

[FreeTDS]
Description=FreeTDS Driver v0.91
Driver=/usr/lib/x86_64-linux-gnu/odbc/libtdsodbc.so
Setup=/usr/lib/x86_64-linux-gnu/odbc/libtdsS.so
fileusage=1
dontdlclose=1
UsageCount=1

• /usr/local/etc/odbc.ini

# nano /usr/local/etc/odbc.ini

Agregar lo siguiente:

[FreeTDS-MyDB]
Driver = FreeTDS
Description = MS SQL connection to 'NDWH' database
Trace = No
ServerName = srvMyServer
Port = 1433
Database = MyDB
TDS_Version = 8

• /etc/freetds/freetds.conf

# nano /etc/freetds/freetds.conf

Agregar lo siguiente (más detalle puede verse aquí):

# Servidor MyServer, tipo Microsoft SQL Server
[srvMyServer]
host = 192.168.99.999
port = 1433
tds version = 8
initial block size = 512 #(<- este punto lo detallo abajo)


• Verificar que la máquina vea el driver

# odbcinst -q -d

debe dar como resultado una lista que contiene entre cuyos elementos contiene [FreeTDS] (o el nombre que se haya puesto en usr/local/etc/odbcinst.ini)

• Verificar que se pueda conectar con la BBDD utilizando isql y el nombre utilizado en /usr/local/etc/odbc.ini

# isql -v FreeTDS-MyDB MyUsuario MyPassword

debe dar como resultado lo siguiente:

+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+
SQL>

• Verificar que se pueda conectar con la BBDD utilizando tsql y el nombre utilizado en /etc/freetds/freetds.conf

# tsql -S srvMyServer -U MyUsuario -P MyPassword -D MyDB

debe dar como resultado algo como lo siguiente:

locale is "en_US.UTF-8"
locale charset is "UTF-8"
using default charset "UTF-8"
Default database being set to ndwh
1>


Posibles errores y el initial block size

• Si se conecta con tsql y no con isql entonces hay algun error en las configuraciones en odbc.ini o odbcinst.ini

• Si no se conecta con isql ni con tsql es probablemente un error con «tds version», «port» o alguna configuracion en el MSSQL server, mirar http://freetds.schemamania.org/userguide/confirminstall.htm,
• Cuelgues/Errores o pérdida de conexión al realizar querys «grandes», mira esto y en particular juega con el initial block size como indico a continuación,
• El parámetro initial block size del /etc/freetds/freetds.conf según su guía sirve para especificar el tamaño máximo de un bloque, pero como yo tuve problemas de cuelgue (hanging) empecé a jugar con este parámetro (recordar que son multiplos de 512) y me funcionó para mitigar este problema que me surgió al hacer querys grandes.

En el siguiente post se muestra la conexión con una base Oracle utilizando su cliente oficial.