Overview

LuaSQL is a simple interface from Lua to a DBMS. It enables a Lua program to:

Connect to ODBC, Oracle, MySQL and PostgreSQL databases;
Execute arbitrary SQL statements;
Retrieve results in a row-by-row cursor fashion.

Current version

LuaSQL version 2.0 beta (for Lua 5.0) is now available for download! The PostgreSQL driver has been tested on Linux and MacOS X and is compatible with PostgreSQL 7.x. The ODBC driver has been tested on Windows (SQLServer and Microsoft Access drivers). The MySQL driver has been tested on Linux and is compatible with version 4.1. The Oracle driver has been tested on Windows and is compatible with OCI 8 API.

Download

LuaSQL can be downloaded in source code from the following links:

luasql-2.0b.tar.gz
luasql-2.0b.zip

What's new

Version 2.0 has some design modifications and implementation improvements

New fetch method: more eficient and more flexible
New setautocommit method
Lua 5.0 compatible
Dynamically loadable or statically linked
New drivers for Oracle and MySQL databases

Installation

LuaSQL is distributed as a set of C source files and a Lua script that loads the dynamic library (if the library is not statically linked to the application). Each driver should be compiled together with luasql.c file (it's so small that we don't make another library of it) to generate a library. This library should be linked to the application (the initialization function is luasql_libopen_drivername and it's a Lua open-library compatible function) or dynamically loaded. In this case, LuaSQL provide a Lua script template that must be edited to suit the installation: the text LIB_NAME (in the line local libname = "LIB_NAME") should be substituted by the complete path of the dynamic library. The distribution contains a Makefile that has lines to do this job, using sed, according to each driver and platform.

History

LuaSQL 2.0

Version 2.0 was redesigned by Roberto Ierusalimschy, André Carregal and Tomás Guisasola behind the Kepler Project. The implementation is compatible with Lua 5.0 and was coded by Tomás Guisasola, Eduardo Quintão and Leonardo Godinho.

LuaSQL 1.0

LuaSQL was designed by Pedro Miller Rabinovitch and Roberto Ierusalimschy. The first implementation was compatible with Lua 4.0a. Many modifications were made but not distributed by Diego Nehab (ODBC), Carlos Cassino, Tomás Guisasola and Eduardo Quintão (PostgreSQL).

LuaSQL development was sponsored by Fábrica Digital.

overview · current version · download · what's new · installation · manual · license · history

Last modified on Fri Sep 12 18:28:04 BRT 2003

Contents