Known issues
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 page documents known issues and limitations in the Developer SDK.
Limitations
| Limitation | Impact | Workaround | Status |
|---|---|---|---|
| Write-side HLL is not available in AEL filters | hllInit and hllAdd are defined by the AEL grammar but rejected by the Developer SDK | Initialize and update sketches with the builder API — hll_init / hll_add in Python, hllInit / hllAdd in Java. See HLL write functions | Open |
| Limited UDF support | Record-level UDFs are supported, but not stream-level | Use legacy client for full UDF support | Post-GA |
Known bugs
| Issue | Description | Workaround | Status |
|---|---|---|---|
| Java: batch UDF return value | udfResultOrThrow() returns null for rows of a multi-key executeUdf(...); single-key calls are unaffected | Read the row’s record: the value is in its SUCCESS bin | Open |
Deprecated features
No features are deprecated in this release.
Reporting issues
If you encounter an issue not listed here:
- Java: github.com/aerospike/aerospike-client-java-sdk/issues
- Python: github.com/aerospike/aerospike-client-python-sdk/issues
When reporting, please include:
- Client version and language
- Server version
- Minimal reproduction steps
- Full error message and stack trace