Loading
Known limitations
Detailed here are various maximum sizes or numbers, name lengths, and character restrictions of the names of various Aerospike Database objects.
| Object | What | Description |
|---|---|---|
| Bin | Name, length and characters | - Maximum: 15 bytes. - Double-byte characters are displayed as ASCII. - 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. - Reserved word null should be avoided. |
| Bin | Number of bins per namespace | Maximum bin names per namespace: - Database 7: unlimited. - Database 5 and 6: 65,535. |
| Cluster size | Max number of nodes | Enterprise Edition: - Database 5 and later: 256. Community Edition: - CE 4 and later: 8. - CE 3: 31. |
| Cluster | Amount of data | - An Enterprise Edition cluster has no limit on the amount of data it can have. - A Community Edition cluster can have a maximum of 5TB for entire cluster, divided into 640GB of unique data per node: 5TB ÷ 8 maximum number of nodes per cluster. The maximum 640GB per node is calculated only on available capacity of the node, not actual capacity, and can include system overhead for necessary server processes. |
| Devices | Maximum number of devices or files per namespace per node | - Database 4.2 and later: 128. |
| Histogram | Interval between sampling slices | For 10 second slices, maximum: 86400 seconds. |
| Generation | Number | The generation wraps back to 1 after 65536 updates in AP mode, or 1024 updates in SC mode. See the conflict-resolution-policy for details on one of the main usages of this metadata. |
| Key | Data Type | A key's data type can be a string, integer or bytes (blob). |
| Key | Size | The Java client limits the records 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 10MiB. The total stack size can be determined by running the ulimit command:- ulimit -sOr, print a list of all current limits: - ulimit -a |
| Namespace | Name, length and characters | - Maximum: 31 bytes. - Double-byte characters are displayed as ASCII. - 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. - Reserved word null should be avoided. |
| Namespace | Number of bins | Maximum bin names per namespace: - Database 7: unlimited. - Database 5 and 6: 65,535. |
| Namespace | Number of namespaces | - Enterprise Edition, maximum: 32. - Community Edition Database 4.0 and later, maximum: 2. |
| Namespace | Size of each file or device | Maximum: 2TiB. |
| Namespace | Storage | Maximum: 128 devices per namespace. |
| Network interfaces | Number | Maximum number of interfaces: 500. Maximum number of IP addresses per interface: 20. Any IP addresses after 20 are ignored. |
| Record | Maximum number | - Enterprise Edition: 549,755,813,888 records per namespace per node. - 2^39 records; EE >= 4.2.0.2; index-stage-size=16G.- Community Edition: 4,294,967,296 records per namespace per node. Actual number limited by the cluster's RAM and storage. |
| Record | Number of bins | - Maximum bins per record: 32,767 bins. |
| Record | Sets | A record can belong to only one set. |
| Record | Maximum record size | Record size including metadata. - 8MiB 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 | 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 1MB. |
| Secondary index | Indexes per namespace | Maximum: 256. |
| Secondary index | Name, length and characters | - Maximum: 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. - Reserved word null should be avoided. |
| Security password | Allowable passwords | See Valid password constructs. |
| Security user name and role name | Name length and characters | - Maximum: 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. - Reserved word null should be avoided. |
| Set | Name length and characters | - Maximum: 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. - Reserved word null should be avoided. |
| Set | Number of sets | Maximum sets per namespace: - Database 7: 4095. - Database 6 and earlier: 1023. |
| XDR | Number of datacenters | Maximum: 64. |
| XDR | DC Name length and characters | - Maximum: 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. |
| cluster-name | Name length and characters | - Maximum: 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. |