Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mattn/Go-oci8
Oracle driver for Go using database/sql
https://github.com/mattn/Go-oci8
Last synced: 20 days ago
JSON representation
Oracle driver for Go using database/sql
- Host: GitHub
- URL: https://github.com/mattn/Go-oci8
- Owner: mattn
- License: mit
- Created: 2012-02-29T12:19:16.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-10-24T04:12:17.000Z (about 1 year ago)
- Last Synced: 2024-10-22T13:52:26.800Z (22 days ago)
- Language: Go
- Homepage: https://mattn.kaoriya.net/
- Size: 767 KB
- Stars: 630
- Watchers: 40
- Forks: 212
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# go-oci8
[](http://godoc.org/github.com/mattn/go-oci8)
[](https://travis-ci.org/mattn/go-oci8)
[](https://goreportcard.com/report/github.com/mattn/go-oci8)
## Description
Golang Oracle database driver conforming to the Go database/sql interface
## Installation
Install Oracle full client or Instant Client:
https://www.oracle.com/technetwork/database/database-technologies/instant-client/downloads/index.html
Install a C/C++ compiler
Install pkg-config, edit your package config file oci8.pc (examples below), then set environment variable PKG_CONFIG_PATH to oci8.pc file location
(Or can use Go tag noPkgConfig then setup environment variables CGO_CFLAGS and CGO_LDFLAGS)
Go get with Go version 1.9 or higher
```
go get github.com/mattn/go-oci8
```
Try the simple select example:
https://godoc.org/github.com/mattn/go-oci8#example-package--SqlSelect
If you have a build error it is normaly because of a misconfiguration, make sure to search close issues for help
## oci8.pc Examples
### Windows
```
prefix=/devel/target/XXXXXXXXXXXXXXXXXXXXXXXXXX
exec_prefix=${prefix}
libdir=C:/app/instantclient_12_2/sdk/oci/lib/msvc
includedir=C:/app/instantclient_12_2/sdk/include
glib_genmarshal=glib-genmarshal
gobject_query=gobject-query
glib_mkenums=glib-mkenums
Name: oci8
Description: oci8 library
Libs: -L${libdir} -loci
Cflags: -I${includedir}
Version: 12.2
```
### Linux
```
prefix=/devel/target/XXXXXXXXXXXXXXXXXXXXXXXXXX
exec_prefix=${prefix}
libdir=/usr/lib/oracle/12.2/client64/lib
includedir=/usr/include/oracle/12.2/client64
glib_genmarshal=glib-genmarshal
gobject_query=gobject-query
glib_mkenums=glib-mkenums
Name: oci8
Description: oci8 library
Libs: -L${libdir} -lclntsh
Cflags: -I${includedir}
Version: 12.2
```
### MacOs
Please install `pkg-config` with [`brew`](https://brew.sh/) if not already present.
Download the instant client and the sdk and unpack it e.g. in your
`Downloads` folder and create therein a file names `oci8.pc`.
Please replace `` with your actual username.
```
prefixdir=/Users//Downloads/instantclient_12_2/
libdir=${prefixdir}
includedir=${prefixdir}/sdk/include
Name: OCI
Description: Oracle database driver
Version: 12.2
Libs: -L${libdir} -lclntsh
Cflags: -I${includedir}
```
You also have to set these environment variables
(e.g. permanently by adding them to your `.bashrc`)
```
export LD_LIBRARY_PATH=/Users//Downloads/instantclient_12_2
export PKG_CONFIG_PATH=/Users//Downloads/instantclient_12_2
```
## SQL Examples
SQL examples can be found in the GoDoc reference:
https://godoc.org/github.com/mattn/go-oci8
And in _example:
https://github.com/mattn/go-oci8/tree/master/_example
## Author
Yasuhiro Matsumoto (a.k.a mattn)
## Special Thanks
Jamil Djadala