crnickl-jdbc : JDBC Implementation of the CrNiCKL Database 

Copyright 2012-2013 Hauser Olsson GmbH.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

This is a JDBC implementation of the CrNiCKL (chronicle) database. CrNiCKL (pronounced "chronicle") is a database for time series written in Java running on top of SQL and NoSQL systems.

Distribution

Starting with version 1.1.2, the distribution consists of a binary JAR with compiled classes, of a javadoc JAR and of a source JAR. The current version is 1.1.3:

crnickl-jdbc-1.1.3.jar
crnickl-jdbc-1.1.3-javadoc.jar
crnickl-jdbc-1.1.3-sources.jar

For versions earlier than 1.1.2, there is no javadoc JAR. For versions earlier than 1.1.1, the suffix of the source JAR is .source instead of -sources.

For Maven users

Starting with version 1.1.2, the software is available from the Maven central repository. To use version x.y.z, insert the following dependency into your pom.xml file:

<dependency>
  <groupId>ch.agent</groupId>
  <artifactId>crnickl-jdbc</artifactId>
  <version>x.y.z</version>
  <scope>compile</scope>
</dependency>

Building the software

The recommended way is to use git for accessing the source and maven for building. The procedure is easy, as maven takes care of locating and downloading dependencies:

$ git clone https://github.com/jpvetterli/crnickl-jdbc.git
$ cd crnickl-jdbc
$ mvn install

This builds and installs the distribution JARs in your local maven repository. They can also be found in the target directory.

When building the software by other means, the following dependencies must be addressed:

Versions numbers can be found in the POM file included in the binary JAR:

/META-INF/maven/ch.agent/crnickl-jdbc/pom.xml

Unit tests

The following command runs unit tests:

$ mvn -Dmaven.test.skip=false test

When building the software without maven, the following additional dependencies must be addressed to compile unit tests:

Browsing the source code

The source is available on GitHub at http://github.com/jpvetterli/crnickl-jdbc.git.

Finding more information

More information on CrNiCKL is available at http://agent.ch/timeseries/crnickl/.

Updated: 2013-01-16/jpv