Release Notes and Announcements

Release Notes

Announcements

User Tutorial

Product Introduction

Overview

Product Strengths

Use Cases

Storage Engine

Product Series

Product Versions

Specifications and Performance

Read/Write Separation

Multi-AZ Deployment

Regions and AZs

Terms

Service Regions and Service Providers

Purchase Guide

Billing Overview

Pricing Center

Instance Purchasing

Renewal (Yearly/Monthly Subscription)

Refund (Yearly/Monthly Subscription)

Overdue Payments

Switching from Pay-as-You-Go to Yearly/Monthly Subscription

Getting Started

Quickly Creating an Instance

Connecting to Redis Instance

Operation Guide

Operation Overview

Connecting to a Database Instance

Managing Instances

Upgrade Instance

Management Node (Redis/ValKey Edition)

Multi-AZ Deployment Management

Backup and Restoration

Managing Accounts

Parameter Configuration

Slow Query

Access Management

Network and Security

Monitoring and Alarms

Event Management (Redis/ValKey Edition)

Data Migration

Global Replication for Redis Edition

Performance Optimization

Sentinel Mode

Development Guidelines

Naming Rules

Basic Usage Guidelines

Design Principles of Key and Value

Command Usage Guidelines

Design Principles of Client Programs

Connection Pool Configuration

Command Reference

Command Reference Overview

Redis Edition and Valkey Edition Command Compatibility

Version Command Usage Differences

Differences Between the Proxy Architecture and Direct Connection Mode

More Command Operations (Redis/Valkey Edition)

Memcached Edition Command Compatibility

Practical Tutorial

Building TencentDB for Redis® Client Monitoring Based on Spring Boot

Redis Client Connection Configuration Policy and Practice

Global SCAN Guide for Cluster Architecture

Eliminating Instances Securely

Hot Key and Big Key

AZ Migration Scheme

Troubleshooting

Connection Exception

Exception Analysis and Solution of Redisson Client Timeout Reconnection

Performance Troubleshooting and Fine-Tuning

API Documentation

History

Introduction

API Category

Making API Requests

Instance APIs

Parameter Management APIs

Other APIs

Backup and Restoration APIs

Region APIs

Monitoring and Management APIs

Log APIs

Data Types

Error Codes

FAQs

General

Connection and Login

Purchase

Service Agreement

Service Level Agreement

Glossary

Overview

PDF

Focus Mode

Font Size

Last updated: 2026-03-18 11:44:48

Tencent Cloud Distributed Cache Database is compatible with both Redis and Memcached protocols, featuring high availability, reliability, and scalability.
Storage Engine
Tencent Cloud Distributed Cache supports the following three storage engines. For more information, see storage engine.
Storage Engine
Compatible Version
Description
Redis Edition
4.0,5.0,6.2,7.0
Fully compatible with the Redis protocol, it provides a mature and stable caching solution.
Valkey Edition
8.0
Compatible with the Redis protocol, as an open-source branch of Redis, it provides performance optimizations.
Memcached Edition
1.6
Compatible with the Memcached protocol, designed specifically for caching scenarios.
Architecture Version
It provides both Standard Edition and Cluster Edition architectures to meet business needs of different scales. For more information, see Product Series.
Architecture
Feature
Scenarios
Standard architecture
Master-Slave Architecture: Using a two-node master-slave architecture, with the primary node and secondary node deployed on different physical servers.
Replica Configuration: Supports 1 to 5 replicas (secondary nodes).
Proxy Component: Built-in Proxy component responsible for request routing and load balancing.
Capacity Specifications: A single instance supports 0.25GB to 64GB.
Cluster Mode: Automatic data synchronization between primary and secondary nodes.
General caching services requiring data reliability and availability.
Cluster Architecture
Distributed Architecture: Built on the community edition Redis Cluster.
Shard Scaling: Supports horizontal scaling from 1 to 128 shards.
Replica Scaling: Supports 1 to 5 replica.
Proxy Component: Built-in Proxy component responsible for request routing, load balancing, and cross-shard command processing.
Shard Specifications: Provides multiple specifications ranging from 1GB to 64GB.
Cluster Mode: Automatic sharding, data balancing, and data migration.
Distributed caching services requiring large-capacity storage and high-concurrency performance.
Key Strengths
Tencent Cloud Distributed Cache offers high availability, elastic scaling, and intelligent O&M as core capabilities, ensuring stable and reliable caching for businesses.
High Availability
Based on Tencent Cloud's self-developed high-availability system, it provides cross-device and cross-AZ disaster recovery capabilities, enabling automatic switch within seconds during failures to ensure stable business operations.
Standard architecture: A multi-replica mode with one primary node and multiple replicas (such as 1 primary node and 5 replicas) is supported, providing auto-failover to effectively prevent a single point of failure and ensure business continuity.
Cluster architecture: Each shard independently implements primary-secondary replication, with automatic isolation and failover for shard-level failures, ensuring other shards remain unaffected.
Elastic Scale-Out
Both horizontal and vertical elastic scaling are supported, with a smooth scaling process that ensures continuous business operations and helps you easily handle business traffic peaks and sustained data growth.
Multi-dimensional scale-out: It supports horizontal scale-out of shards (for performance improvement) and vertical scale-out of replicas (for read capability enhancement), with built-in automatic read-write separation.
Automated Ops: During shard scaling, data automatically migrates between nodes, significantly reducing the complexity and risks of Ops.
Deep Intelligent Monitoring
It provides multi-dimensional monitoring metrics from the Proxy layer to the engine layer, along with built-in diagnostic analysis tools, helping you move from reactive troubleshooting to proactive performance optimization, making it easier to identify and resolve performance bottlenecks.
Multi-dimensional monitoring: Through multi-channel collection at the Proxy and engine layers, it provides comprehensive monitoring metrics, including performance, latency, network, capacity, and hit rate.
Visual insights: It presents complex performance data through intuitive charts, enabling you to easily grasp the health status and operational trends of instances.
Autonomous diagnostic analysis: It features built-in advanced capabilities such as hot Key collection, big Key analysis, and latency analysis to automatically identify common performance issues.
Key Concepts
The following are the core terms of Tencent Cloud Distributed Cache, helping you quickly grasp the product architecture and features.
Concept
Description
Instance.
A database environment that runs independently in Tencent Cloud, where an instance can contain multiple user-created databases.
Replica
A replica is a data backup node for the primary node, used for data redundancy and failover.
Shard
A shard is the smallest data storage unit in a cluster, consisting of a set of primary/secondary nodes, used for data distribution and horizontal scaling.
Node
The basic operational unit within an instance, categorized into master nodes (Master) and replica nodes (Replica).
Proxy
The proxy layer is responsible for request forwarding, routing, and load balancing.
Region
The instance is located on the Tencent Cloud region.
Availability Zone
A physical area within the same region with independent power and network.
VPC
A user-defined virtual network space that is logically isolated from other resources.
Security Group
A virtual firewall that performs security access control for instances, specifying IP address, protocol, and port rules.
Console
Tencent Cloud provides a visual management interface that enables users to perform management tasks, including instance creation, configuration, monitoring, and operations, via a web page.
Horizontal scaling (shard scaling)
Increasing the number of shards enhances the overall performance and capacity of the instance.
Vertical scaling (replica scaling)
By increasing the number of replicas to enhance the read capacity of the instance.
Read-write separation
In scenarios with more reads than writes, the primary node handles write requests while replica nodes offload read requests.
Project
Tencent Cloud provides a resource management approach to group cloud products by business or team, facilitating unified management and permission control.
Start Now
1. Configure a Tencent Cloud Distributed Cache database instance and specify the following key parameters based on your business requirements:
Select a region and an AZ.
Select a storage engine (Redis/Valkey/Memcached).
Select the architecture edition (Standard Architecture/Cluster Architecture).
Set the memory capacity and the number of shards.
Configure the network and security group.
For specific operations, see Quick Instance Creation.
2. Obtain the instance connection address, connect to the database instance via a client, and perform basic read and write operations. For specific operations, see Connecting to an Instance.
3. Monitor the instance status and test database performance. For specific testing methods, see Specifications and Performance.

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

