18.0.0

Release Date: October 01, 2025

See Incompatible API Changes for details.

New Features

• Add support for timeout delay. [CLIENT-3455]
• Add "connect_timeout" option to base policy. [CLIENT-3713]
• Add support for new "release" info command. Deprecate info commands to be replaced by this command. [CLIENT-3700]

Improvements

• Raise a client exception when Query.{where,select}() is called more than once on the same Query instance. [CLIENT-3696]

Bug Fixes

• Docs: fix incorrect description for client configuration connect_timeout option.

Full Changelog: 17.2.0...18.0.0

17.2.0

Release Date: September 23, 2025

New Features

• Add client.get_stats() to retrieve client standard metrics. [CLIENT-3680]
• Allow passing in base64 encoded string as an expression to Query.where_with_expr(). [CLIENT-2037]
• Add Python 3.14 support. [CLIENT-3678]
• Add support for Debian 13. [CLIENT-3372]

Bug Fixes

• Fixed memory leaks when assigning {key, bin, module, func, name} attributes for an AerospikeError subclass, and when a Python object's class name doesn't match an expected aerospike_helpers class. [CLIENT-3634]
• Docs: client.query() constructor: "set" parameter's behavior is described incorrectly. [CLIENT-3495]
• Fix bug where the default metrics writer does not specify the correct client language and version in the logs. [CLIENT-3703]
• Fix potential memory leaks or errors related to client.batch_write() or an object passed into a ctx parameter. [CLIENT-2159]
• Fix reference count leaks when a user passes in a MetricsPolicy to client.enable_metrics(). [CLIENT-2159]

Full Changelog: 17.1.0...17.2.0

17.1.0

Release Date: August 04, 2025

Breaking Changes

• See Incompatible API Changes for details.

New Features

• Add support for dynamic client configurations. [CLIENT-3366]
• Add support for metrics improvements: deeper granularity and additional metrics. [CLIENT-3460]
• Add support for expression indexes. [CLIENT-3497]
• Add support for preventing password use for Public Key Infrastructure (PKI) users. [CLIENT-3581]
• Add support for user agent: sends client type, library version, and app ID to server. [CLIENT-3583]
• Add support for circuit breaker + progressive back off. [CLIENT-3455]
• Add support for distributing reads and writes across random nodes. [CLIENT-3618]

Improvements

• Build manylinux_2_28 wheels instead of manylinux2014 wheels. [CLIENT-2666]
• Fix implicit function declaration warnings. Re-enable implicit function warnings when compiling the Python client. [CLIENT-3538]
• Tend interval must be at least 250 ms now.
• Add missing references to aerospike enum constants for certain bitwise operations. [CLIENT-2169]
• Add a separate section for aerospike's index_type constants. [CLIENT-3633]
• Docs: Fix sidebar headers for "Scan and Query Constructors". [CLIENT-2577]
• Docs: Clear up that bin name parameter should be explicitly set to None for Query.where_with_{index_name,expr}(). [CLIENT-3633]
• Add missing documentation for aerospike.AUTH_PKI constant.
• Fix incorrect parameter name "username" by changing it to "user" for Client.admin_{create_user,drop_user,change_password,set_password,grant_roles,revoke_roles}().

Bug Fixes

• client.batch_read(): fix memory leak if bins parameter is invalid. [CLIENT-3478]
• {Scan,Query}.apply(): fix memory leak when passing in an invalid UDF argument. [CLIENT-2159]
• Fix memory leak when user uses their own MetricsListener instance. [CLIENT-3490]
• Fix memory leak when client config option "cluster_name" is set. [CLIENT-3516]
• query.foreach(): have each callback thread set its own as_error object to avoid overriding the main error. [CLIENT-2417]
• Fix segmentation fault when we run a paginated query with a partition filter and then re-run the same query object with another partition filter that has different "begin" and "count" values. [CLIENT-3500]
• Fix all memory leaks coming from as_config object.

Full Changelog: 17.0.0...17.1.0

17.0.0

Release Date: May 05, 2025

Breaking Changes

• Remove API calls that were deprecated in Python client 12.0.0. [CLIENT-2756]
• See Incompatible API Changes for details.

Improvements

• Add macOS 15 support. [CLIENT-3216]
• Docs: improve explanation for config-level batch policies. [CLIENT-3410]
• Docs: update landing page with new links. [CLIENT-3395]
• Docs: aerospike.Client.admin_query_users_info(): fix incorrect return type.

Bug Fixes

• Fix 2 memory leaks in client.batch_write(). [CLIENT-3382]
• Fix client not reading or writing integers greater than 32-bit values on Windows. [CLIENT-3380]
• Fix client configurations "batch" policy being used in client.batch_{write,remove,apply}() by default instead of "batch_parent_write" when None is passed to "policy_batch" parameter. [CLIENT-3411]
• client.batch_read(): allow optional bins parameters to take in None as an argument. [CLIENT-3424]
• Fix unraisable exception warnings in Python 3.13 reported by tests by chaining hidden exceptions with the ones returned to user. [CLIENT-3188]
• client.enable_metrics(): fix potential segmentation fault when aerospike_enable_metrics() returns an error and the default metrics writer is used.

Full Changelog: 16.0.2...17.0.0

16.0.2

Release Date: March 06, 2025

Breaking Changes

• See Incompatible API Changes for details.

Improvements

• Remove Python 3.8 support. [CLIENT-3157]
• Remove macOS12 support. [CLIENT-3215]
• Add support for Ubuntu 24.04. [CLIENT-2930]
• Transactions: remove redundant commit statuses that are already returned as AerospikeError exceptions. [CLIENT-3324]

