/ /

Atlas 集群中不支持的命令

本页面在以下章节中比较了 Free 集群、Flex 集群、M10+ Atlas Core 集群和 M10+ Atlas Infinite 集群的命令支持：

Unsupported Commands lists MongoDB commands and shell methods that Atlas doesn't support, organized by command category.
Unsupported Command Line Options lists mongodump and mongorestore options that Atlas doesn't support.
Limited Commands lists commands that Atlas supports with restrictions for each cluster type.

Atlas requires clients to authenticate to access an Atlas cluster. Atlas provides a curated list of Database User Privileges that grant access to a subset of MongoDB commands. The tables in the Unsupported Commands section list the commands that fall outside this subset for each cluster type.

Atlas Free、Flex 和 Infinite 集群不支持适用于其他集群的所有功能。要了解详情，请参阅：

不支持的命令

下表按集群类型列出了 Atlas 不支持的 MongoDB 命令、shell 方法和权限操作。为了确保集群的稳定性和性能，Atlas 自动执行了这些命令提供的功能。Atlas 会根据集群的层级或数据库版本限制其他命令。

表示集群类型不支持该命令。

注意

如果在 Free 集群和 Flex 集群中使用不支持的命令或无效语法，Atlas 会返回以下错误信息：

 <$command> is not allowed or the syntax is incorrect,
 see the Atlas documentation for more information.

要了解有关有效语法的更多信息，请参阅数据库命令

管理

命令	Shell 方法	特权操作
`applyOps`
`autoCompact`		`compact`
`cloneCollection`
`cloneCollectionAsCapped`
`compact`		`compact`
`dropConnections`		`dropConnections`
`enableFreeMonitoring`
`eval`	`db.eval()`
`fsync`	`db.fsyncLock()`	`fsync`
`fsyncUnlock`	`db.fsyncUnlock()`	`unlock`
`getAuditConfig`
`logApplicationMessage`		`applicationMessage`
`logRotate`		`logRotate`
`reIndex`		`reIndex`
`repairCursor`
`repairDatabase`
`rotateCertificates`		`rotateCertificates`
`setAuditConfig`
`setClusterParameter`
`setDefaultRWConcern`		`setDefaultRWConcern`
`setFeatureCompatibilityVersion`
`setIndexCommitQuorum`
`setLogLevel`
`setParameter`	`db.setLogLevel()` Others that use `setParameter`.	`setParameter`
`shutdown`	`db.shutdownServer()`	`shutdown`

聚合(Aggregation)

命令	Shell 方法	特权操作	Free 和 Flex	M10+ Core	M10+ Infinite
	`db.collection.getSearchIndexes()`
`mapReduce`
`shardedFinish`

身份验证

命令	Shell 方法	特权操作	Free 和 Flex	M10+ Core	M10+ Infinite
`authenticate`
`authSchemaUpgrade`
`copydbgetnonce`
`copydbsaslstart`

诊断

命令	Shell 方法	特权操作
`currentOpCtx`
`dataSize`
`dbHash`		`dbHash`
`forcerror`
`getDiagnosticData`
`getPrevError`
`handshake`
`hostInfo`
`lockInfo`
	`setProfilingLevel`
`validate`

查询计划缓存

命令	Shell 方法	特权操作	Free 和 Flex	M10+ Core	M10+ Infinite
`$planCacheStats`
`planCacheClear`
`planCacheClearFilters`
`planCacheListFilters`
`planCacheListPlans`
`planCacheListQueryShapes`
`planCacheSetFilter`
`$querySettings`
`removeQuerySettings`
`setQuerySettings`

复制

