treilly-nuodb/go-nuodb

NuoDB driver for Go database/sql interface

go-nuodb

NuoDB driver for Go database/sql interface.

It wraps the libNuoRemote.so C++ API with a custom C API and then uses Cgo for calling it.

Tested with Go 1.1beta2 and NuoDB 1.0.2-142-902dc7c on x86_64 CentOS 6.4.

Setup

Installation requires NuoDB in /opt/nuodb and properly set $GOPATH.

$ go get -d github.com/tilinna/go-nuodb
$ make -C `go env GOPATH`/src/github.com/tilinna/go-nuodb
$ go install github.com/tilinna/go-nuodb

Install the libcnuodb.so to some of the common LIB paths (this is not needed to run the package tests):

$ sudo install `go env GOPATH`/src/github.com/tilinna/go-nuodb/libcnuodb.so /usr/lib64/libcnuodb.so

Usage

package main

import (
  "database/sql"
	_ "github.com/tilinna/go-nuodb"
)

func main() {
	// func Open(driverName, dataSourceName string) (*DB, error)
	db, err := sql.Open("nuodb", "nuodb://robinh:crossbow@localhost:48004/tests?schema=abcd&timezone=UTC")
}

dataSourceName url string

Mandatory:

nuodb:// username : password @ broker_address / database

Optional:

• schema=default schema
• timezone=default timezone

Test

1. Configure NuoDB

$ java -jar /opt/nuodb/jar/nuoagent.jar --broker --domain go-nuodb --password archer &
$ /opt/nuodb/bin/nuodb --allow-non-durable --database tests --initialize --password archer --dba-user robinh --dba-password crossbow &

2. Run the tests

$ go test -ldflags="-r ." github.com/tilinna/go-nuodb