This repo is frozen, all future modifications will happen in
This is for
gopkg.in versioning, so you can use
for imports! Reasons for this change:
- Nicer import path,
- Versioned imports - braking changes will go into a new branch,
appearing as a new version:
- I've created a new GitHub organization, and the import path no longer contains my name, so the transition of ownership may be easier in the future, if someone with better skills, more time appear to maintain goracle.
goracle/oracle is a package is a translated version of cx_Oracle (by Anthony Tuininga) converted from C (Python module) to Go.
CHAR, VARCHAR2, NUMBER, DATETIME, INTERVAL simple AND array bind/define. CURSOR, CLOB, BLOB
Cannot input PLS_INTEGER, only INTEGER (this is OK, as PLS_INTEGER is a PL/SQL type, not an SQL one).
Not working ATM
Nothing I know of.
Not tested (yet)
LONG, LONG RAW, BFILE
Usage and intentions
I haven't had the pressure to force me understanding database/sql - yet. I've ported cx_Oracle because I'm using Python with Oracle most of, and no featureful OCI binding has existed for Go that time. Thus I'm fluent with cx_Oracle and that means goracle/oracle.
BUT I'd start and stick with database/sql as long as it is possible
- my impression is that Go's standard library is very high quality.
Of course if you need to use Oracle's non-standard features (out bind variables, returning cursors, sending and receiving PL/SQL associative tables...) then goracle/oracle is the straight choice.
For simple (connection, Ping, Select) usage, and testing connection (DSN can be tricky), see conntest.
With b0219c8f we can reuse statements with different number of bind variables!
You can build the test executable (for debugging with gdb, for example) with
go test -c
You can build a tracing version with the "trace" build tag (go build -tags=trace) that will print out everything before calling OCI C functions.
See c for example.
For environment variables on POSIXy systems, you can try . ./env:
go get github.com/tgulacsi/goracle cd $GOPATH/src/github.com/tgulacsi/goracle . ./env go install ./godrv
AND you have set proper environment variables:
export CGO_CFLAGS=-I$(dirname $(find $ORACLE_HOME -type f -name oci.h)) export CGO_LDFLAGS=-L$(dirname $(find $ORACLE_HOME -type f -name libclntsh.so\*)) go get github.com/tgulacsi/goracle/godrv
For example, with my XE:
ORACLE_HOME=/u01/app/oracle/product/11.2.0/xe CGO_CFLAGS=-I/u01/app/oracle/product/11.2.0/xe/rdbms/public CGO_LDFLAGS=-L/u01/app/oracle/product/11.2.0/xe/lib
If your git is too old, gopkg.in may present too much hops. You can do
mkdir -p $GOPATH/src/gopkg.in/ && cd $GOPATH/src/gopkg.in && \ git checkout https://github.com/go-errgo/errgo.git errgo.v1 && \ cd errgo.v1 && git checkout -f v1 mkdir -p $GOPATH/src/gopkg.in/ && cd $GOPATH/src/gopkg.in && \ git checkout https://github.com/inconshreveable/log15.git log15.v2 && \ cd log15.v2 && git checkout -f v2
Mac OS X
For Mac OS X I did the following:
You have to get both the Instant Client Package Basic and the Instant Client Package SDK (for the header files).
Then set the env vars as this (note the SDK here was unpacked into the base directory of the Basic package)
export CGO_CFLAGS=-I/Users/dfils/src/oracle/instantclient_11_2/sdk/include export CGO_LDFLAGS=-L/Users/dfils/src/oracle/instantclient_11_2 export DYLD_LIBRARY_PATH=/Users/dfils/src/oracle/instantclient_11_2:$DYLD_LIBRARY_PATH
Perhaps this export would work too, but I did not try it. I understand this is another way to do this
The DYLD vars are needed to run the binary, not to compile it.
Windows 7 64-bit
Thanks to Johann Kropf!
- Oracle InstantClient Basic 64bit
- Oracle InstantClient SDK 64bit
On Windows the library
libclntsh.so does not exist.
So change the line in all the source files of
#cgo LDFLAGS: -lclntsh
#cgo LDFLAGS: -loci
Create the liboci.a file from the oci.dll by doing
- Install Msys from Mingw if not already done
http://sourceforge.net/p/mingw-w64/code/HEAD/tree/stable/v3.x/by "Download snapshot"
- Extract the zip-file and copy the folder
gendefto your home-directory in Msys
- go to the folder
./make- gendef.exe will be created
oci.defwill be generated
dlltool -D oci.dll -d oci.def -l liboci.a-
liboci.awill be generated
copy liboci.a C:\Oracle64Instant\sdk\lib
Build oracle with
You can build now your program which imports "github.com/tgulacsi/goracle/oracle"!