Version compatibility

Applies to

• Aerospike Developer SDK (Java 21+ and Python 3.11+)
• Aerospike Database 8.2.0 or later, unless a section states otherwise

Code examples

Examples assume a connected session from Connect to Aerospike. Each usage guide lists shared imports in a tabbed block near the top of the page; snippet blocks add imports only for types not already shown. The first code block in each section includes dataset setup; later blocks in that section reuse those values. When a page includes a Complete example section, that block is fully self-contained.

This page documents which Developer SDK versions are compatible with which Aerospike Server versions.

Note

The matrix will expand as new releases ship. Use Known issues for current limitations.

Client ↔ server compatibility

Developer SDK	Aerospike Server	Java Version	Python Version
Python	8.2.0+	—	3.11+
Java	8.2.0+	21+	—

Feature availability by server version

Feature	Min Server Version	Notes
AEL filter expressions (.where(...))	8.2.0.0	AEL is compiled and parsed on the server; a set query uses a secondary index when one exists, and otherwise runs as a primary-index query
AEL operation expressions (selectFrom, upsertFrom, insertFrom, updateFrom)	8.2.0.0	Read projection and write-side compute using AEL text
Multi-record transactions (MRT)	8.0+	SC namespace required

Checking your versions

Java

import com.aerospike.client.sdk.Cluster;
import com.aerospike.client.sdk.ClusterDefinition;
import com.aerospike.client.sdk.util.Version;

// Client library version (from the JAR manifest)
ClusterDefinition def = new ClusterDefinition("localhost", 3000);
System.out.println("Developer SDK: " + def.getClientVersion());

// Minimum server version seen across the cluster (after connect)
try (Cluster cluster = def.connect()) {
    Version v = cluster.getServerVersion();
    System.out.println("Cluster server version (min): " + (v != null ? v : "n/a"));
}

📖 API reference: ClusterDefinition(String,int) | ClusterDefinition.getClientVersion() | ClusterDefinition.connect() | Cluster.getServerVersion() | Cluster.close()

Python

import asyncio

import aerospike_sdk
from aerospike_sdk import ClusterDefinition

# Client library version
print(f"Developer SDK: {aerospike_sdk.__version__}")

async def main():
    # Minimum server version seen across the cluster (after connect)
    async with ClusterDefinition("localhost", 3000).connect() as cluster:
        v = cluster.server_version()
        print(f"Cluster server version (min): {v if v is not None else 'n/a'}")

asyncio.run(main())

Next steps

• Installation Guide
• Quickstart