Mercurial > hg > monetdb-perl

comparison DBD/README @ 0:cedccb7e0143

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
-1:000000000000 0:cedccb7e0143
1 NAME
2
3 DBD::monetdb - MonetDB Driver for DBI
4
5 SYNOPSIS
6
7 use DBI();
8
9 my $dbh = DBI->connect('dbi:monetdb:');
10
11 my $sth = $dbh->prepare('SELECT * FROM env() env');
12 $sth->execute;
13 $sth->dump_results;
14
15 DESCRIPTION
16
17 DBD::monetdb is a Pure Perl client interface for the MonetDB Database Server.
18 It requires MonetDB::CLI (and one of its implementations).
19
20 PREREQUISITES
21
22 DBI
23 MonetDB::CLI
24
25 MonetDB (http://www.monetdb.org/)
26
27 INSTALLATION
28
29 To install this module type the following:
30
31 perl Makefile.PL
32 make
33 make test
34 make install
35
36 You need to use the correct make command. That may be nmake or dmake,
37 depending on which development environment you are using.
38
39 TESTING
40
41 The supplied tests will connect to the database using the DBI
42 environment variables, e.g.:
43
44 set DBI_DSN=dbi:monetdb:
45 set DBI_DSN=dbi:monetdb:host=localhost
46
47 Don't specify port and language (if possible). The server should
48 listen on the default ports for sql and mapi.
49
50 If the server doesn't accept the default username/password, then
51 set the relevant environment variables, e.g.:
52
53 set DBI_USER=test
54 set DBI_PASS=secret
55
56 Make sure libMapi is in your library search path (depending on the
57 MonetDB::CLI implementations in use).
58
59 The tests will create tables with the name (or prefix) 'perl_dbd_test'
60 in the current schema.
61 Check for the unlikly case that this will cause unwanted side effects!
62
63 To run the tests, type
64
65 make test
66
67 If all tests pass, you'll see something like:
68
69 t/01base.....ok
70 ...
71 t/75mil......ok
72 All tests successful.
73 Files=22, Tests=412, 10 wallclock secs ...
74
75 It is possible to run individual test scripts, e.g.:
76
77 perl -w -Mblib t/02cxn.t
78
79 BTW: You can test the ODBC driver when setting the DSN appropriately, e.g.:
80
81 set DBI_DSN=dbi:ODBC:driver=MonetDB ODBC Driver
82
83 AUTHORS
84
85 Martin Kersten <Martin.Kersten@cwi.nlE> implemented the initial Mapi
86 based version of the driver (monet.pm).
87 Arjan Scherpenisse <acscherp@science.uva.nlE> renamed this module to
88 monetdbPP.pm and derived the new MapiLib based version (monetdb.pm).
89 Current maintainer is Steffen Goeldner <sgoeldner@cpan.org>.
90
91 COPYRIGHT AND LICENCE
92
93 This Source Code Form is subject to the terms of the Mozilla Public
94 License, v. 2.0. If a copy of the MPL was not distributed with this
95 file, You can obtain one at http://mozilla.org/MPL/2.0/.
96
97 Copyright 1997 - July 2008 CWI, August 2008 - 2016 MonetDB B.V.