Client Matrix

Full client/server feature compatibility

The following matrix shows the minimal version of each client required for full feature compatibility with the given server version.

Aerospike server version	6.3	6.2	6.1	6.0	5.7	5.6	5.3	4.9
Java client version	6.1.0	6.1.0	6.1.0	6.0	5.1.6	5.1.0	5.0.1	4.4.16
Python client version	11.0.1	7.0.0	7.0.0	7.0.0	6.0.0	6.0.0	5.0.0	5.0.0
Go client version	6.10.0	6.0.0	6.0.0	6.0.0	5.0.0	5.0.0	5.0.0	5.0.0
C# client version	6.0.0	5.2.0	5.2.0	5.0.0	4.2.2	4.2.0	4.1.6	4.1.6
C client version	6.3.1	6.1.1	6.1.1	6.0.0	5.2.3	5.2.0	5.0.2	5.0.2
Node.js client version	5.4.0	5.0.0	5.0.0	5.0.0	4.0.0	4.0.0	3.16.0	3.16.0

Minimum usable client versions

The following matrix shows the minimal client version that ensures non-breaking operation against the given server version. Applications using older client versions may still work, if they do not use developer API functionality affected by the breaking changes specified below.

Aerospike server version	6.3	6.2	6.1	6.0	5.7	5.6	5.3	4.9
Java client version	6.0.0 (5.1.6)	6.0.0 (5.0.1)	6.0.0 (5.0.1)	6.0.0 (5.0.1)	4.4.20	4.4.20	3.3.3	3.3.3
Python client version	7.0.0 (6.1.0)	7.0.0 (6.0.0)	7.0.0 (6.0.0)	7.0.0 (6.0.0)	6.0.0	6.0.0	3.1.1	3.1.1
Go client version	6.0.0 (5.4.0)	6.0.0 (4.0.0)	6.0.0 (4.0.0)	6.0.0 (4.0.0)	4.2.0	4.2.0	1.38.0	1.38.0
C# client version	5.0.0 (4.2.2)	5.0.0 (4.0.0)	5.0.0 (4.0.0)	5.0.0 (4.0.0)	3.9.15	3.9.15	3.13.0	3.13.0
C client version	6.0.0 (5.2.3)	6.0.0 (5.0.0)	6.0.0 (5.0.0)	6.0.0 (5.0.0)	4.6.24	4.6.24	4.5.0	4.5.0
Node.js client version	5.0.0 (4.0.0)	5.0.0 (4.0.0)	5.0.0 (4.0.0)	5.0.0 (4.0.0)	3.16.7	3.16.7	3.9.0	3.9.0
Ruby client version	2.25.0	2.25.0	2.25.0	2.25.0	2.23.0	2.23.0	2.14.0	2.14.0

Aerospike server version 5.2 introduced filter expressions as an upgrade to the predicate expressions query language. The predicate expression system was supported until server version 6.0, when it was removed.

In the "Minimum usable client versions" chart, the client version number in parentheses is usable with the corresponding server version as long as the application has migrated to using filter expressions (using a client version that supports both filter and predicate expressions). Otherwise, the higher-numbered client version ensures predicate expressions cannot be used with server versions that don't support them.

Major server changes

Server version	Breaking change
6.3.0.0	Removed the jobs: info command.
6.0.0.0	Removed predicate expressions (PredExp).
5.6.0.2	Removed scan policies percent, failOnClusterChange, and priority.
4.9.0	Client applications must support the new style truncate command, and the batch-index protocol for batch operations.
4.4.0.4	Removed support for batch-direct.
3.14.0.0	Removed suport for set-delete.

Client/Server Features

The following table shows the feature compatibility of different language clients. See the feature guide for more information.

	Java¹	C²	C#	Go	Python	Node.js	REST⁹	Rust	Ruby
Batch Transactions⁴	✅	✅	✅	✅	✅	✅	✅
Batch Writes	✅	✅	✅	✅	✅	✅	✅
Bitwise Operations	✅	✅	✅	✅	✅	✅	✅	✅	✅
Boolean Data Type	✅	✅	✅	✅	✅	✅	✅	✅	✅
Client-Server Compression	✅	✅	✅	✅	✅	✅	✅		✅
Context Path Creation	✅	✅	✅	✅	✅	✅	✅	✅	✅
HyperLogLog Data Type	✅	✅	✅	✅	✅	✅	✅	✅	✅
PI Query (Scan)	✅	✅	✅	✅	✅	✅	✅	✅	✅
SI Query	✅	✅	✅	✅	✅	✅	✅	✅	✅
Query Partitions	✅	✅	✅	✅	✅	✅	✅		✅
Query Pagination	✅	✅	✅	✅	✅	✅	✅		✅
Operation Expressions⁸	✅	✅	✅	✅	✅	✅			✅
Geospatial Query	✅	✅	✅	✅	✅	✅	✅	✅	✅
Background Query Operation	✅	✅	✅	✅	✅	✅	✅		✅
Filter Expressions on Operations⁸	✅	✅	✅	✅	✅	✅	✅	✅	✅
Filter Expressions on Queries⁸	✅	✅	✅	✅	✅	✅	✅	✅	✅
Record UDF	✅	✅	✅	✅	✅	✅		✅	✅
Stream UDF	✅	✅	✅	✅	✅	✅
TLS	✅	✅	✅	✅	✅	✅⁵	✳️⁷		✅
RBAC	✅	✅	✅	✅	✅	✳️⁶	✅	✅	✅
PKI Authentication	✅	✅	✅	✅	✅	✅	✳️⁷
LDAP	✅	✅	✅	✅	✅	✅
IPv6	✅	✅	✅	✅	✅	✅	✳️⁷		✅
Load Balancer as Seed Node	✅	✅	✅	✅	✅	✅	✅		✅
Strong Consistency	✅	✅	✅	✅	✅	✅	✅
Rack Aware Reads	✅	✅	✅	✅	✅	✅	✅		✅

¹ Minimum JDK version is 8.
² C client supports libev, libuv, and libevent asynchronous frameworks.
⁴ Refers to a transaction of read operations (`operate`) run in a batch against multiple keys.
⁵ Node.js client supports TLS on Linux only.
⁶ Node.js has RBAC support for connections to EE clusters, but not the management of users and roles.
⁷ REST has TLS, IPv6 and PKI authentication between the gateway and the EE cluster, but not for calls to the gateway itself.
⁸ Aerospike Filter Expressions were added in Aerospike Database 5.2; Operation Expressions were added in Aerospike Database 5.6.
⁹ Minimum JDK version is 17.