Overview: Aerospike C client

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Feature highlights

Core operations:

Atomic requests: Create, read, update, and delete individual records, including compound bin operations in a single round trip.
Cluster awareness: The client discovers cluster topology, routes requests to the correct node, and handles node failures, cluster scaling, and data rebalancing entirely in the background.

Query and multi-record processing:

Primary key lookups: Fetch a record directly by key in a single round trip.
Secondary index queries: Query indexed bins using filter expressions.
Background queries: Run long-running queries without blocking the application thread.
Batch and transactions: Process many records in one request; use multi-record transactions on Strong Consistency namespaces.

Asynchronous and operational features:

Non-blocking I/O: Event-loop-friendly async APIs for high-throughput applications.
Policies and observability: Tune read/write behavior, logging, metrics, and shared-memory access for co-located deployments.
Server-side logic: Register and invoke user-defined functions (UDFs) and aggregations on the server.

Installation

Install the C client library and verify your development environment.

Best practices

Explore logging configuration, connection policies, and record handling recommendations.

Error handling

Understand error codes and recovery steps for common failures.

Usage examples

Start with create, read, and delete operations to learn the core API.