System limits and thresholds

This page provides information about known limits, maximums, and restrictions for various objects in Aerospike Database.

Bin

Name (length and characters)

Bin name cannot exceed 15 bytes.
Double-byte characters are displayed as text.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Maximum bins per namespace

Database 7 and 8: unlimited
Database 5 and 6: 65,535

Cluster

Name (length and characters)

Cluster name cannot exceed 63 bytes.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Maximum nodes per cluster

Enterprise Edition, Database 5 and later: 256
Community Edition, Database 4 and later: 8
Community Edition, Database 3: 31

Cluster data limit

An Enterprise Edition cluster has no limit on the amount of data it can contain.
A Community Edition cluster can have a maximum of eight nodes, with each node having storage of up to 640 GiB multiplied by the replication factor. This storage amount must include system overhead for necessary server processes, with the remainder being available for data. At a level of 50% for overhead, this amounts to approximately 2.5 TB of unique data for a cluster of eight nodes.

Generation number

The generation number wraps back to 1 after 65536 updates in AP mode, or 1024 updates in SC mode. See conflict-resolution-policy for details on one of the main usages of this metadata.

Histogram

The maximum interval between sampling slices for 10-second slices is 86400 seconds.

Key

Data Type

A key’s data type can be only one of the following:

string
integer
bytes (blob)

Size

The Java client limits a record’s primary key size to slightly under 8 KiB.

For C-based clients such as Python, PHP, Go, and C#, no limit is defined.
The actual limit is the size of the stack at around 10 MiB.
You can determine the total stack size by running ulimit -s, or you can print a list of all current limits with ulimit -a.

Namespace

Name (length and characters)

Namespace name cannot exceed 31 bytes.
Double-byte characters are displayed as text.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Maximum number of namespaces

Enterprise Edition: 32
Community Edition, Database 4 and later: 2

Maximum file or device size

2TiB

Maximum files or devices per namespace, per node

Database 4.2 and later: 128

Network interfaces

Maximum number of interfaces: 500
Maximum number of IP addresses per interface: 20 (any IPs beyond 20 are ignored)

Record

Maximum records

Enterprise Edition: 549,755,813,888 records per namespace per node.
Community Edition: 4,294,967,296 records per namespace per node.
Enterprise Edition 4.2.0.2 and later: 2^39 records index-stage-size=16G

Actual number limited by the cluster’s RAM and storage.

Number of bins

Maximum bins per record: 32,767 bins

Sets

A record can belong to only one set.

Maximum record size

Record size including metadata: 8 MiB governed by the max-record-size

Replication factor

Maximum replication-factor

In High Availability (AP) mode, the replication factor can be greater than the number nodes in the cluster. In this case, the replication factor is dynamically adjusted to the number of nodes. When a new node is added, the replication factor is again dynamically adjusted to the new number of nodes.
In Strong Consistency (SC) mode, the limit on replication factor is the number of nodes in the cluster.

Secondary index

Name (length and characters)

Secondary index name cannot exceed 63 bytes.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Byte size

A bin is eligible for secondary indexing if its size is within the following bounds:

String bin less than or equal to 2048 bytes
GeoJSON bin less than or equal to 1 MB.

Indexes per namespace

Maximum: 256

Security

Allowable passwords

See Valid password constructs.

Username and role name (length and characters)

Username and role name cannot exceed 63 bytes.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Set

Name (length and characters)

Set name cannot exceed 63 bytes.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.

Maximum sets per namespace

Database 8: 4095, with one set reserved for transaction monitors
Database 7: 4095
Database 6 and earlier: 1023

Transactions

Writes per transaction

Limited to 4096 records, identified by their digests, being modified by a single transaction.

XDR - Datacenters

Number of datacenters

64 datacenters maximum

Datacenter name (length and characters)

Datacenter name cannot exceed 31 bytes.
Names can include only Latin lowercase and uppercase letters with no diacritical marks (a-z, A-Z), digits 0-9, underscores (_), hyphens (-), and dollar signs ($). This naming guideline is not enforced; however, if violated, some Aerospike features and tools might not function properly.
Name should not contain reserved word null.