grocksdb, RocksDB wrapper for Go

This is a Fork from tecbot/gorocksdb. I respect the author work and community contribution. The LICENSE still remains as upstream.

Why I made a patched clone instead of PR:

Supports almost C API (unlike upstream). Catching up with latest version of Rocksdb as promise.
This fork contains no defer in codebase (my side project requires as less overhead as possible). This introduces loose convention of how/when to free c-mem, thus break the rule of tecbot/gorocksdb.

Install

Prerequisite

librocksdb
libsnappy
libz
liblz4
libzstd
libbz2 (optional)

Please follow this guide: https://github.com/facebook/rocksdb/blob/master/INSTALL.md to build above libs.

Build

After installing both rocksdb and grocksdb, you can build your app using the following commands:

CGO_CFLAGS="-I/path/to/rocksdb/include" \
CGO_LDFLAGS="-L/path/to/rocksdb -lrocksdb -lstdc++ -lm -lz -lsnappy -llz4 -lzstd" \
  go build

Or just:

go build // if prerequisites are in linker paths

If your rocksdb was linked with bz2:

CGO_LDFLAGS="-L/path/to/rocksdb -lrocksdb -lstdc++ -lm -lz -lsnappy -llz4 -lzstd -lbz2" \
  go build

Usage

API Support

Almost C API, excepts:

putv/mergev/deletev/delete_rangev
compaction_filter/compaction_filter_factory/compaction_filter_context
transactiondb_property_value/transactiondb_property_int
optimistictransactiondb_property_value/optimistictransactiondb_property_int

Name		Name	Last commit message	Last commit date
Latest commit History 144 Commits
.github		.github
.gitignore		.gitignore
.gitmodules		.gitmodules
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
array.go		array.go
array_test.go		array_test.go
backup.go		backup.go
backup_test.go		backup_test.go
build.sh		build.sh
c.h		c.h
cache.go		cache.go
cache_test.go		cache_test.go
cf_handle.go		cf_handle.go
cf_metadata.go		cf_metadata.go
cf_test.go		cf_test.go
cf_ts_test.go		cf_ts_test.go
checkpoint.go		checkpoint.go
checkpoint_test.go		checkpoint_test.go
compaction_filter.go		compaction_filter.go
compaction_filter_test.go		compaction_filter_test.go
comparator.go		comparator.go
comparator_test.go		comparator_test.go
comparator_ts_test.go		comparator_ts_test.go
cow.go		cow.go
cow_test.go		cow_test.go
cuckoo_table.go		cuckoo_table.go
db.go		db.go
db_external_file_test.go		db_external_file_test.go
db_test.go		db_test.go
db_ts_test.go		db_ts_test.go
dbpath.go		dbpath.go
doc.go		doc.go
env.go		env.go
env_test.go		env_test.go
filter_policy.go		filter_policy.go
filter_policy_test.go		filter_policy_test.go
go.mod		go.mod
go.sum		go.sum
grocksdb.c		grocksdb.c
grocksdb.h		grocksdb.h
iterator.go		iterator.go
iterator_test.go		iterator_test.go
iterator_ts_test.go		iterator_ts_test.go
jemalloc.go		jemalloc.go
jemalloc_test.go		jemalloc_test.go
mem_alloc.go		mem_alloc.go
memory_usage.go		memory_usage.go
memory_usage_test.go		memory_usage_test.go
merge_operator.go		merge_operator.go
merge_operator_test.go		merge_operator_test.go
non_builtin.go		non_builtin.go
non_builtin_clean_link.go		non_builtin_clean_link.go
optimistic_transaction_db.go		optimistic_transaction_db.go
options.go		options.go
options_backup.go		options_backup.go
options_backup_test.go		options_backup_test.go
options_blob_test.go		options_blob_test.go
options_block_based_table.go		options_block_based_table.go
options_block_based_table_test.go		options_block_based_table_test.go
options_compaction.go		options_compaction.go
options_compaction_test.go		options_compaction_test.go
options_compression.go		options_compression.go
options_env.go		options_env.go
options_env_test.go		options_env_test.go
options_flush.go		options_flush.go
options_flush_test.go		options_flush_test.go
options_ingest.go		options_ingest.go
options_read.go		options_read.go
options_read_test.go		options_read_test.go
options_restore.go		options_restore.go
options_restore_test.go		options_restore_test.go
options_test.go		options_test.go
options_transaction.go		options_transaction.go
options_transactiondb.go		options_transactiondb.go
options_wait_for_compact.go		options_wait_for_compact.go
options_wait_for_compact_test.go		options_wait_for_compact_test.go
options_write.go		options_write.go
options_write_test.go		options_write_test.go
perf_context.go		perf_context.go
perf_level.go		perf_level.go
ratelimiter.go		ratelimiter.go
slice.go		slice.go
slice_transform.go		slice_transform.go
slice_transform_test.go		slice_transform_test.go
snapshot.go		snapshot.go
sst_file_writer.go		sst_file_writer.go
stats.go		stats.go
testing_darwin_arm64.go		testing_darwin_arm64.go
testing_linux_amd64.go		testing_linux_amd64.go
testing_linux_arm64.go		testing_linux_arm64.go
transaction.go		transaction.go
transactiondb.go		transactiondb.go
transactiondb_test.go		transactiondb_test.go
util.go		util.go
wal_iterator.go		wal_iterator.go
write_batch.go		write_batch.go
write_batch_test.go		write_batch_test.go
write_batch_ts_test.go		write_batch_ts_test.go

License

linxGnu/grocksdb

Folders and files

Latest commit

History