Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/syndtr/Goleveldb
LevelDB key/value database in Go.
https://github.com/syndtr/Goleveldb
database go leveldb
Last synced: about 2 months ago
JSON representation
LevelDB key/value database in Go.
- Host: GitHub
- URL: https://github.com/syndtr/Goleveldb
- Owner: syndtr
- License: bsd-2-clause
- Created: 2013-01-23T04:08:58.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-05-14T20:40:52.000Z (7 months ago)
- Last Synced: 2024-10-19T18:12:08.650Z (2 months ago)
- Topics: database, go, leveldb
- Language: Go
- Size: 1.87 MB
- Stars: 6,149
- Watchers: 181
- Forks: 969
- Open Issues: 108
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This is an implementation of the [LevelDB key/value database](https://github.com/google/leveldb) in the [Go programming language](https://go.dev).
[![Build Status](https://app.travis-ci.com/syndtr/goleveldb.svg?branch=master)](https://app.travis-ci.com/syndtr/goleveldb)
Installation
-----------go get github.com/syndtr/goleveldb/leveldb
Requirements
-----------* Need at least `go1.14` or newer.
Usage
-----------Create or open a database:
```go
// The returned DB instance is safe for concurrent use. Which mean that all
// DB's methods may be called concurrently from multiple goroutine.
db, err := leveldb.OpenFile("path/to/db", nil)
...
defer db.Close()
...
```
Read or modify the database content:
```go
// Remember that the contents of the returned slice should not be modified.
data, err := db.Get([]byte("key"), nil)
...
err = db.Put([]byte("key"), []byte("value"), nil)
...
err = db.Delete([]byte("key"), nil)
...
```Iterate over database content:
```go
iter := db.NewIterator(nil, nil)
for iter.Next() {
// Remember that the contents of the returned slice should not be modified, and
// only valid until the next call to Next.
key := iter.Key()
value := iter.Value()
...
}
iter.Release()
err = iter.Error()
...
```
Seek-then-Iterate:
```go
iter := db.NewIterator(nil, nil)
for ok := iter.Seek(key); ok; ok = iter.Next() {
// Use key/value.
...
}
iter.Release()
err = iter.Error()
...
```
Iterate over subset of database content:
```go
iter := db.NewIterator(&util.Range{Start: []byte("foo"), Limit: []byte("xoo")}, nil)
for iter.Next() {
// Use key/value.
...
}
iter.Release()
err = iter.Error()
...
```
Iterate over subset of database content with a particular prefix:
```go
iter := db.NewIterator(util.BytesPrefix([]byte("foo-")), nil)
for iter.Next() {
// Use key/value.
...
}
iter.Release()
err = iter.Error()
...
```
Batch writes:
```go
batch := new(leveldb.Batch)
batch.Put([]byte("foo"), []byte("value"))
batch.Put([]byte("bar"), []byte("another value"))
batch.Delete([]byte("baz"))
err = db.Write(batch, nil)
...
```
Use bloom filter:
```go
o := &opt.Options{
Filter: filter.NewBloomFilter(10),
}
db, err := leveldb.OpenFile("path/to/db", o)
...
defer db.Close()
...
```
Documentation
-----------You can read package documentation [here](https://pkg.go.dev/github.com/syndtr/goleveldb).