Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/viant/asc
Datastore Connectivity for Aerospike for go
https://github.com/viant/asc
Last synced: about 1 month ago
JSON representation
Datastore Connectivity for Aerospike for go
- Host: GitHub
- URL: https://github.com/viant/asc
- Owner: viant
- License: apache-2.0
- Created: 2016-06-13T20:22:31.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T12:49:02.000Z (5 months ago)
- Last Synced: 2024-08-09T13:54:57.041Z (5 months ago)
- Language: Go
- Homepage:
- Size: 80.1 KB
- Stars: 10
- Watchers: 12
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - asc - Datastore Connectivity for Aerospike for go. (Database Drivers / NoSQL Database Drivers)
- awesome-go-storage - asc - Datastore Connectivity for Aerospike for go. (Database Drivers)
- awesome-go - asc - Datastore Connectivity for Aerospike for go - ★ 4 (Database Drivers)
- awesome-go-extra - asc - 06-13T20:22:31Z|2019-04-20T03:34:22Z| (Generators / NoSQL Database Drivers)
- awesome-go-storage - asc - Datastore Connectivity for Aerospike for go. (Database Drivers)
README
# Datastore Connectivity for Aerospike (asc)
[](https://goreportcard.com/report/github.com/viant/asc)
[](https://godoc.org/github.com/viant/asc)
This library is compatible with Go 1.11+
Please refer to [`CHANGELOG.md`](CHANGELOG.md) if you encounter breaking changes.
- [Usage](#Usage)
- [License](#License)
- [Credits and Acknowledgements](#Credits-and-Acknowledgements)
#### Configuration parameters
###### aerospike client/policy config params
- timeoutMs
- connectionTimeout
- serverSocketTimeout
- scanPct
- host
- port
- namespace
- sleepBetweenRetries
- batchSize
###### keyColumn, keyColumnName
Defines name of column used as record key ('id' by default)
It can be specified per table i.e
events.keyColumn = code
###### excludedColumns
List of columns to be excluded from record (i.e: id - in case we need it only as record key)
###### dateFormat
ISO date format used to time.Time conversion
###### optimizeLargeScan
Experimental feature that first scan all keys and write then to disk
and then separate go routines scan data using the dumped keys
You can only specify _scanBaseDirectory_
## Usage:
The following is a very simple example of CRUD operations with dsc
config.yaml
```yaml
driverName: aerospike
parameters:
namespace: test
host: 127.0.0.1
dateFormat: yyyy-MM-dd hh:mm:ss
```
```go
package main
import (
_ "github.com/aerospike/aerospike-client-go"
_ "github.com/viant/asc"
"github.com/viant/dsc"
"log"
)
type Interest struct {
Id int `autoincrement:"true"`
Name string
ExpiryTimeInSecond int `column:"expiry"`
Category string
}
func main() {
config, err := dsc.NewConfigFromURL("config.yaml")
if err != nil {
log.Fatal(err)
}
factory := dsc.NewManagerFactory()
manager, err := factory.Create(config)
if err != nil {
log.Fatal(err)
}
// manager := factory.CreateFromURL("file:///etc/myapp/datastore.json")
interest := &Interest{}
success, err:= manager.ReadSingle(interest, "SELECT id, name, expiry, category FROM interests WHERE id = ?", []interface{}{id},nil)
if err != nil {
panic(err.Error())
}
var intersts = make([]*Interest, 0)
err = manager.ReadAll(&intersts, "SELECT id, name, expiry, category FROM interests", nil ,nil)
if err != nil {
panic(err.Error())
}
intersts = []*Interest {
Interest{Name:"Abc", ExpiryTimeInSecond:3600, Category:"xyz"},
Interest{Name:"Def", ExpiryTimeInSecond:3600, Category:"xyz"},
Interest{Id:"20, Name:"Ghi", ExpiryTimeInSecond:3600, Category:"xyz"},
}
_, _, err = manager.PersistAll(&intersts, "intersts", nil)
if err != nil {
panic(err.Error())
}
fmt.Printf("Inserted %v, updated: %v\n", inserted, updated)
deleted, err := manager.DeleteAll(&intersts, "intersts", nil)
if err != nil {
panic(err.Error())
}
fmt.Printf("Inserted %v, updated: %v\n", deleted)
var records = []map[string]interface{}{}
err = manager.ReadAll(&records, "SELECT id, name, expiry, category FROM interests", nil ,nil)
if err != nil {
panic(err.Error())
}
}
```
### Query level UDF support
- **ARRAY** converts supplied source column into collection of map entry defined as (key, value)
```sql
SELECT
id,
username,
ARRAY(city_visited) AS visited
FROM users
```
- **JSON** convert supplied source column to JSON
```sql
SELECT
id,
username,
JSON(city_visited) AS visited
FROM users
```
## GoCover
[](https://gocover.io/github.com/viant/asc)
The source code 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.
## Credits and Acknowledgements
**Library Author:** Adrian Witas
**Contributors:**