db.getCollectionInfos() (mongosh method方法)

Options选项

You can specify the following options in the options document of a db.getCollectionInfos() command:您可以在db.getCollectionInfo()命令的options文档中指定以下选项：

show collections

The mongosh method show collections is similar to:mongosh方法show collections类似于：

db.runCommand(
   {
       listCollections: 1.0,
       authorizedCollections: true,
       nameOnly: true
   }
)

• For users with the required access, show collections lists the non-system collections for the database.对于具有所需访问权限的用户，show collections列出了数据库的非系统集合。
• For users without the required access, show collections lists only the collections for which the users has privileges.对于没有所需访问权限的用户，show collections仅列出用户具有权限的集合。

Client Disconnection客户端断开连接

If the client that issued db.getCollectionInfos() disconnects before the operation completes, MongoDB marks db.getCollectionInfos() for termination using killOp.如果发出db.getCollectionInfos()的客户端在操作完成之前断开连接，MongoDB将使用killOp标记db.getCollectionInfos()以终止。

Replica Set Member State Restriction副本集成员状态限制

To run on a replica set member, listCollections operations require the member to be in PRIMARY or SECONDARY state. 要在副本集成员上运行，listCollections操作要求该成员处于PRIMARY或SECONDARY状态。If the member is in another state, such as STARTUP2, the operation errors.如果成员处于另一种状态，如STARTUP2，则操作错误。

Return Information for All Collections in a Database返回数据库中所有集合的信息

The following returns information for all collections in the example database:以下内容返回example数据库中所有集合的信息：

use example
db.getCollectionInfos()

   [
      {
         "name" : "employees",
         "type" : "collection",
         "options" : {
            "flags" : 1,
            "validator" : {
               "$or" : [
                  {
                     "phone" : {
                        "$exists" : true
                     }
                  },
                  {
                     "email" : {
                        "$exists" : true
                     }
                  }
               ]
            }
         },
         "info" : {
            "readOnly" : false,
            "uuid" : UUID("222e18ca-4a10-4a42-a8fe-c39255cc4c55")
         },
         "idIndex" : {
            "v" : 2,
            "key" : {
               "_id" : 1
            },
            "name" : "_id_",
            "ns" : "example.employees"
         }
      },
      {
         "name" : "products",
         "type" : "collection",
         "options" : {
            "flags" : 1
         },
         "info" : {
            "readOnly" : false,
            "uuid" : UUID("1bc898b2-3b91-45e4-9d8b-0be462d5a157")
         },
         "idIndex" : {
            "v" : 2,
            "key" : {
               "_id" : 1
            },
            "name" : "_id_",
            "ns" : "example.products"
         }
      },
      {
         "name" : "mylogs",
         "type" : "collection",
         "options" : {
            "capped" : true,
            "size" : 256
         },
         "info" : {
            "readOnly" : true,
            "uuid" : UUID("8e62116d-b6a0-490a-808c-258ccb7ea947")
         },
         "idIndex" : {
            "v" : 2,
            "key" : {
               "_id" : 1
            },
            "name" : "_id_",
            "ns" : "example.mylogs"
         }
      }
   ]

Return Only Collection Names仅返回集合名称

To return only the names of collections in the current database, specify the nameOnly: true option. For example:要仅返回当前数据库中集合的名称，请指定nameOnly: true选项。例如：

use example
db.getCollectionInfos( {}, { nameOnly: true } )

[
  { name: 'products', type: 'collection' },
  { name: 'weather', type: 'timeseries' },
  { name: 'system.buckets.weather', type: 'collection' },
  { name: 'system.views', type: 'collection' },
  { name: 'sales', type: 'collection' }
]

Return Information for a Specific Collection返回特定集合的信息

To request collection information for a specific collection, specify the collection name in the filter document. The following example returns an array with a single document that details the collection information for the employees collection in the example database.要请求特定集合的集合信息，请在筛选器文档中指定集合名称。以下示例返回一个包含单个文档的数组，该文档详细说明了example数据库中employees集合的集合信息。

use example
db.getCollectionInfos( { name: "employees" } )

[
   {
      "name" : "employees",
      "type" : "collection",
      "options" : {
         "flags" : 1,
         "validator" : {
            "$or" : [
               {
                  "phone" : {
                     "$exists" : true
                  }
               },
               {
                  "email" : {
                     "$exists" : true
                  }
               }
            ]
         }
      },
      "info" : {
         "readOnly" : false,
         "uuid" : UUID("222e18ca-4a10-4a42-a8fe-c39255cc4c55")
      },
      "idIndex" : {
         "v" : 2,
         "key" : {
            "_id" : 1
         },
         "name" : "_id_",
         "ns" : "example.employees"
      }
   }
]

Return Information for Read-Only Collections只读集合的返回信息

You can specify a filter on any of the fields returned by db.getCollectionInfos().您可以在db.getCollectionInfo()返回的任何字段上指定筛选器。

For example, the following command returns information for all collections in the example database where info.readOnly is true:例如，以下命令返回example数据库中所有集合的信息，其中info.readOnly为true：

use example
db.getCollectionInfos( { "info.readOnly" : true } )

[
   {
      "name" : "mylogs",
      "type" : "collection",
      "options" : {
         "capped" : true,
         "size" : 256
      },
      "info" : {
         "readOnly" : true,
         "uuid" : UUID("8e62116d-b6a0-490a-808c-258ccb7ea947")
      },
      "idIndex" : {
         "v" : 2,
         "key" : {
            "_id" : 1
         },
         "name" : "_id_",
         "ns" : "example.mylogs"
      }
   }
]