Bug Fixes

• Fix stack overflow when sending a batch command with many keys. [CLIENT-3307]
• Fix client.operate() context memory leak. [CLIENT-2159]
• Fix stack overflow when disabling metrics. [CLIENT-3339]
• Allow importing aerospike.{exception,predicates} by adding the submodules to sys.modules using their fully qualified names. [CLIENT-2760]

Full Changelog: 16.0.1...16.0.2

16.0.1

Release Date: January 22, 2025

Breaking Changes

• See Incompatible API Changes for details.

New Features

• Add missing "on_locking_only" option for write, apply, operate, batch_write, and batch_apply policies. [CLIENT-3264]
• Add missing "txn_verify" and "txn_roll" config policies. [CLIENT-3121]

Improvements

• Throw exceptions when an MRT commit is called but transaction was already aborted and when an MRT abort is called but a transaction was already committed. [CLIENT-3241]
• Support new Database MRT error codes. [CLIENT-3259]
• Documentation: Clarify that the "compress" policy requires Aerospike Database Enterprise Edition. [CLIENT-3228]
• Python: Normalize API reference language with Aerospike Database 8.0 site documentation. [CLIENT-3272]

Bug Fixes

• Fix client.truncate() segmentation fault if there is no connection. [CLIENT-3254]
• Modify on_locking_only batch code to only write info4 byte when on_locking_only is true. [CLIENT-3264]

Full Changelog: 16.0.0...16.0.1

16.0.0

Release Date: December 16, 2024

• Requires server 8.0.0.0-rc1 or greater for Multi-Record Transactions (MRT) support.

Breaking Changes

• See Incompatible API Changes for details.

New Features

• Bundle manylinux2014 and macOS wheels with OpenSSL 3.0. [CLIENT-2217]
• Support Multi-Record Transactions. [CLIENT-3121]
• Add Python 3.13 support. [CLIENT-2992]

Bug Fixes

• Fix AerospikeError attributes not being assigned when an error code without a matching Exception is raised. [CLIENT-3166]
• Refactor aerospike module initialization code and check if error indicator is set after every C-API call. [CLIENT-3106]
• Refactor base policy code and check if error indicator was set while parsing policy dictionaries. [CLIENT-3106]

Full Changelog: 15.1.0...16.0.0

15.1.0

Release Date: September 23, 2024

Breaking Changes

• Remove aerospike.__version__ to single source the client's version. [CLIENT-1938]
• See Incompatible API Changes for details.

New Features

• Add macOS 13 support. [CLIENT-2904]
• Add macOS 14 support. [CLIENT-2673]
• Add missing aerospike_helpers.expressions.resources.ResultType constant NIL. [CLIENT-3057]
• Add support for error code 32 (XDR key busy). [CLIENT-3099]

Improvements

• Remove macOS 11 support. [CLIENT-2736]
• Docs: Add note about bug with passing only read operations in client.batch_operate(). [CLIENT-2851]
• Docs: Move deprecation warnings for API methods to the top of each method. [CLIENT-2855]
• Docs: Clarify batch API behavior. [CLIENT-2853]
• Docs: Add missing error codes and descriptions, remove tree diagram for errors. [CLIENT-2854]
• Docs: Clarify that deleting all keys in a map does not delete the map itself. [CLIENT-2858]
• Docs: Clarify how map policy works for all map operations that use it. [CLIENT-2856]
• Docs: Clarify how list order works and add link to explain negative indices. [CLIENT-2856]

Bug Fixes

• Fix client config batch_write, batch_remove, and batch_apply policies not being applied to Write, Remove, and Apply BatchRecords respectively. [CLIENT-2842]
• Fix memory leak that occurs when creating an aerospike_helpers class instance with a parameter. [CLIENT-2701]
• Fix aerospike.Client() segfaulting when it fails to connect. [CLIENT-2887]
• Fix scans not working for a mixed cluster of 5.7 and 6.4 nodes. [CLIENT-3000]
• Show class name when printing a aerospike_helpers.HyperLogLog class instance. [CLIENT-2897]
• query.apply(): remove policy parameter. [CLIENT-2544]
• Refactor aerospike.exception initialization code and check if error indicator is set after calling a C-API method. [CLIENT-3106]
• Replace an existing node in the cluster when a new peer has the same node name, but a different IP address. [CLIENT-3117]

Full Changelog: 15.0.0...15.1.0

15.0.0

Release Date: April 09, 2024

Breaking Changes

• See Incompatible API Changes for details.

New Features

• Add support for metrics. [CLIENT-2701]
• Add "read_touch_ttl_percent" option in read, operate, batch, and batch read policies. [CLIENT-2828]
• Add "expected_duration" option and deprecate "short_query" option in query policy. [CLIENT-2821]
• Add support for persistent list indexes. [CLIENT-2769]

Improvements

• Add support for reading key ordered maps. [CLIENT-2077]
• Add HyperLogLog class to represent HLL values. [CLIENT-1824]
• Docs: Add note about using POLICY_KEY_SEND and list possible map key types for server >= 7.1. [CLIENT-2444]
• Docs: Fix broken links and typos. [DOCS-2259]
• Docs: fix incorrect order of parameters for operations. [CLIENT-2812]

Bug Fixes

• Do not use batch repeat flag on batch writes when aerospike.POLICY_KEY_SEND is used. [CLIENT-2779]

Full Changelog: 14.2.0...15.0.0

14.2.0

Release Date: February 13, 2024

Improvements

• Add support for Windows 64-bit (x86). [CLIENT-2322]

Full Changelog: 14.1.0...14.2.0