Overview

OrientGo is a Go client for the OrientDB database.

Status

OrientDB versions supported: 2.0.15 - 2.1.5

Not supported versions:

• 2.1.0 (bug in OrientDB, see #28)
• 2.1.3 (broken protocol, see #39)

Driver is no longer maintained and seeking for a new owner.

Ogonori

Original ogonori API is deprecated. Still, it's source code have been frozen in v1.0 branch. To use it, simply replace

github.com/quux00/ogonori

gopkg.in/istreamdata/orientgo.v1

Supported features:

• Mostly any SQL queries, commands and batch requests.
• Server-side scripts (via ScriptCommand or functions).
• Command results conversion to custom types via mapstructure.
• Direct CRUD operations on

  Document

  or

  BytesRecord

  objects.
• Management of databases and record clusters.
• Can be used for the golang

  database/sql

  API, with some cautions (see below).
• Only supports OrientDB 2.x series.

Not supported yet:

• OrientDB 1.x.
• Servers with cluster configuration (not tested).
• Fetch plans are temporary disabled due to internal changes.
• Transactions in Go. Transactions in JS can be used instead.
• Live queries.
• Command results streaming (#26).
• OrientDB CUSTOM type.
• ORM-like API. See Issue #6.

Caveat on using OrientGo as a database/sql API driver

WARNING: database/sql API is disabled for now.

The golang

database/sql

• When you insert a record, the Go

  database/sql

  API only allows one to return a single int64 identifier for the record, but OrientDB uses as a compound int16:int64 RID, so getting the RID of records you just inserted requires another round trip to the database to query the RID.

Also, since OrientDB transactions are not supported, the

Tx

database/sql

Development

You are welcome to initiate pull request and suggest a more user-friendly API. We will try to review them ASAP.

How to run functional tests:

1) Install Docker

2) Pull OrientDB image:

docker pull dennwc/orientdb:2.1

3)

go test -v ./...

Examples

Dial example - dialexampletest.go

LICENSE

The MIT License