TECH UPDATE: Heads-up for developers re: Secondary Index Related Changes in 5.7
The soon-to-be-released Aerospike 5.7 includes the first milestone of a rewrite of Secondary Indexes. Among these new features are indexes which are 60% more memory efficient, faster queries, and a superior new garbage collection system. You can get a more comprehensive launch overview by reading the blog post Aerospike Database 5.7: Operational, Query, and Security Enhancements.
We also prepared this blog post for developers to use if your application keeps track of Aerospike metrics, or displays information about secondary indexes. It is important to address the changes coming in version 5.7. We go into (lots more) detail below.
Info Commands
Breaking Change
The format of the sindex-list:ns=test
info call has changed in a way that affects tools such as asbackup.
On server version 5.6.0.11, the output is
ns=test:set=testset:indexname=int_idx:bin=bin_1:type=NUMERIC:indextype=NONE:path=bin_1:state=RW;
On server version 5.7.0.4, the output is
ns=test:set=testset:indexname=int_idx:bin=bin_1:type=NUMERIC:indextype=DEFAULT:path=bin_1:state=RW
Note both the missing trailing ;
in 5.7 and the indextype DEFAULT
as opposed to NONE
. This change was done in order to normalize the output of the command with similar ones.
Renamed and Removed
The following info commands are typically used by tools such as asadm and aql.
Pre 5.7 | Aerospike 5.7 |
|
|
|
|
| – deleted – |
| – deleted – |
Configs
Several configuration parameters in the service context have been modified or deleted.
Pre 5.7 | Aerospike 5.7 |
Integer values get rounded up |
An even integer value is enforced |
| – deleted – |
| – deleted – |
| – deleted – |
Stats
Namespace Context
The following table shows changes to statistics related to the namespace info command.
Pre 5.7 | Aerospike 5.7 |
|
|
|
|
|
|
|
|
| – deleted – Use
|
|
|
|
|
|
|
|
|
| – deleted – Use
|
|
|
| – deleted – Use
|
| |
| |
|
|
| – deleted – |
| |
| |
|
Global Context
The following table shows changes to statistics related to the statistics info command. As there is a brand new garbage collection system in 5.7, most of these have been permanently removed.
Pre 5.7 | Aerospike 5.7 |
|
|
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – |
Sindex Context
The following table shows changes to statistics related to the sindex info command.
Pre 5.7 | Aerospike 5.7 |
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – Use
|
| |
| |
| |
|
|
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – |
| – deleted – Use
|
| – deleted – |