diff --git a/docs/reference/_common/reference-toc.rst b/docs/reference/_common/reference-toc.rst index 16bfc463f9ec..607c2a30cda2 100644 --- a/docs/reference/_common/reference-toc.rst +++ b/docs/reference/_common/reference-toc.rst @@ -7,5 +7,6 @@ GCP Images Configuration Parameters Glossary + Limits API Reference (BETA) Metrics (BETA) \ No newline at end of file diff --git a/docs/reference/index.rst b/docs/reference/index.rst index 6285f53caaa9..08cbdd032617 100644 --- a/docs/reference/index.rst +++ b/docs/reference/index.rst @@ -12,6 +12,7 @@ Reference * :doc:`GCP Images ` * :doc:`Configuration Parameters ` - ScyllaDB properties configurable in the ``scylla.yaml`` configuration file. * :doc:`Glossary ` - ScyllaDB-related terms and definitions. +* :doc:`Limits ` * :doc:`API Reference (BETA) ` * :doc:`Metrics (BETA) ` * .. scylladb_include_flag:: enterprise-vs-oss-matrix-link.rst diff --git a/docs/reference/limits.rst b/docs/reference/limits.rst new file mode 100644 index 000000000000..6b4a228ae88c --- /dev/null +++ b/docs/reference/limits.rst @@ -0,0 +1,75 @@ +============== +Limits +============== + +This document provides hard and soft limits in ScyllaDB. + +Cluster and Node Limits +----------------------------- + +.. list-table:: + :widths: 50 50 + :header-rows: 1 + + * - Component + - Limit + * - Nodes per cluster + - Low hundreds + * - Node size + - 256 vcpu + +See :ref:`Hardware Requirements ` for storage +and memory requirements and limits. + +CQL Limits +-------------- + +.. list-table:: + :widths: 50 50 + :header-rows: 1 + + * - Component + - Limit + * - Keyspaces per cluster + - Thousands (tested with 1000) + * - Tables per keyspace + - Low thousands (tested with 5000) + * - Tables per cluster (including indexes) + - Thousands + * - Tables with CDC enabled + - No limit. CDC can be enabled for all tables in a cluster. + * - Materialized views and secondary indexes per table + - Low tens + * - Columns per table + - Hundreds + * - Columns per cluster + - Tens of thousands + * - Partition size + - Gigabytes + * - Rows per partition + - No limit + * - Row size + - Latency-related soft limit: + + Hundreds of kilobytes (good latency) or megabytes (mediocre latency) + * - Key length + - 65533 + * - Table / CF name length + - 48 characters + * - Keyspace name length + - 48 characters + * - Query parameters in a query + - 65535 (2^16-1) + * - Statements in a batch + - 65535 (2^16-1) + * - Fields in a tuple + - 32768 (2^15) (just a few fields, such as 2-10, are recommended) + * - Collection (List) + - ~2 billion (2^31) + * - Collection (Set) + - ~2 billion (2^31) + * - Collection (Map) + - Number of keys: 65535 (2^16-1) + * - Blob size + - 2 GB ( less than 1 MB is recommended) + \ No newline at end of file