Mercurial > hg > monetdb-perl
diff DBD/README @ 0:cedccb7e0143
Copy of clients/perl directory without Tests from MonetDB changeset 4d2d4532228a.
author | Sjoerd Mullender <sjoerd@acm.org> |
---|---|
date | Mon, 19 Sep 2016 15:15:52 +0200 (2016-09-19) |
parents | |
children | f899cb48b4cc |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/DBD/README @@ -0,0 +1,97 @@ +NAME + + DBD::monetdb - MonetDB Driver for DBI + +SYNOPSIS + + use DBI(); + + my $dbh = DBI->connect('dbi:monetdb:'); + + my $sth = $dbh->prepare('SELECT * FROM env() env'); + $sth->execute; + $sth->dump_results; + +DESCRIPTION + + DBD::monetdb is a Pure Perl client interface for the MonetDB Database Server. + It requires MonetDB::CLI (and one of its implementations). + +PREREQUISITES + + DBI + MonetDB::CLI + + MonetDB (http://www.monetdb.org/) + +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 the DBI + environment variables, e.g.: + + set DBI_DSN=dbi:monetdb: + set DBI_DSN=dbi:monetdb:host=localhost + + 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 DBI_USER=test + set DBI_PASS=secret + + Make sure libMapi is in your library search path (depending on the + MonetDB::CLI implementations in use). + + The tests will create tables with the name (or prefix) 'perl_dbd_test' + in the current schema. + Check for the unlikly case that this will cause unwanted side effects! + + To run the tests, type + + make test + + If all tests pass, you'll see something like: + + t/01base.....ok + ... + t/75mil......ok + All tests successful. + Files=22, Tests=412, 10 wallclock secs ... + + It is possible to run individual test scripts, e.g.: + + perl -w -Mblib t/02cxn.t + + BTW: You can test the ODBC driver when setting the DSN appropriately, e.g.: + + set DBI_DSN=dbi:ODBC:driver=MonetDB ODBC Driver + +AUTHORS + + Martin Kersten <Martin.Kersten@cwi.nlE> implemented the initial Mapi + based version of the driver (monet.pm). + Arjan Scherpenisse <acscherp@science.uva.nlE> renamed this module to + monetdbPP.pm and derived the new MapiLib based version (monetdb.pm). + Current maintainer is Steffen Goeldner <sgoeldner@cpan.org>. + +COPYRIGHT AND LICENCE + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + + Copyright 1997 - July 2008 CWI, August 2008 - 2016 MonetDB B.V.