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 6.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: None expected.

New Features:

  • Expanded DSL 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