Biblioteca API de MiniSQL

MiniSQL o mSQL es una base de datos de acceso rápido y almacenamiento simple con requerimientos mínimos de memoria, lo que la hace adecuada para publicar información en el Web. Como su nombre lo indica ofrece un subconjunto de sentencias SQL como interfaz de consulta.

Se ha diseñado para funcionar sobre plataformas Unix, y se ofrece gratuitamente en Internet. El paquete de distribución incluye:

1. Motor("Engine") de la base de datos.
2. Programa interactivo para administración de la base de datos.
3. Visor de Esquemas.
4. Bibliotecas API para Lenguaje C.

Las bibliotecas API proveen una serie de funciones que permiten establecer comunicación con una base de datos MiniSQL desde un programa en Lenguaje C, en el cual se pueden incrustar sentencias SQL.

La razón principal por la cual las bibliotecas API se han diseñado para Lenguaje C, es porque la mayoría de sistemas Unix traen consigo un compilador para este lenguaje de programación.

 Con un escrito C es posible construir una interfaz entre el Web y cualquier otro tipo de aplicación; API facilita esta tarea ya que permite interactuar con una base de datos MiniSQL a través de una serie de bibliotecas previamente elaboradas. Consecuentemente, es necesario poseer conocimientos básicos de programación C para construir una interfaz haciendo uso de API.

Características

Tanto el API como el motor de la base de datos MiniSQL se han diseñado para trabajar en un ambiente Cliente/Servidor con una red TCP/IP.

El "motor" de la base de datos actúa como servicio (daemon), que está a la espera de solicitudes de conexión por parte de diversos clientes entre ellos los programas C que empleen API.

Las principales funciones que API ofrece son:

• msqlConnect(): Establece una conexión con el motor de MiniSQL.
• msqlSelectDB(): Elige la base de datos.
• msqlQuery(): Envía una sentencia SQL a la base de datos seleccionada.
• msqlStoreResult(): Se recupera la información retornada desde la base de datos a partir de una consulta SELECT.
• msqlFreeResult(): Libera el manejador de una sentencia SELECT.
• msqlFetchRow(): Obtiene una fila del conjunto resultante de una sentencia SELECT.
• msqlDataSeek(): Mueve el cursor de una sentencia SQL hacia la próxima fila de resultado.
• msqlNumRows(): Obtiene el número de filas o registros obtenidos.
• msqlClose(): Cierra la conexión establecida con el motor de MiniSQL.

Para efectos de integración con el Web, un escrito C que haga uso de API debe seguir el siguiente algoritmo:

1. Incluir archivo de cabecera para emplear bibliotecas API.
2. Descodificar entrada proveniente de la forma.
3. Imprimir Tipo de Contenido a desplegar en el Browser.
4. Establecer conexión con servicio de MiniSQL.
5. Construir dinámicamente sentencia SQL en base a datos ingresados por el usuario en el formulario.
6. Ejecutar sentencia SQL.
7. Si la sentencia SQL incluye el comando SELECT, se debe manipular la información proveniente de la base de datos.
8. Desplegar resultados en formato adecuado.

Con API, el procedimiento para comunicarse con una base de datos MiniSQL a través del Web da inicio cuando un usuario especifica determinados criterios en su browser, los cuales en el escrito C se transforman en sentencias SQL que son enviadas, a través de API, al servicio de MiniSQL para obtener los resultados deseados desde la base de datos. Esto se visualiza en la Fig. 4.

Figura 4. Arquitectura del funcionamiento de Bibliotecas API para MiniSQL.

Acceso a escritos C

Un programa C que emplee API y además actúe como interfaz entre el Web y mSQL, es referido como cualquier programa CGI, es decir:

http://<servidor_web>/<dir-cgi>/programa

<servidor_web>: Es la dirección IP o alias del Servidor Web.

<dir-cgi>: Ruta del directorio de escritos CGI del Servidor Web.

programa: Programa ejecutable de escrito C.

Requerimientos del Sistema

• Cualquier procesador que soporte Sistemas Unix.
• 8 Mb en memoria RAM(mínimo).
• 3 Mb espacio en disco duro.
• Compilador de Lenguaje C para Unix.
• Servidor Web que soporte CGI.

Compatibilidad

Sistemas Operativos

La mayoría de Sistemas Unix:

• Sun OS 4.1.1
• Solaris 2.3
• Ultrix 4.3
• Linux
• OSF/1
• HP-UX
• NeXT
• SCO
• Sequent, etc.

Bases de Datos

MiniSQL.

Servidores Web

Todo Servidor Web que soporte CGI: Apache, NCSA CERN, etc.

Disponibilidad

La base de datos MiniSQL y su correspondiente API para C, se ofrecen gratuitamente en http://Hughes.com.au/software/msql1/.

Fue desarrollada por Hughes Technologies con el objetivo de difundirla, por lo cual exige los más mínimos requerimientos de todo sistema UNIX. La página Web donde se encuentra toda la información sobre MiniSQL es http://Hughes.com.au.

El paquete de distribución incluye:

• Motor("Engine") de la base de datos.
• Programa interactivo para administración de la base de datos.
• Visor de Esquemas.
• Bibliotecas API para lenguaje C.
• Documentación y Ejemplos.

Contactos

David J. Hughes, Hughes Technologies Pty Ltd. (Australia)

Web: http://Hughes.com.au/

Ftp: ftp://ftp.Hughes.com.au

Email: bambi@Hughes.edu.au

Sumario de la Interfaz