命令	Shell 方法	特权操作
`appendOplogNote`
`replSetDeclareElectionWinner`
`replSetElect`
`replSetFreeze`	`rs.freeze()`	`replSetStateChange`
`replSetFresh`
`replSetGetConfig`
`replSetGetRBID`
`replSetGetStatus`
`replSetHeartbeat`
`replSetInitiate`	`rs.initiate()`
`replSetMaintenance`		`replSetStateChange`
`replSetReconfig`	`rs.reconfig()`
`replSetResizeOplog`
`replSetRequestVotes`
`replSetStepDown`	`rs.stepDown()`	`replSetStateChange`
`replSetStepUp`
`replSetSyncFrom`	`rs.syncFrom()`	`replSetStateChange`
`replSetUpdatePosition`
`resync`		`resync`

会话

命令	Shell 方法	特权操作	Free 和 Flex	M10+ Core	M10+ Infinite
`killAllSessions`
`killAllSessionsByPattern`
`killAnySession`
`killSessions`
`$listLocalSessions`
`$listSessions`

分片

命令	Shell 方法	特权操作
`_migrateClone`
`_recvChunkAbort`
`_recvChunkCommit`
`_recvChunkStart`
`_recvChunkStatus`
`_transferMods`
	`sh.disableBalancing()` [1]
	`sh.enableBalancing()` [1]
`abortRewriteCollection`		`rewriteCollection`
`cleanupOrphaned`
`getShardMap`
`refineCollectionShardKey` [2]		`refineCollectionShardKey`
`removeShard`		`removeShard`
`reshardCollection`	`sh.reshardCollection()`	`reshardCollection`
`rewriteCollection`		`rewriteCollection`
`unshardCollection`	`sh.unshardCollection()`	`unshardCollection`

[1]	(1, 2) You can use `setAllowMigrations` to control the balancing of a specific collection.

[2]	只有全局写入集群不支持此命令。

用户和角色管理

注意

作为替代方案，请参阅可用的 Atlas 用户角色。

命令	Shell 方法	特权操作
`createRole`	`db.createRole()`	`createRole`
`createUser`	`db.createUser()`	`createUser`
`dropAllRolesFromDatabase`	`db.dropAllRoles()`	`dropRole`
`dropAllUsersFromDatabase`	`db.dropAllUsers()`	`dropUser`
`dropRole`	`db.dropRole()`	`dropRole`
`dropUser`	`db.dropUser()`	`dropUser`
`getUser` [3]	`db.getUser()` and `db.getUsers()` [3]
`grantPrivilegesToRole`
`grantRolesToRole`
`grantRolesToUser`	`db.grantRolesToUser()`	`grantRole`
`invalidateUserCache`		`invalidateUserCache`
`revokePrivilegesFromRole`	`db.revokePrivilegesFromRole()`	`revokeRole`
`revokeRolesFromRole`	`db.revokeRolesFromRole()`	`revokeRole`
`revokeRolesFromUser`	`db.revokeRolesFromUser()`	`revokeRole`
`updateRole`	`db.updateRole()`
`updateUser`	`db.updateUser()`
`usersInfo`

[3]	(1, 2) You can call `getUser` for your own user account.

不支持的命令行选项

Atlas 不支持以下命令行工具选项。表示集群类型不支持该选项。

选项	命令行工具	Free 和 Flex	M10+ Core	M10+ Infinite
--restoreDbUsersAndRoles	`mongorestore`
--oplogReplay	`mongorestore`
--preserveUUID	`mongorestore`
--dumpDbUsersAndRoles	`mongodump`
--oplog	`mongodump`

有限命令

Atlas 支持以下命令，但有一定限制。

Free 和 Flex

您可以在免费集群和 Flex 集群中有限制地运行以下命令：

命令

Limit

aggregate

将 maxTimeMs 参数限制为 300 秒 (300000)。
忽略allowDiskUse 参数。
Doesn't support $accumulator and $function operators.
Doesn't support the $$USER_ROLES system variable.

count

Doesn't support the $where operator.
Limits the count operation on the local database to the system.replset and oplog.rs collections.

dbStats

Free clusters and Flex clusters don't allow the dbStats command on the local and config databases.

