tencent cloud

TencentDB for MongoDB

Release Notes and Announcements
Release Notes
Announcements
User Guide
Product Introduction
Overview
Strengths
Use Cases
Cluster Architecture
Product Specifications
Features
Regions and AZs
Terms
Service Regions and Service Providers
Purchase Guide
Billing Overview
MongoDB Pricing
Billing Formula
Payment Overdue
Backup Space Billing
Configuration Adjustment Billing
Getting Started
Quickly Creating an Instance
Connecting to a TencentDB for MongoDB Instance
Reading/Writing Database
Operation Guide
Access Management
Instance Management
Node Management
Version Upgrade
Network Configuration
Monitoring
Backup and Rollback
Database Audit
Data Security
SSL Authentication
Log Management
Database Management
Multi-AZ Deployment
Disaster Recovery/Read-Only Instances
Parameter Configuration
Recycle Bin
Task Management
Performance Optimization
Data Migration Guide
Practical Tutorial
Optimizing Indexes to Break Through Read/Write Performance Bottlenecks
Troubleshooting Mongos Load Imbalance in Sharded Cluster
Considerations for Using Shard Clusters
Sample of Reading and Writing Data in MongoDB Instance
Methods for Importing and Exporting Data Based on CVM Connected with MongoDB
What to Do for Errors of Repeated Instance Creation and Deletion of Databases with the Same Names?
Troubleshooting MongoDB Connection Failures
Shard Removal Task: Guide for Confirming the Progress and Troubleshooting Issues
Performance Fine-Tuning
Ops and Development Guide
Development Specifications
Command Support in Sharded Cluster v3.2
Command Support in v3.6
Development Ops
Troubleshooting
Increased Slow Queries
Number of Connections Exceeding Limit
API Documentation
History
Introduction
API Category
Making API Requests
Instance APIs
Backup APIs
Account APIs
Other APIs
Task APIs
Introduction
Data Types
Error Codes
Instance Connection
Shell Connection Sample
PHP Connection Sample
Node.js Connection Sample
Java Connection Sample
Python Connection Sample
Python Read/Write Sample
Go Connection Sample
PHP Reconnection Sample
Product Performance
Test Environment
Test Method
Test Result
FAQs
Cost
Features
Sharded Cluster
Instance
Rollback and Backup
Connection
Data Migration
Others
Service Agreement
Service Level Agreement
Terms of Service
Glossary
Contact Us

Adding a Shard

PDF
Focus Mode
Font Size
Last updated: 2026-02-25 11:24:21

Scenarios

Adjusting the shard quantity is a core operation for achieving elastic scaling of a sharded cluster. When business enters a period of rapid growth, with continuously increasing data volume or a surge in read/write concurrency, the existing sharded cluster may encounter performance bottlenecks. As a result, the request latency will increase and throughput will reach the limit. Increasing the shard quantity distributes data and requests across more resources, enabling horizontal scaling. This enhances the cluster's overall data processing capability and concurrent performance, thus helping you easily handle business peaks.

Impacts and Constraints

Before adjusting the shard quantity, please carefully read the following key information to ensure that the operation meets expectations and does not impact service stability.
Dimension
Shard Addition
Billing Impact

Yearly/monthly subscription: The price difference between the new and original specifications will be settled. At the next renewal cycle, charges will be based on the new specifications.
Pay-as-you-go: Charges for the original specifications will be settled, and billing restarts based on the new specifications.
For the detailed billing information, see Configuration Adjustment Billing.
Version Requirement
General Edition: TencentDB for MongoDB 3.6 and later.
Cloud Disk Edition: TencentDB for MongoDB 4.0 and later.
It is recommended to use the latest stable version for optimal performance.
Service Impact
During the operation, no service interruption will occur and database read and write operations are normal.
Newly added shards automatically participate in data distribution.
Limits and Constraints
The operation is irreversible. Once submitted, it cannot be canceled midway.
Concurrent tasks are prohibited. Shard removal must be performed separately.

Prerequisites

Instance type: sharded instance.
Instance status: running (normal).
Please ensure that your Tencent Cloud account has sufficient balance.

Adding a Shard

2. In the MongoDB drop-down list on the left sidebar, select Shard Instance.
3. Above the Instance List page on the right, select the target region.
4. In the instance list, find the target instance.
5. Click Instance ID of the instance to go to the Instance Details page and click the Node Management tab.
6. On the Mongod Node tab on the Node Management tab, click Add Shard.

7. In the Add Shard dialog box, review the considerations for increasing the number of shards and refer to the table below to specify the number of shards to be added and confirm the cost.

Parameter Category
Parameter Name
Example
Description
Basic Instance Information
Instance Name
test-4dot2-XXX
Name of the instance for which the shard quantity is to be increased.
Expiration Time
2022-04-24 19:23:43
Service expiration time of a yearly/monthly subscription instance.
Instance Architecture
A sharded cluster instance that has 3 shards, each with 4 nodes, among which there is 1 read-only node
Cluster architecture of the instance: sharded cluster instance.
Shard quantity: shard quantity before removal.
Nodes per shard: number of nodes per shard and number of read-only nodes.
Node Specification
2 cores, 4 GB memory, 50 GB storage, 12 nodes in total, including 3 read-only nodes
Single shard node specification: including CPU cores, memory, and storage capacity.
Total number of cluster nodes: total number of nodes in the instance before addition (Number of shards x Nodes per shard = Total number of cluster nodes).
Configuration Upgrade
Add Shard
3
Select the number of shards to be added for the instance. Value range: [Current number of shards, 36].
Cost Information
Fees
6.69 CNY/hour
Pay-as-you-go: The hourly billing rate after shard addition for the instance will be displayed.
Yearly/monthly subscription: The price difference you need to pay for the upgrade to the new specifications will be displayed.
For billing details after configuration adjustments, see Configuration Adjustment Billing.
8. After confirming the details, click OK. If the instance uses yearly/monthly subscription billing, you must pay the price difference between the original and new specifications on the Confirm Product Information page to successfully complete the configuration upgrade.

Related APIs

API
Description
Adjusts the cloud database instance configurations
Queries the sales specifications of cloud databases

Help and Support

Was this page helpful?

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

Feedback