aerospike-client-go alternatives and similar packages
Based on the "NoSQL Databases" category.
Alternatively, view aerospike-client-go alternatives based on common mentions on social networks and blogs.
-
qmgo
Qmgo - The Go driver for MongoDB. It‘s based on official mongo-go-driver but easier to use like Mgo. -
mgm
Mongo Go Models (mgm) is a fast and simple MongoDB ODM for Go (based on official Mongo Go Driver) -
go-rejson
Golang client for redislabs' ReJSON module with support for multilple redis clients (redigo, go-redis) -
godscache
An unofficial Google Cloud Platform Go Datastore wrapper that adds caching using memcached. For App Engine Flexible, Compute Engine, Kubernetes Engine, and more.
CodeRabbit: AI Code Reviews for Developers
Do you think we are missing an alternative of aerospike-client-go or a related project?
README
Aerospike Go Client
IMPORTANT NOTE
This is an old version the Aerospike Go Client, which is v4.x.x. The newest version v6 has migrated to go modules,
which required us to put it in the v6
branch here.
All the latest changes to the library are applied in that branch, documented in the CHANGELOG.
Official Aerospike Client library for Go.
This library is compatible with Go 1.9+ and supports the following operating systems: Linux, Mac OS X (Windows builds are possible, but untested).
Up-to-date documentation is available in the .
You can refer to the test files for idiomatic use cases.
Please refer to [CHANGELOG.md
](CHANGELOG.md) for release notes, or if you encounter breaking changes.
- Usage
- Prerequisites
- Installation
- Tweaking Performance
- Benchmarks
- API Documentation
- Google App Engine
- Reflection
- Tests
- Examples
Usage
The following is a very simple example of CRUD operations in an Aerospike database.
package main
import (
"fmt"
aero "github.com/aerospike/aerospike-client-go"
)
// This is only for this example.
// Please handle errors properly.
func panicOnError(err error) {
if err != nil {
panic(err)
}
}
func main() {
// define a client to connect to
client, err := aero.NewClient("127.0.0.1", 3000)
panicOnError(err)
key, err := aero.NewKey("test", "aerospike", "key")
panicOnError(err)
// define some bins with data
bins := aero.BinMap{
"bin1": 42,
"bin2": "An elephant is a mouse with an operating system",
"bin3": []interface{}{"Go", 2009},
}
// write the bins
err = client.Put(nil, key, bins)
panicOnError(err)
// read it back!
rec, err := client.Get(nil, key)
panicOnError(err)
// delete the key, and check if key exists
existed, err := client.Delete(nil, key)
panicOnError(err)
fmt.Printf("Record existed before delete? %v\n", existed)
}
More examples illustrating the use of the API are located in the
[examples
](examples) directory.
Details about the API are available in the [docs
](docs) directory.
Prerequisites
Go version v1.12+ is required.
To install the latest stable version of Go, visit http://golang.org/dl/
Aerospike Go client implements the wire protocol, and does not depend on the C client. It is goroutine friendly, and works asynchronously.
Supported operating systems:
- Major Linux distributions (Ubuntu, Debian, Red Hat)
- Mac OS X
- Windows (untested)
Installation
- Install Go 1.9+ and setup your environment as Documented here.
- Get the client in your
GOPATH
:go get github.com/aerospike/aerospike-client-go
- To update the client library:
go get -u github.com/aerospike/aerospike-client-go
- To update the client library:
Using gopkg.in is also supported: go get -u gopkg.in/aerospike/aerospike-client-go.v1
Some Hints:
- To run a go program directly:
go run <filename.go>
- to build:
go build -o <output> <filename.go>
- example:
go build -o benchmark tools/benchmark/benchmark.go
- example:
Performance Tweaking
We are bending all efforts to improve the client's performance. In our reference benchmarks, Go client performs almost as good as the C client.
To read about performance variables, please refer to [docs/performance.md
](docs/performance.md)
Tests
This library is packaged with a number of tests. Tests require Ginkgo and Gomega library.
Before running the tests, you need to update the dependencies:
$ go get .
To run all the test cases with race detection:
$ ginkgo -r -race
Examples
A variety of example applications are provided in the [examples
](examples) directory.
Tools
A variety of clones of original tools are provided in the [tools
](tools) directory.
They show how to use more advanced features of the library to re-implement the same functionality in a more concise way.
Benchmarks
Benchmark utility is provided in the [tools/benchmark
](tools/benchmark) directory.
See the [tools/benchmark/README.md
](tools/benchmark/README.md) for details.
API Documentation
A simple API documentation is available in the [docs
](docs/README.md) directory. The latest up-to-date docs can be found in .
Google App Engine
To build the library for App Engine, build it with the build tag app_engine
. Aggregation functionality is not available in this build.
Reflection, and Object API
To make the library both flexible and fast, we had to integrate the reflection API (methods with [Get/Put/...]Object
names) tightly in the library. In case you wanted to avoid mixing those API in your app inadvertently, you can use the build tag as_performance
to remove those APIs from the build.
License
The Aerospike Go Client is made available under the terms of the Apache License, Version 2, as stated in the file LICENSE
.
Individual files may be made available under their own specific license, all compatible with Apache License, Version 2. Please see individual files for details.
*Note that all licence references and agreements mentioned in the aerospike-client-go README section above
are relevant to that project's source code only.