Overview

Storage Engine

Architecture Version

Key Strengths

High Availability

Elastic Scale-Out

Deep Intelligent Monitoring

Key Concepts

Start Now

Help and Support

Storage Engine	Compatible Version	Description
Redis Edition	4.0,5.0,6.2,7.0	Fully compatible with the Redis protocol, it provides a mature and stable caching solution.
Valkey Edition	8.0	Compatible with the Redis protocol, as an open-source branch of Redis, it provides performance optimizations.
Memcached Edition	1.6	Compatible with the Memcached protocol, designed specifically for caching scenarios.

Architecture	Feature	Scenarios
Standard architecture	Master-Slave Architecture: Using a two-node master-slave architecture, with the primary node and secondary node deployed on different physical servers. Replica Configuration: Supports 1 to 5 replicas (secondary nodes). Proxy Component: Built-in Proxy component responsible for request routing and load balancing. Capacity Specifications: A single instance supports 0.25GB to 64GB. Cluster Mode: Automatic data synchronization between primary and secondary nodes.	General caching services requiring data reliability and availability.
Cluster Architecture	Distributed Architecture: Built on the community edition Redis Cluster. Shard Scaling: Supports horizontal scaling from 1 to 128 shards. Replica Scaling: Supports 1 to 5 replica. Proxy Component: Built-in Proxy component responsible for request routing, load balancing, and cross-shard command processing. Shard Specifications: Provides multiple specifications ranging from 1GB to 64GB. Cluster Mode: Automatic sharding, data balancing, and data migration.	Distributed caching services requiring large-capacity storage and high-concurrency performance.

Concept	Description
Instance.	A database environment that runs independently in Tencent Cloud, where an instance can contain multiple user-created databases.
Replica	A replica is a data backup node for the primary node, used for data redundancy and failover.
Shard	A shard is the smallest data storage unit in a cluster, consisting of a set of primary/secondary nodes, used for data distribution and horizontal scaling.
Node	The basic operational unit within an instance, categorized into master nodes (Master) and replica nodes (Replica).
Proxy	The proxy layer is responsible for request forwarding, routing, and load balancing.
Region	The instance is located on the Tencent Cloud region.
Availability Zone	A physical area within the same region with independent power and network.
VPC	A user-defined virtual network space that is logically isolated from other resources.
Security Group	A virtual firewall that performs security access control for instances, specifying IP address, protocol, and port rules.
Console	Tencent Cloud provides a visual management interface that enables users to perform management tasks, including instance creation, configuration, monitoring, and operations, via a web page.
Horizontal scaling (shard scaling)	Increasing the number of shards enhances the overall performance and capacity of the instance.
Vertical scaling (replica scaling)	By increasing the number of replicas to enhance the read capacity of the instance.
Read-write separation	In scenarios with more reads than writes, the primary node handles write requests while replica nodes offload read requests.
Project	Tencent Cloud provides a resource management approach to group cloud products by business or team, facilitating unified management and permission control.