Create a database
Before creating a Redis Cloud database, you need to create an account and create a subscription.
To create a database in your Redis Cloud subscription:
-
Sign in to the Redis Cloud console.
-
If you have more than one subscription, select the target subscription from the list. This displays the Databases tab for the selected subscription.
-
Select the New database button.
This displays the New database screen, which varies according to your subscription plan.
The New database screen is divided into sections, each dedicated to a specific category of settings. Note that not every section or setting is available to every subscription plan.
When you’ve configured your new database, use the Activate database button to create and activate it.
General section
The General section defines basic properties about your database.
The available settings vary according to your subscription plan:
Setting name | Description |
---|---|
Subscription | Read-only description of your subscription plan, including cloud provider and region |
Active-Active Redis | Checked when the subscription supports Active-Active databases (Flexible or Annual subscriptions only) |
Auto Tiering | Checked when the subscription supports Auto Tiering (Flexible or Annual subscriptions only) |
Database name | A name for your database (required) |
Database port | Automatically or manually assigns a database port (range: 10000-19999) (Flexible or Annual subscriptions only) |
Type | Controls advanced database capabilities and protocol. Supported values include Redis Stack (available only for Fixed and Free), Redis (default for Flexible and Annual subscriptions), and Memcached |
Advanced capabilities | Extend core Redis functionality using advanced capabilities. Redis Cloud supports selected advanced capabilities; for details, see Redis Enterprise and Redis Stack feature compatibility |
Supported Protocol(s) | Choose between RESP2 and RESP3 (Redis 7.2 only). See Redis serialization protocol for details |
Database port
All subscriptions automatically assign a database port by default.
Flexible (and Annual) subscriptions let you choose between two options:
- Auto assign automatically assigns a port number during database creation.
- Manually assign lets you enter a custom port number between 10000 and 19999. You cannot assign a port that is reserved or already in use.
Advanced capabilities
Advanced capabilities extend Redis database functionality by adding new data types and options.
Available options depend on your subscription and your database Type.
Fixed (and Free) advanced capability options
Fixed and Free subscriptions support Redis Stack, which enables the most frequently used capabilities.
When the database Type is set to Redis Stack, the Advanced capabilities section of the database details page displays the advanced capabilities included with the database and their versions.
Redis Cloud is updated on a regular basis, which includes the advanced capabilities supported by the service. Versions displayed by the admin console may vary from those shown above. For the latest details of any capability, see Redis Stack and Redis Enterprise.
Redis Stack is available only for Fixed and Free subscriptions.
Flexible and Annual advanced capability options
Flexible and Annual subscriptions let you choose advanced capabilities for each database.
You can select more than one advanced capability for a database, though there are limits:
-
The following advanced capabilities can be combined in Flexible and Annual subscriptions:
- Search and query
- JSON
- Time series
- Probabilistic
-
Graph cannot be combined with other capabilities.
-
JSON is the only capability supported for Active-Active subscriptions.
You don’t have to combine capabilities. To remove a selected capability, either clear the checkbox in the menu or select its Delete icon.
To learn more, see Redis Stack and Redis Stack and Redis Enterprise.
Scalability section
The Scalability section lets you manage the maximum size, throughput, and hashing policy for a database.
The Scalability section is available only for Flexible and Annual plans.
Setting name | Description |
---|---|
Memory limit | Maximum size (in GB) for your database. See Memory limit for sizing considerations. |
Throughput | Defines throughput in terms of maximum operations per second for the database. See Throughput for more information. |
Hashing policy | Defines the hashing policy. |
OSS Cluster API | Enables the OSS Cluster API for a database When this option is enabled, you cannot define a custom hashing policy. |
To learn more about these settings and when to use them, see Database clustering.
Memory limit
Memory limit represents the maximum amount of memory for the database, which includes data values, keys, module data, and overhead for specific features. High availability features, such as replication and Active-Active, dramatically increase memory consumption.
Here are some general guidelines:
-
Memory limit represents an upper limit. You cannot store more data than the memory limit. Depending on your other selections, available memory for data may be much less than expected.
-
Replication doubles memory consumption; that is, 512MB of data requires at least 1GB of memory limit when replication is enabled. This also affects Fixed plans. For example, if you subscribe to a 1 GB Fixed plan, Redis will allocate 512 MB for your dataset and the other 512 MB for replication.
-
Active-Active also doubles memory consumption and the effect is cumulative with replication’s impact. Since Active-Active requires replication to be turned on, the memory limit impact can be as large as four times (4x) the original data size.
-
Advanced capabilities also consume memory.
Memory limits in Redis Cloud are subject to the same considerations as Redis Enterprise Software; to learn more, see Database memory limits
Throughput
Throughput is the amount of operations a database can handle over a certain period of time. For most Redis Cloud databases, throughput is defined in operations per second (ops/sec).
We assume a typical workload that includes a different mix of commands and an average key and value size of 1KB. Therefore, your actual throughput may be higher or lower than the throughput you set when you create your database. The following properties can affect your database’s throughput:
- Command complexity: O(N) and O(log(N)) commands will take more time than O(1) commands, and will affect throughput accordingly.
- Key and value sizing: If your database’s keys and values are very large, your actual throughput may be lower than expected. If the keys and values are smaller than the typical workload, the actual throughput might be higher than expected.
- Replication: Using multi-zone replication affects throughput as each write operation is executed asynchronously in each zone.
- Security: Some security options, such as transport layer security, may affect throughput.
- Number of client connections: The number of client connections affects throughput. Increasing or decreasing the number of client connections can result in higher or lower throughput.
Databases with search and query enabled use the number of shards to determine throughput. To determine how many shards you need for your database, use the sizing calculator.
OSS Cluster API
Redis OSS Cluster API reduces access times and latency with near-linear scalability. The Redis OSS Cluster API provides a simple mechanism for Redis clients to know the cluster topology.
Clients must first connect to the master node to get the cluster topology, and then they connect directly to the Redis proxy on each node that hosts a master shard.
Review Redis OSS Cluster API architecture to determine if you should enable this feature for your database.
Durability section
The Durability section helps you keep your database (and your data) available when problems occur.
Setting name | Description |
---|---|
High availability | Replicates your data across multiple nodes, as allowed by your subscription plan |
Data persistence | Defines whether (and how) data is saved to disk; available options depend on your plan type |
Data eviction policy | Configures which policy is applied when your database reaches its memory limit |
Remote backup | (paid Fixed, Flexible, or Annual subscriptions only) When enabled, identifies a location and interval for data backups |
Active-Passive Redis | (Flexible or Annual subscriptions only) When enabled, identifies a path to the linked database. See Migrate data for more information. |
Tags section
The Tags section lets you add tags to the database.
Here, you can:
-
Select Add tag to add a tag.
You can select the tag’s Key and Value from the suggestions, or you can enter your own.
A valid tag must follow these guidelines:
- Tag keys must be between 2 and 64 characters long, and values must be at least 2 characters long.
- Tags can only have lowercase letters, numbers, spaces, and these special characters:
-
,_
,.
,+
,@
, and:
.
-
Select the Key or Value field of an existing tag and enter new text to edit it.
-
Select Delete next to a tag to delete it.
Security section
The Security section helps you control access to your database.
Setting name | Description |
---|---|
Default user | When enabled, permits access using a simple password |
Redis password | Password assigned to the database when created |
CIDR allow list | (paid Fixed, Flexible, or Annual subscriptions only) Allow list of IP addresses/security groups permitted to access the database |
Transport layer security (TLS) | (Flexible or Annual subscriptions only) Enables transport layer security (TLS) encryption for database access |
Alerts section
The Alerts section defines notification emails sent to your account and the conditions that trigger them.
The available alerts vary according to the subscription type.
Setting name | Description |
---|---|
Dataset size has reached | When enabled, sends an an email when the database reaches the defined memory limit (Flexible, or Annual plans only) |
Latency is higher than | When enabled, sends an an email when the latency exceeds the defined limit (paid Fixed, Flexible or Annual plans only) |
Number of connections | When enabled, sends an email when the connections exceeds the defined limit. (Free and Fixed plans only) |
Replica Of - database unable to sync with source | When enabled, sends email when the replica database cannot sync with the primary (source) database (Flexible or Annual plans only) |
Replica Of - sync lag is higher than | When enabled, sends email when the sync lag exceeds the defined threshold (Flexible or Annual plans only) |
Throughput is higher than | When enabled, sends an email when the operations per second exceed the defined threshold (paid Fixed, Flexible, or Annual plans only) |
Throughput is lower than | When enabled, sends an email when the operations per second falls below the defined threshold (paid Fixed, Flexible, or Annual plans only) |
Total size of datasets under this plan reached | When enabled, sends an an email when the combined total size of databases in the subscription reaches the defined memory limit (paid Fixed plans only) |