要了解更多信息，请参阅运行限制。

distinct

Doesn't support $where operator.

find

Doesn't support the $where operator.
Doesn't support the $$USER_ROLES system variable.
忽略allowDiskUse 参数。
Limits the find operation on the local database to the oplog.rs collection.
Limits the find operation to using an equality condition when querying the ns field in the oplog.rs collection on the local database.
{ "ns" : "test.foo" }

getParameter

只允许对下面这两个文档执行此操作：

{ "getParameter": 1, "authSchemaVersion": 1 }
{ "getParameter": 1, "authenticationMechanisms": 1 }

db.killOp()

Limits the db.killOp() method to the MongoDB user who ran the operation.

collection.updateOne()

Doesn't support the $$USER_ROLES system variable.

collection.updateMany()

Doesn't support the $$USER_ROLES system variable.

findAndModify

Doesn't support the $$USER_ROLES system variable.

serverStatus

限制对以下字段的响应：

$clusterTime.clusterTime
$clusterTime.operationTime
$clusterTime.signature.hash
$clusterTime.signature.keyId
$clusterTime.signature
asserts.msg
asserts.regular
asserts.rollovers
asserts.user
asserts.warning
atlasVersion.gitVersion
atlasVersion.version
connections.available
connections.current
connections.totalCreated
extra_info.note
extra_info.page_faults
host
localTime
mem.bits
mem.mapped
mem.mappedWithJournal
mem.resident
mem.supported
mem.virtual
metrics.atlas.bytesInWrites
metrics.atlas.connectionPool.totalCreated
network.bytesIn
network.bytesOut
network.numRequests
ok
opcounters.command
opcounters.delete
opcounters.getmore
opcounters.insert
opcounters.query
opcounters.update
opcountersRepl.command
opcountersRepl.delete

opcountersRepl.getmore
opcountersRepl.insert
opcountersRepl.query
opcountersRepl.update
pid
process
repl.electionId
repl.hosts[]
repl.ismaster
repl.lastWrite.lastWriteDate
repl.lastWrite.majorityOpTime.t
repl.lastWrite.majorityOpTime.ts
repl.lastWrite.majorityWriteDate
repl.lastWrite.opTime.t
repl.lastWrite.opTime.ts
repl.me
repl.primary
repl.rbid
repl.secondary
repl.setName
repl.setVersion
repl.tags.nodeType
repl.tags.provider
repl.tags.region
repl.tags
storageEngine.backupCursorOpen
storageEngine.dropPendingIdents
storageEngine.name
storageEngine.oldestRequiredTimestampForCrashRecovery
storageEngine.persistent
storageEngine.readOnly
storageEngine.supportsCommittedReads
storageEngine.supportsPendingDrops
storageEngine.supportsSnapshotReadConcern
uptime
uptimeEstimate
uptimeMillis
version

M10+ Core

Atlas limits the db.killOp() method to the MongoDB user who ran the operation.

Atlas doesn't support the killAllSessions command unless the database user has:

the killAnySession privilege, or
the killOpSession role.

Atlas 仅支持对 M30+ 分片的 Atlas Core 集群使用以下分片命令。

命令	Shell 方法	特权操作
`abortRewriteCollection`		`rewriteCollection`
`reshardCollection`	`sh.reshardCollection()`	`reshardCollection`
`rewriteCollection`		`rewriteCollection`
`unshardCollection`	`sh.unshardCollection()`	`unshardCollection`

M10+ Infinite

Atlas limits the db.killOp() method to the MongoDB user who ran the operation.

Atlas doesn't support the killAllSessions command unless the database user has:

the killAnySession privilege, or
the killOpSession role.

Atlas Infinite clusters only support the profile command when the database profiler level is 0.

联系支持人员

如果使用案例需要访问 Atlas 数据库用户权限当前不支持的命令，请联系 Atlas 支持部门。