sh.enableSharding()（mongosh方法）

定义

sh.enableSharding(database, primaryShard): 注意
在版本6.0中进行了更改。
从 MongoDB 6.0 开始，不需要使用此方法来分片集合。
Explicitly creates a database. Use the mongosh method sh.shardCollection() to shard collections on the database. The mongosh method sh.enableSharding() wraps the enableSharding command.
重要
mongosh 方法
This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.
有关数据库命令，请参阅 enableSharding 命令。
如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

兼容性

此方法可用于以下环境中托管的部署：

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

重要

This command is not supported in M0 and Flex clusters. For more information, see Unsupported Commands.

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

The sh.enableSharding() has the following form:

sh.enableSharding(
   <database>,
   <primary shard>  // Optional.
)

Parameter

The sh.enableSharding() method takes the following parameter:

Parameter	类型	说明
database	字符串	要创建的数据库名称。
主分片	字符串	可选。数据库的主分片分片。它是数据库中所有未分片集合的默认分片片。警告：一般来说，您不应指定主分片。允许集群选择主分片分片。

行为

写关注

mongos uses "majority" for the enableSharding command and its helper sh.enableSharding().

主分片

In general, you should not need to specify the primaryShard in the command. Instead, allow the balancer to select the primary shard.

However, if you do specify the primary shard for a database and the database is already enabled for sharding with a different primary shard, the operation returns an error and the primary shard for the database remains as before. To change the primary shard for a database, use the movePrimary command instead.

例子

下面的示例从 mongos 运行，明确创建了 shardTest 数据库：

sh.enableSharding("shardTest")

要验证，请运行 sh.status()。

提示