Aerospike Database 7.0 Release Notes

Aerospike Database Release Notes 7.0

November 15, 2023

Aerospike Database software version 7.0 is now available.

New in this version

This version implements a variety of feature requests and improvements to enhance performance, usability and reliability.

New features

• New storage engine for in-memory namespaces
  • Unified write-block storage format
  • Aerospike Enterprise Edition (EE) and Standard Edition (SE) store data in shared memory segments
  • Fast restarts for EE and SE in-memory namespaces
  • Compression available for in-memory namespaces
• Default TTL can now be configured at set level
• Secondary indexes can be built on the bytes data type (BLOBs)
• See the detailed complete list of all new features

Updates

• Server UDF subsystem upgraded to Lua version 5.4
• Aerospike Tools 10.0
• Removed limit on number of unique bin names per namespace
• Increased the maximum number of sets per namespace to 4095
• An optimization for data-in-memory namespaces with storage-backed persistence, where hot keys that remain exactly the same size between writes were written in-place, has been removed in Database 7.0 as part of AER-6666.
• API changes
  • The device_size and memory_size expressions are now deprecated. Use the new expression record_size instead.
  • Developer API option to keep a CDT index on a per-bin basis is available for any storage engine
• See Platform support and compatibility for all currently supported platforms

Configuration changes

• Before upgrading to 7.0, from pre-7.0, cluster-name must be set dynamically on all nodes in the pre-7.0 cluster.
• index-type flash does not work with storage-engine pmem or storage-engine memory.
• See configuration changes for namespace data storage and data retention.

Configuration items added or enhanced

Item	Action	Notes
storage-engine memory	added	new context supporting most of the storage-engine device configuration items
data-size	added	for storage-engine memory, only if there is no device/file backing (that is, “memory only”)

Configuration items removed

Item	Action	Notes
memory-size	removed	Starting with Database 7.1 use indexes-memory-budget
stop-writes-pct	removed	use stop-writes-sys-memory-pct
data-in-memory	removed	use storage-engine memory
high-water-memory-pct	removed
commit-min-size	removed

Configuration items renamed

Item	Action	New name
high-water-disk-pct	renamed	evict-used-pct
mounts-size-limit	renamed	mounts-budget
max-used-pct	renamed	stop-writes-used-pct
min-avail-pct	renamed	stop-writes-avail-pct
mounts-high-water-pct	renamed	evict-mounts-pct

Info commands changes

Item	Action
bins	removed

Metrics changes

Metrics items removed

Item	Action
memory_used_bytes	removed
memory_free_pct	removed
bin_names	removed
bin_names_quota	removed
available_bin_names	removed

Metrics items renamed

Item	Action	New name
memory_used_data_bytes	renamed	data_used_bytes
memory_used_index_bytes	renamed	index_used_bytes
memory_used_set_index_bytes	renamed	set_index_used_bytes
memory_used_sindex_bytes	renamed	sindex_used_bytes
index_pmem_used_bytes	renamed	index_used_bytes
index_pmem_used_pct	renamed	index_mounts_used_pct
sindex_pmem_used_bytes	renamed	sindex_used_bytes
sindex_pmem_used_pct	renamed	sindex_mounts_used_pct
index_flash_used_bytes	renamed	index_used_bytes
index_flash_used_pct	renamed	index_mounts_used_pct
sindex_flash_used_bytes	renamed	sindex_used_bytes
sindex_flash_used_pct	renamed	sindex_mounts_used_pct
pmem_total_bytes	renamed	data_total_bytes
pmem_used_bytes	renamed	data_used_bytes
pmem_free_pct	renamed	data_used_pct
pmem_available_pct	renamed	data_avail_pct
pmem_compression_ratio	renamed	data_compression_ratio
device_total_bytes	renamed	data_total_bytes
device_used_bytes	renamed	data_used_bytes
device_free_pct	renamed	data_used_pct
device_available_pct	renamed	data_avail_pct
device_compression_ratio	renamed	data_compression_ratio
memory_data_bytes	renamed	data_used_bytes
device_data_bytes	renamed	data_used_bytes

Server log changes

Item	Action
memory-usage	removed
index-pmem-usage	removed
index-flash-usage	removed
sindex-pmem-usage	removed
sindex-flash-usage	removed
pmem-usage	removed
device-usage	removed
index-usage	added
set-index-usage	added
sindex-usage	added
data-usage	added

Tools changes

Changes in Tools 10.0.0

• Aerospike shared memory tool (ASMT) now backs up storage-engine memory to and from shared memory (shmem).
• Removed AQL truncate command. (Replaced with asadm manage command).

See Tools 10.0 Release Notes.

Client/server feature compatiblity

For a complete list of client features and the server versions that support them, see the Client Matrix.

Ecosystem compatibility

Compatible client versions

For full feature access in Database 7.0:

• Java client 7.2.0
• Python client 14.0.0
• C# client 6.2.0
• C client 6.5.0
• Go client 7.0 is required for use with Database 7.0
• Node.js client 5.9.0

Compatible connector versions

• Trino connector 1.2.0 or later
• Spark connector 3.1.1 or later

Prerequisites and notes

• For upgrade instructions, refer to Upgrade or Repair Server
• For special upgrade instructions, refer to Upgrade to Aerospike Database 7.0

Complete list of changes

ID	Description
AER-6666	(STORAGE) Redesigned memory storage, including significant changes to configuration and statistics.
AER-6668	(KVS) The number of bin names per namespace is now unlimited.
AER-6669	(UDF) Upgraded Lua to version 5.4.
AER-6671	(STORAGE) Storage benchmark histograms may now be configured to use units of microseconds.
AER-6672	(KVS) Added set context configuration item 'default-ttl' to optionally specify a default ttl at the set level.
AER-6674	(KVS) Increased the maximum number of sets per namespace to 4095.
AER-6675	(UDF) Implemented record.size(), to replace the now-deprecated record.memory_size() and record.device_size() methods.
AER-6676	(EXPRESSIONS) Added a record_size() op, to replace the now-deprecated device_size() and memory_size() ops.
AER-6677	(CDT) Added support for persisting CDT indexes as specified per operation.
AER-6678	(CLUSTERING) It is now mandatory to set service context configuration item cluster-name.
AER-6679	(SINDEX) Added support for secondary indexes on "blob" type elements.
AER-6683	(UDF) Preserve the specific blob type of a bin when it is read and rewritten by a UDF.
AER-6685	(STORAGE) Removed storage context configuration item commit-min-size.
AER-6686	(CDT) If not already key-sorted, sort all maps written to the server.

Product lifecycle updates

Aerospike provides Maintenance and Support for 2 years (24 months) starting with Database release 6.3. See Platform support for details.

Known limitations

• See Server Known Issues Reference