Envolviendo la API de Firebird/Interbase CoNaIISI 2013 UTN FRC Mg. Guillermo Cherencio

¿Qué es Firebird? 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 stalacion.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 Incluye libcgi +Abstracción +Aislación +Facilidad de uso +Tipos de datos simples LGPL

¿Cómo utilizar libfb? Descargar (libfb.zip): 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 -L -lfb fbquery1.c directorio en donde se encuentra libfb.h 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 UTN FRD – UNLu – ISFT 189