Envolviendo la API de Firebird/Interbase

CoNaIISI 2013 UTN FRC

Mg. Guillermo Cherencio

¿Qué es Firebird?

http://www.firebirdsql.org Base de Datos Relacional Open Source Deriva de Interbase (Borland/Inprise) PL/SQL (funciones, stored procedures,

triggers, etc) Windows / Linux Herramientas

Instalación Firebird Artículo en http://www.grch.com.ar

http://www.grch.com.ar/docs/bd/tutorial/firebird/instalacion.firebird.2.5.pdf

En Debian:

$ aptitude install firebird2.5-super

$ dpkg-reconfigure firebird2.5-super Activar Servidor Usuario administrador: sysdba/masterkey Rol administrador: sysdb

¿Cómo uso Firebird?

C++ librería IBPP Java driver JDBC/JCA Jaybird PHP php_interbase.dll / php_interbase.so Python driver FDB

. . . C solo API C Firebird disponible !!

¿Por qué no usar API C?

Complejidad: Dificultad, Curva de Aprendizaje, Manual 442 pag., tipos de datos, estructuras poco abstractas, etc.

Clasificación de queries en 4 categorías Portabilidad Aislación SGBD

. . .

Solución: Envolver API

Proyecto sourceforge: libfb

http://sourceforge.net/projects/libfb/ Incluye libcgi +Abstracción +Aislación +Facilidad de uso +Tipos de datos simples LGPL

¿Cómo utilizar libfb?

Descargar (libfb.zip): http://sourceforge.net/projects/libfb/

Descomprimir libfb.zip:

$ unzip libfb.zip Compilar:

$ make

¿Cómo utilizar libfb? (II)

Archivo de libreria estática:

libfb.a Archivo de libreria dinámica:

libfb.so Archivo de cabecera:

libfb.h

¿Cómo utilizar libfb? (III)

Ejemplos de código:

/libfb/examples/*.c Base de Datos Firebird 2.5 de ejemplo:

/libfb/examples/isft.fdb Documentación html:

/libfb/doc/html/index.html Documentación latex:

/libfb/doc/latex

¿Cómo utilizar libfb? (IV)

Compilar ejemplo de libfb/examples:

$ gcc -Wall -o fbquery1 -I <di> -L <dl> -lfb fbquery1.c

<di> directorio en donde se encuentra libfb.h <dl> directorio en donde se encuentra libfb.a

Instalar BD Ejemplo

Usando cuenta root En carpeta de descarga libfb.zip:

$ cp libfb/examples/isft.fdb /var/lib/firebird/2.5/data

$ chown firebird:firebird /var/lib/firebird/2.5/data/isft.fdb

Arrancar Servidor Firebird sql (start/stop):

$ /etc/init.d/firebird2.5-super start

Instalar BD Ejemplo

Usando cuenta root En carpeta de descarga libfb.zip:

$ cp libfb/examples/isft.fdb /var/lib/firebird/2.5/data

$ chown firebird:firebird /var/lib/firebird/2.5/data/isft.fdb

Arrancar Servidor Firebird sql (start/stop):

$ /etc/init.d/firebird2.5-super start

Ejecutar Ejemplos

Con usuario no root Utilizan BD isft.fdb Habiendo compilado en carpeta

libfb/examples:

$ ./fbquery1 Salida por consola

Conexión/Desconexión

fb_db_info dbinfo;

fb_pre_connect(&dbinfo, "localhost:/.../x.fdb", “sysdba”, "masterkey", "sysdb");

if (fb_do_connect(&dbinfo)) {

// se conecto ok!

// ****SU CONSULTA AQUI****

fb_do_disconnect(&dbinfo);

}

Consultas en libfb

SQL No SQL (nombre tabla/view/select procedure) Función callback y eventos para mayor control Resultados como lista doblemente enlazada Nodo = tupla Nodo con arreglo de punteros a los valores de

cada campo El usuario no requiere usar punteros

Ejemplo Consulta No SQL (I)

query *myquery;

char *squery = "Mitabla";

if ( (myquery=fb_do_single_query(&dbinfo, squery)) != NULL ) {

printf("Recupero %d filas\n",myquery->rows);

rquery *q = myquery->top;

// ***AQUI RECUPERO TUPLAS***

fb_free(myquery);

}

Ejemplo Recupero de tuplas (I)

...

rquery *q;

for(q = myquery->top;q;q=q->next)

printf("[%s][%s]\n",

fb_get_col(myquery,q,0),

fb_get_col(myquery,q,1));

...

Ejemplo Recupero de tuplas (II)

...

rquery *q;

for(q = myquery->top;q;q=q->next)

printf("[%s][%s]\n",

fb_get_col_byname(myquery,q,”codigo”),

fb_get_col_byname(myquery,q,”descr”));

...

Ejemplo Consulta SQL (I)

query myquery;

fb_init(&myquery);

if ( fb_do_query(&dbinfo,1,"SELECT ...",

OnDoGenericQuery,&myquery) ) {

// ***AQUI RECUPERO TUPLAS***

fb_free(&myquery);

}

Ejemplo Consulta SQL (II)

query *myquery;

char *squery = "SELECT ...";

if ( (myquery = fb_do_single_query(&dbinfo, squery)) != NULL ) {

// ***AQUI RECUPERO TUPLAS***

fb_free(myquery);

}

Ejemplo Ejecuto Procedure (I)

char *squery = "EXECUTE PROCEDURE ...”;

query myquery;

fb_init(&myquery);

if ( fb_do_query(&dbinfo, 1, squery, onDoGenericQuery, &myquery) ) {

// ***PROC EJECUTADO OK!!***

fb_free(&myquery);

} else {

// ***ERROR EN EJECUCION PROC !!***

}

Ejemplo Ejecuto Procedure (II)

char *squery = "DELETE FROM ...”;

query myquery;

fb_init(&myquery);

if ( fb_do_cmd(&dbinfo, squery) ) {

// ***PROC EJECUTADO OK!!***

fb_free(&myquery);

} else {

// ***ERROR EN EJECUCION PROC !!***

}

Conexión, Consulta, etc (I)

char *sql = "TBL_PLANE";

query *myquery;

if ((myquery = fb_do_connect_squery("localhost:/var/...",

"sysdba", "masterkey", "sysdb", sql)) != NULL) {

// ***AQUI RECUPERO TUPLAS***

fb_free(myquery);

} else {

// ***ERROR !!***

}

Otras “Features” (I)

Consultas parametrizadas ( select .. legajo = ?)

Soporte para arreglos, blob, etc. Uso de función de callback provista por

librería (onDoGenericQuery) Uso de función de callback provista por el

usuario Manejo Errores SQL

Otras “Features” (II)

Exportación de queries a archivo Uso de funciones para recupero de tuplas sin

utilizar punteros Info de Base de Datos / Servidor Soporte para eventos Firebird Log de errores Activación/Desactivación de mensajes de

error

PREGUNTAS ¿?

MUCHAS GRACIAS POR SU ATENCION!!

Mg. Guillermo Cherencio

http://www.grch.com.ar

UTN FRD – UNLu – ISFT 189