Copyright (C) <2012>

All rights reserved. This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

http://hpccsystems.com

JDBC driver for HPCC platform

To build for Linux:

1. Check out sources (for example, to directory ~/hpcc-jdbc)
2. Create a build directory
3. cd to the build directory
4. To create makefiles to build native release version for local machine, run cmake ~/hpcc-jdbc
5. To build the makefiles just created above, run make
6. Jar file will be created in /src/com/hpccsystems/jdbcdriver/hpccsystems-jdbcdriver-MAJOR.MINOR.POINT.jar

A Test version can be built by augmenting the cmake command with the "MAKE_TEST_PACKAGE" flag turned on.

1. From build directory, run cmake -DMAKE_TEST_PACKAGE=ON ~/hpcc-jdbc
2. Jar file will be created in /src/com/hpccsystems/jdbcdriver/hpccsystems-jdbcdriver-MAJOR.MINOR.POINT-TEST.jar
3. Run test: java -cp org.hpccsystems.jdbcdriver.tests.HPCCDriverTest <param==value>... If no parameters are passed in, a "full test" will execute (values in code should be altered to match your environment).

To build using Maven:

1. Check out sources (same as above)
2. cd to the project root directory
3. Run mvn install to execute the build using Maven (includes running "standalone" unit tests)
4. Jar file will be created in <project_root>/target/jdbcdriver-MAJOR.MINOR.POINT[-SNAPSHOT].jar
5. TO DO - create a Maven profile to run tests requiring a running HPCC system.

NOTE: When updating the project version in either version.cmake (cmake) or pom.xml (Maven) please make sure to update the version in both locations.

To Run Test Package:

1. Two files are required: a) configuration file- Target HPCC system connection information b) Test script file- Contains SQL test cases Test cases are specified using following format: = ["["ExpectSuccess;MinResultExpected[;DataFile]"]"] Where: ExpectedSuccess = true|false - true signifies that the test case should succeed, false it should fail. MinResultExpected = int - the minimum number of records expected if successful. DataFile = platform specific path - Path to data file used to populate prepared statements. Examples: For Linux: Test1=[true;1;/home/vagrant/mycsvfile.csv] For Windows: Test1=[true;1;C:\Users\mycsvfile.csv] See Example: src/SampleTestScripts/ 2)To execute "Regular Statements": Test1=[true;1]< sqlstatements>

2. Execute HPCCJDBCDriverTest with the following parameters: Config=/path/to/configfile.config ReporthPath=path/to/reportfiles/ SqlScript=path/to/testcases.txt