From 817d2a9bf1366b1d84bf577a05b9381fde54e58c Mon Sep 17 00:00:00 2001
From: Cameron Bates <102550101+cmilesb@users.noreply.github.com>
Date: Mon, 4 Mar 2024 14:28:51 -0500
Subject: [PATCH] RC: Add information as to why throughput may vary to the
create database page (#3154)
* first draft
* show replication part
* Update content/rc/databases/create-database.md
Co-authored-by: mich-elle-luna <153109578+mich-elle-luna@users.noreply.github.com>
---------
Co-authored-by: mich-elle-luna <153109578+mich-elle-luna@users.noreply.github.com>
---
content/rc/databases/create-database.md | 15 +++++++++++++--
.../subscriptions/create-flexible-subscription.md | 2 +-
2 files changed, 14 insertions(+), 3 deletions(-)
diff --git a/content/rc/databases/create-database.md b/content/rc/databases/create-database.md
index 73b4c4adb01..dfa9c9ba356 100644
--- a/content/rc/databases/create-database.md
+++ b/content/rc/databases/create-database.md
@@ -114,8 +114,8 @@ The **Scalability** section is available only for Flexible and Annual plans.
| Setting name | Description |
|:--------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Memory limit** | Maximum size (in GB) for your database. |
-| **Throughput** | Defines throughput in terms of maximum operations per second for the database
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](https://redis.com/modules/redis-search/redisearch-sizing-calculator/). |
+| **Memory limit** | Maximum size (in GB) for your database. See [Memory limit](#memory-limit) for sizing considerations. |
+| **Throughput** | Defines throughput in terms of maximum operations per second for the database. See [Throughput](#throughput) for more information. |
| **Hashing policy** | Defines the [hashing policy]({{< relref "/rc/databases/configuration/clustering#manage-the-hashing-policy" >}}). |
| **OSS Cluster API** | Enables the [OSS Cluster API](#oss-cluster-api) for a database
When this option is enabled, you cannot define a custom hashing policy. |
@@ -137,6 +137,17 @@ Here are some general guidelines:
Memory limits in Redis Cloud are subject to the same considerations as Redis Enterprise Software; to learn more, see [Database memory limits]({{< relref "/rs/databases/memory-performance/memory-limit.md" >}})
+### 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).
+
+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](https://redis.com/modules/redis-search/redisearch-sizing-calculator/).
+
+Your actual throughput may not match the throughput you set when you create your database. The following things 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, setting and reading those keys may take more time and affect throughput.
+- **Replication**: Using [multi-zone replication]({{}}) affects throughput as each write operation is executed asynchronously in each zone.
+
### OSS Cluster API
{{< embed-md "oss-cluster-api-intro.md" >}}
diff --git a/content/rc/subscriptions/create-flexible-subscription.md b/content/rc/subscriptions/create-flexible-subscription.md
index 6bc18567c0c..900a7de0cbc 100644
--- a/content/rc/subscriptions/create-flexible-subscription.md
+++ b/content/rc/subscriptions/create-flexible-subscription.md
@@ -143,7 +143,7 @@ Select **More options** to specify values for the following settings.
| Database option | Description |
|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **OSS Cluster API** | Enable to use the open-source Redis Cluster API. |
+| **OSS Cluster API** | Enable to use the [Redis OSS Cluster API]({{< relref "/rc/databases/create-database#oss-cluster-api" >}}). |
| **Type** | Set to **Redis**, otherwise **Memcached** database for legacy database support. |
| **Supported Protocol(s)** | Choose between RESP2 and RESP3 _(Redis 7.2 only)_. See [Redis serialization protocol](https://redis.io/docs/reference/protocol-spec/#resp-versions) for details |
| **Quantity** | Number of databases to create with these settings. |