Difference between revisions of "ODBCConn/es"
Line 108: | Line 108: | ||
=== Cadena de conexión ODBC === | === Cadena de conexión ODBC === | ||
Antes de pasar a los detalles de este envoltorio, se deben tener unos conocimientos básicos acerca de como se identifica una fuente de datos ODBC. | Antes de pasar a los detalles de este envoltorio, se deben tener unos conocimientos básicos acerca de como se identifica una fuente de datos ODBC. | ||
− | Primero de todo, un gestor de drivers ODBC ofrece dos caminos para realizar | + | Primero de todo, un gestor de drivers ODBC ofrece dos caminos para realizar la configuración de un conjunto de parámetros: |
* DSN ('''D'''ata'''S'''ource '''N'''ame): una fuente de datos que puede escogerse o bien para el sistema o para un usuario, identificado por un único nombre. Los DSN se pueden configurar utilizando el administrador de fuente de datos ODBC o bien editando manualmente el fichero (o registro) <code>odbc.ini</code>. | * DSN ('''D'''ata'''S'''ource '''N'''ame): una fuente de datos que puede escogerse o bien para el sistema o para un usuario, identificado por un único nombre. Los DSN se pueden configurar utilizando el administrador de fuente de datos ODBC o bien editando manualmente el fichero (o registro) <code>odbc.ini</code>. |
Revision as of 08:18, 9 April 2009
│
English (en) │
español (es) │
français (fr) │
日本語 (ja) │
La unit ODBCConn implementa una conexión SQLdb con fuentes de datos ODBC.
Overview
ODBC
ODBC (Open Database Connectivity) o conectividad abierta de base de datos es una tecnología que permite conectar a una gran variedad de bases de datos utilizando una sola API, en concreto la API ODBC.
Existen implementaciones ODBC para distintas plataformas estando disponibles los drivers para la mayoría de los sistemas de gestión de bases de datos actuales. La documentación oficial sobre ODBC se puede encontrar en la siguiente dirección:
TOBCConnection
FreePascal se distribuye con las cabeceras (headers) ODBC; encontrándose en las unidades odbcsql
y odbcsqldyn
.
TODBCConnection
es un descendiente de TSQLConnection
que aporta un agradable envoltorio OOP para ODBC utilizando el framework SQLdb.
En Lazarus se puede encontrar el componente TODBCConnection
en la solapa SQLdb.
También se puede utilizar el componente TODBCConnection
añadiendo ODBCConn
en la claúsula uses.
Se han implementado las siguientes características:
- Ejecutar consultas (queries) y recabar cojuntos de resultados.
- La mayor parte de tipos de campos, incluyendo blobs.
- query parameters (tipos string (cadena) e integer (entero)).
- Preparando consultas (queries).
- UpdateIndexDefs (lo que permite utilizar ApplyUpdates); parche remitido a fpc-devel, May 2, 2007.
Otras implementaciones están pendientes y son:
- Soporte de transacción adecuada; actualmente cada conexión corresponde a una transacción.
- Algunos tipos de campo.
- SQL_TYPE_UTC* (están mencionados en la documentación sobre ODBC , pero parece que no se están utilizando en la implementación).
- SQL_INTERVAL_* (¿Que debería corresponder con TFieldType?).
- SQL_GUID (TGUIDField no había sido implementado hasta recientemente).
¿ Porque utilizar ODBC ?
FreePascal se distribuye con componentes para conectar a varias bases de datos tales como MySQL, PostGreSQL, Firebird, Oracle, etc. Para aquellas bases de datos que no figuran en la lista, tales como MS-Access, ODBC es una buena opción. Actualmente, el componente TODBCConnection está diseñado para sortear (circumvent) la estricta licencia de MySQL para aplicaciones que no sean GPL o que no cumplan con MySQL AB's excepción FLOSS.
Installing ODBC and ODBC Drivers
Antes de poder conectar a una base de datos utilizando ODBC, es necesario instalar primero:
- Un gestor de drivers ODBC (Driver Manager).
- Un driver ODBC específico para la DBMS a la cual se va a conectar.
The ODBC Driver Manager
Windows
Windows contiene un gestor de drivers ODBC que podemos utilizar para realizar configuraciones con cierta facilidad y que se puede encontrar en las siguientes ubicaciones dependiendo del sistema operativo:
- El elemento Orígenes de datos (ODBC) que se encuentra en Herramientas administrativas dentro del Panel de control (Win 2000, XP, Vista).
- El elemento Orígenes de datos (32-bit) que se encuentra en el Panel de control (Win 9x, ME).
- El elemento ODBC en el Control Panel (Win NT)
Unices
Dos gestores de drivers ODBC muy conocidos para plataformas de tipo UNIX son unixODBC y iODBC.
TODBCConn
es conocido por funcionar con unixODBC; su compatibilidad con iODBC está todavía pendiente de verificación.
Debian
Para Debian se puede instalar el paquete unixodbc mediante los siguientes mandatos:
aptitude install unixodbc aptitude install unixodbc-bin # si necesitas algunas utilidades GUI (Interface gráfica de usuario)
La unidad odbcsqldyn
, y por tanto odbcconn
, buscarán un fichero llamado libodbc.so
.
No aceptará un fichero del estilo libodbc.so.1
o libodbc.so.1.0.0
.
El paquete unixodbc de debian no crea un enlace simbólico (symlink) con el nombre /usr/lib/libodbc.so
; por lo que el usuario deberá:
- Crear el enlace manualmente:
ln -s libodbc.so.1 /usr/lib/libodbc.so
, o bien - Instalar el paquete unixodbc-dev, el cual si creará el enlace.
Si se tiene instalado el paquete unixodbc-bin entonces se puede arrancar el programa ODBCConfig
para configurar los drivers ODBC y los DSN.
Ubuntu
Para Ubuntu, seguir las instrucciones para Debian.
Nota: el paquete unixodbc-bin puede no estar disponible desde el repositorio por defecto de paquetes.
ODBC Drivers
(esta información falta por completar)
Conectando a una fuente de datos ODBC
Los parámetros para conectar a una fuente de datos ODBC se describen en una cadena de conexión.
Se trata de una cadena del estilo NAME=VALUE;NAME=VALUE
.
TODBCConnection
aporta un envoltorio sobre esta cadena de conexión.
Algunas de sus propiedades se mapean a pares de nombre/valor en la cadena de conexión, pudiéndose especificar parametros personalizados en la propiedad Params
(la cual es TStrings
).
Cadena de conexión ODBC
Antes de pasar a los detalles de este envoltorio, se deben tener unos conocimientos básicos acerca de como se identifica una fuente de datos ODBC. Primero de todo, un gestor de drivers ODBC ofrece dos caminos para realizar la configuración de un conjunto de parámetros:
- DSN (DataSource Name): una fuente de datos que puede escogerse o bien para el sistema o para un usuario, identificado por un único nombre. Los DSN se pueden configurar utilizando el administrador de fuente de datos ODBC o bien editando manualmente el fichero (o registro)
odbc.ini
. - Fichero DSN: un fichero que contiene parámetros de conexión. Un administrador de fuente de datos ODBC permite habitualmente crear un fichero DSN desde el entorno gráfico de usuario (GUI).
Los parámetros en un DSN o fichero DSN se pueden combinar siempre con parámetros adicionales en la cadena de conexión, por ejemplo para especificar una contraseña.
La especificación ODBC define unos cuantos parámetros que pueden utilizarse en la cadena de conexión:
- Dos parámetros especiales,
DSN
yFILEDSN
, permiten seleccionar un conjunto de parámetros predefinidos, tal como se describe arriba. - El
DRIVER
especifica que driver ODBC driver utilizar. Obviamente este es un parámetro muy importante. - Los parámetros
UID
yPWD
se utilizan para aportar el nombre de usuario (username) y la contraseña (password).
Todos los demás parámetros son dependientes del driver seleccionado.
Se debe revisar la documentación del driver específico para aprender más sobre los parámetros disponibles y sus nombres.
TODBCConnection properties
The following table describes the mapping to TODBCConnection
properties to ODBC connection string parameters:
Property | Type | Connection string parameter |
---|---|---|
Driver |
string |
DRIVER
|
DatabaseName |
string |
DSN , not to something like DATABASENAME , which is not part of the ODBC standard
|
FileDSN |
string |
FILEDSN
|
Password |
string |
PWD
|
UserName |
string |
UID
|
HostName |
string |
none; there is no corresponding parameter in the ODBC standard |
Params |
TStrings |
Use this to specify custom parameters. Each item must be of the form NAME=VALUE .
|
Note that TODBCConnection
will take care of escaping parameter values in the connection string (when required).
The LoginPrompt
boolean property is not implemented yet.
It would require finding the correct window handle, so a driver can show a GUI dialog to specify parameters.
Note that this is not controlled by the connection string, but rather by the last parameter to the ODBC API function SQLDriverConnect
.
Examples
In this section, examples are given of connecting to certain DBMSs using their specific ODBC drivers. The syntax used in the examples is as in *.lfm files. It should be straight-forward to interpret them.
Connecting to MySQL
For a reference of supported parameters by the MyODBC driver, see [1].
The driver name differs a bit depending on the platform and MyODBC version; examples are:
Driver = 'MySQL' (Unix) Driver = 'MySQL ODBC 3.51 Driver' (Windows) Driver = 'MySQL Connector/ODBC v5' (Windows)
Other parameters:
UserName = 'myUsername' Password = 'myPassword' Params.Strings = ( 'SERVER=example.com', 'PORT=3306', 'DATABASE=myDatabase' )
Connecting to MS Access
On Windows, you can use
Driver = 'Microsoft Access Driver (*.mdb)' Params.Strings = ( 'DBQ=C:\path\to\my\database.mdb' )
Note: The MS Access ODBC driver seems not to support the SQLPrimaryKeys
API function, hence UpdateIndexDefs
will fail.
Currently, you must set SQLQuery.ReadOnly:=true;
to avoid an exception until code has been added that tests for the availability of the function in the driver.
Depurando ODBC
Existen varias facilidades en ODBC que ayudan en el depurado de una aplicación ODBC.
Mensajes de error
Cada llamada a la API ODBC retorna un ćodigo de éxito; si se produce un error esto permite recabar más información realizando llamadas a SQLGetDiagRec
. (En aras a la exhaustividad los campos están también disponibles cuando una llamada a la API retorna SQL_SUCCES_WITH_INFO
.)
TODBCConnection
chequea el código retornado por cada llamada ODBC y construye una EODBCException
.
El mensaje
de esta excepción consta de:
- Un mensaje identificando que esta haciendo
TODBCConnection
cuando se produce el error. - El código retornado por la llamada a la API ODBC (e.g.
SQL_ERROR
). - Un número de campos de diagnóstico (obtenidos utilizando
SQLGetDiagRec
); cada campo consta de tres campos:- Un código de error de 5 caracteres identificando el error.
- Un 'código nativo de error'.
- Un mensaje descriptivo del error.
Nota: si se obtiene un error del tipo 'Function sequence error' en la sección de finalización de la unidad ODBCConn
, entonces probablemente consista en que no se han limpiado apropiadamente todas las consultas (queries) y conexiones (connections).
Seguimiento o rastreo
La mayoría de los gestores de ODBC tienen una opción de seguimiento en la cual se genera un log de todas las llamadas a la API ODBC. Esto puede ser muy útil para el depurado de una aplicación ODBC. El interface gráfico de usuario (GUI) del administrador de bases de datos ODBC tanto en entornos Windows como UNIX tienen una solapa donde se puede configurar la opción de seguimiento. Most ODBC managers have a tracing option in which all ODBC API calls are logged to a trace log. Por supuesto el log que genera es sobre todo útil para diseñadores que están familiarizados con la API ODBC, pero puede ayudar a identificar un problema puntual cuando es necesario también por parte de los usuarios. Además dicho log biene muy bien para enviarse como fichero anexo, como por ejemplo para dar más información al desarrollador de la aplicación cuando un usuario obtiene un error que no puede solucionar, pasando a formar parte de su listado de seguimiento de errores o bien para solicitar ayuda a terceros que de esta forma cuentan con más información para dar una posible solución más pormenorizada.