NAME

MonetDB::CLI - MonetDB Call Level Interface

SYNOPSIS

use MonetDB::CLI();

my $cxn = MonetDB::CLI->connect( $host, $port, $user, $pass, $lang );

my $req = $cxn->query('select * from env'); while ( my $cnt = $req->fetch ) {
print $req->field( $_ ) for 0 .. $cnt-1; }

DESCRIPTION

MonetDB::CLI is a call level interface for MonetDB, somewhat similar to SQL/CLI, ODBC, JDBC or DBI.

Note: In its current incarnation, this interface resembles the MonetDB Application Programming Interface.
In the future, MAPI will be replaced by the MonetDB/Five Communication Layer (MCL).
It is not guaranteed that this call level interface stays the same!

PREREQUISITES

MonetDB::CLI::* (implementation modules)

MonetDB (http://monetdb.cwi.nl)

INSTALLATION

To install this module type the following:

perl Makefile.PL
make
make test
make install

You need to use the correct make command. That may be nmake or dmake, depending on which development environment you are using.

TESTING

The supplied tests will connect to the database using some environment variables, e.g.:

set MONETDB_HOST=myhost
set MONETDB_PORT=4711

Don't specify port and language (if possible). The server should listen on the default ports for sql and mapi.

If the server doesn't accept the default username/password, then set the relevant environment variables, e.g.:

set MONETDB_USER=test
set MONETDB_PASS=secret

Make sure libMapi is in your library search path (depending on the MonetDB::CLI implementations in use).

AUTHORS

Steffen Goeldner <sgoeldner@cpan.org>.

COPYRIGHT AND LICENCE

The contents of this file are subject to the MonetDB Public License Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://monetdb.cwi.nl/Legal/MonetDBLicense-1.1.html

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The Original Code is the MonetDB Database System.

The Initial Developer of the Original Code is CWI. Portions created by CWI are Copyright (C) 1997-2006 CWI. All Rights Reserved.