Skip to content

Upgrade guide

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Applies to

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

This guide helps you upgrade between versions of the Developer SDK.

Upgrading from legacy client

If you’re migrating from the classic Aerospike client, see the Migration Guide.

Version upgrade paths

0.9.x → 1.0.x (preview → GA)

Breaking Changes: Yes. Review the release notes before upgrading. Notable changes include:

  • Python: session verbs take keys positionally, for example session.upsert(users.id("user-1")). The key= keyword argument is removed.
  • Python: QueryBuilder.max_records() and filter_expression() are removed. Use limit() and where().
  • Java: Cluster.getVersion() is renamed Cluster.getServerVersion().

New Features:

  • Expanded AEL operators
  • Improved batch performance

Migration Steps:

<!-- Update your pom.xml -->
<dependency>
    <groupId>com.aerospike</groupId>
    <artifactId>aerospike-client-sdk</artifactId>
    <version>1.0.0</version>  <!-- was 0.9.0 -->
</dependency>

Deprecation policy

  • Deprecated APIs are marked with @Deprecated (Java) or deprecation warnings (Python)
  • Deprecated APIs remain functional for at least 2 minor versions
  • Migration guidance is provided in release notes

Compatibility considerations

Before upgrading, verify:

  1. Your Aerospike Server version is compatible (Version Compatibility)
  2. Your Java/Python runtime meets minimum requirements

Next steps