mongofiles

在本页面

• Synopsis

• Required Access

• Options

• Commands

• Examples

• mongofiles

Synopsis

mongofilesUtil 使您可以从命令行操作存储在 MongoDB 实例GridFS对象中的文件。它提供了存储在文件系统中的对象与 GridFS 之间的接口，因此它特别有用。

所有mongofiles命令的格式如下：

mongofiles <options> <commands> <filename>

mongofiles命令的组件为：

• Options。您可以使用这些选项中的一个或多个来控制mongofiles的行为。

• Commands。使用以下命令之一确定mongofiles的操作。

• 文件名可以是：本地文件系统上的文件名或 GridFS 对象。

从系统命令行运行mongofiles，而不是mongo shell。

Required Access

为了连接到使用--auth选项强制执行授权的mongod，您必须使用--username和--password选项。连接用户必须至少拥有：

• 使用list，search或get命令时所访问数据库的read角色，

• 使用put或delete命令时，被访问数据库的readWrite角色。

Options

在 3.0.0 版中进行了更改：mongofiles删除了--dbpath以及相关的--directoryperdb和--journal选项。要使用mongofiles，您必须根据需要对正在运行的mongod或mongos实例运行mongofiles。

• --help ``

  • 返回有关 mongofiles 选项和用法的信息。

• --verbose `,` `-v`

  • 增加在标准输出或日志文件中返回的内部报告的数量。通过多次包含该选项(例如-vvvvv)来提高-v形式的详细程度。

• --quiet ``

  • 在安静模式下运行 mongofiles ，以尝试限制输出量。

此选项禁止显示：

• database commands的输出

• replication activity

• 连接接受的事件

• 连接关闭事件

• --version ``

  • 返回 mongofiles 版本号。

• --uri <connectionString>

  • 3.4.6 版中的新功能。

指定可解析的URI 连接字符串以连接到 MongoDB 部署。

--uri "mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

有关连接字符串的组成部分的更多信息，请参见连接字符串 URI 格式文档。

• --host <hostname><:port>
  • 指定保存 GridFS 系统的mongod的可解析主机名。默认情况下mongofiles尝试连接到在 localhost 端口号27017上运行的 MongoDB 进程。

(可选)指定端口号以连接在 27017 以外的端口上运行的 MongoDB 实例。

• --port <port>
  • 默认：27017

指定 MongoDB 实例在其上侦听 Client 端连接的 TCP 端口。

• --ipv6 ``
  • 已在 3.0 版中删除.

启用 IPv6 支持，并允许 mongofiles 使用 IPv6 网络连接到 MongoDB 实例。在 MongoDB 3.0 之前，您必须指定--ipv6才能使用 IPv6.在 MongoDB 3.0 和更高版本中，始终启用 IPv6.

• --ssl ``
  • 2.6 版的新功能。

启用与启用了 TLS/SSL 支持的mongod或mongos的连接。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslCAFile <filename>
  • 2.6 版的新功能。

指定包含来自证书颁发机构的根证书链的.pem文件。使用相对或绝对路径指定.pem文件的文件名。

从 3.4 版开始，如果未指定--sslCAFile或ssl.CAFile并且未使用 x.509 身份验证，则在连接到启用了 TLS/SSL 的服务器时将使用系统范围的 CA 证书存储。

如果使用 x.509 身份验证，则必须指定--sslCAFile或ssl.CAFile。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslPEMKeyFile <filename>
  • 2.6 版的新功能。

指定同时包含 TLS/SSL 证书和密钥的.pem文件。使用相对或绝对路径指定.pem文件的文件名。

使用--ssl选项连接到已启用CAFile且未启用allowConnectionsWithoutCertificates的mongod或mongos时，此选项是必需的。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslPEMKeyPassword <value>
  • 2.6 版的新功能。

指定用于解密证书密钥文件的密码(即--sslPEMKeyFile)。仅当证书密钥文件已加密时，才使用--sslPEMKeyPassword选项。在所有情况下， mongofiles 都会从所有日志记录和报告输出中删除密码。

如果 PEM 文件中的私钥已加密并且您未指定--sslPEMKeyPassword选项，则 mongofiles 将提示您 Importing 密码。参见TLS/SSL 证书密码短语。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslCRLFile <filename>
  • 2.6 版的新功能。

指定包含证书吊销列表的.pem文件。使用相对或绝对路径指定.pem文件的文件名。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslAllowInvalidCertificates ``
  • 2.6 版的新功能。

绕过服务器证书的验证检查，并允许使用无效的证书。使用allowInvalidCertificates设置时，MongoDB 将使用无效证书记录为警告。

从 MongoDB 3.6.6 开始，如果在使用 x.509 身份验证时指定--sslAllowInvalidCertificates或ssl.allowInvalidCertificates: true，则无效的证书仅足以构建 TLS/SSL 连接，而对于身份验证则“不足”。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslAllowInvalidHostnames ``
  • 3.0 版中的新功能。

禁用 TLS/SSL 证书中的主机名验证。允许 mongofiles 连接到 MongoDB 实例，即使其证书中的主机名与指定的主机名不匹配也是如此。

有关 TLS/SSL 和 MongoDB 的更多信息，请参阅为 TLS/SSL 配置 mongod 和 mongos和Client 端的 TLS/SSL 配置。

• --sslFIPSMode ``
  • 2.6 版的新功能。

指示 mongofiles 使用已安装的 OpenSSL 库的 FIPS 模式。您的系统必须具有符合 FIPS 的 OpenSSL 库，才能使用--sslFIPSMode选项。

• --username <username> , -u <username>
  • 指定用于对使用身份验证的 MongoDB 数据库进行身份验证的用户名。与--password和--authenticationDatabase选项结合使用。

• --password <password> , -p <password>
  • 指定用于对使用身份验证的 MongoDB 数据库进行身份验证的密码。与--username和--authenticationDatabase选项结合使用。

在版本 3.0.2 中进行了更改：要提示用户 Importing 密码，请传递不带--password的--username选项，或者像--password ""一样将空字符串指定为--password值。

• --authenticationDatabase <dbname>
  • 指定已在其中创建指定的--username的身份验证数据库。参见Authentication Database。

• --authenticationMechanism <name>
  • 默认：SCRAM-SHA-1

在 2.6 版中进行了更改：添加了对PLAIN和MONGODB-X509身份验证机制的支持。

在版本 3.0 中进行了更改：添加了对SCRAM-SHA-1身份验证机制的支持。将默认机制更改为SCRAM-SHA-1。

指定 mongofiles 实例用于对mongod或mongos进行身份验证的身份验证机制。

Value	Description
SCRAM-SHA-1	RFC 5802使用 SHA1 哈希函数的标准咸化挑战响应身份验证机制。
MONGODB-CR	MongoDB 质询/响应身份验证。 (* MongoDB 3.6 中已弃用*)
MONGODB-X509	MongoDB TLS/SSL 证书认证。
GSSAPI (Kerberos)	使用 Kerberos 的外部身份验证。此机制仅在MongoDB Enterprise中可用。
PLAIN(LDAP SASL)	使用 LDAP 的外部身份验证。您也可以使用PLAIN对数据库中的用户进行身份验证。 PLAIN以纯文本形式传输密码。此机制仅在MongoDB Enterprise中可用。

• --gssapiServiceName ``
  • 2.6 版的新功能。

使用GSSAPI/Kerberos指定服务的名称。仅当服务未使用默认名称mongodb时才需要。

此选项仅在 MongoDB Enterprise 中可用。

• --gssapiHostName ``
  • 2.6 版的新功能。

使用GSSAPI/Kerberos指定服务的主机名。 仅如果计算机的主机名与 DNS 解析的主机名不匹配。

此选项仅在 MongoDB Enterprise 中可用。

• --db <database> , -d <database>
  • 指定要在其上运行 mongofiles 的数据库的名称。

• --local <filename> , -l <filename>
  • 指定用于获取和放置操作的文件的本地文件系统名称。

在 mongofiles put 和 mongofiles get 命令中，必需的<filename>修饰符指向对象在 GridFS 中将具有的名称。 mongofiles假定这反映了本地文件系统上的文件名。此设置将覆盖此默认设置。

• --type <MIME>
  • 提供指定MIME类型来描述插入 GridFS 存储的文件的功能。 mongofiles在默认操作中省略了此选项。

仅与 mongofiles put 操作一起使用。

• --replace `,` `-r`
  • 更改 mongofiles put 的行为，以使用指定的本地文件替换现有的 GridFS 对象，而不是添加具有相同名称的其他对象。

在默认操作中， mongofiles put 选项不会覆盖文件。

• --prefix string
  • 默认：fs

要使用的 GridFS 前缀。

• --writeConcern <document>
  • 默认：多数

为 mongofiles 执行的每个写操作指定write concern。

使用w options将写关注点指定为文档。例如：

--writeConcern "{w:'majority'}"

Commands

• list <prefix>

  • 列出 GridFS 存储中的文件。 list之后指定的字符(例如<prefix>)可以选择将返回的项目列表限制为以该字符串开头的文件。

• search <string>

  • 列出 GridFS 存储中名称与<string>的任何部分匹配的文件。

• put <filename>

  • 将指定的文件从本地文件系统复制到 GridFS 存储中。

在这里，<filename>表示对象在 GridFS 中将具有的名称，而mongofiles假定这反映了文件在本地文件系统上具有的名称。如果本地文件名不同，请使用mongofiles --local选项。

• get <filename>

  • 将指定的文件从 GridFS 存储复制到本地文件系统。

<filename>表示对象在 GridFS 中将具有的名称。 mongofiles使用 GridFS 中的文件filename将文件写入本地文件系统。要为本地文件系统上的文件选择其他位置，请使用--local选项。

• get_id "<ObjectId>"

  • 3.2.0 版中的新功能。

将指定的文件从 GridFS 存储复制到本地文件系统。

<ObjectId>表示 GridFS 中对象的扩展 JSON _id。 mongofiles使用 GridFS 中的文件filename将文件写入本地文件系统。要为本地文件系统上的文件选择其他位置，请使用--local选项。

• delete <filename>

  • 从 GridFS 存储中删除指定的文件。

• delete_id "<ObjectId>"

  • 3.2.0 版中的新功能。

从 GridFS 存储中删除指定的文件。使用文件_id指定文件。

Examples

要返回records数据库中GridFS集合中所有文件的列表，请在系统 Shell 上使用以下调用：

mongofiles -d records list

此mongofiles实例将连接到27017 localhost 接口上运行的mongod实例，以在不同的端口或主机名上指定相同的操作，并发出类似于以下命令之一的命令：

mongofiles --port 37017 -d records list
mongofiles --host db1.example.net -d records list
mongofiles --host db1.example.net --port 37017 -d records list

如果要在其他端口或主机上连接mongod实例，请根据需要修改以下任何命令。

要将名为32-corinth.lp的文件上载到records数据库中的 GridFS 集合，可以使用以下命令：

mongofiles -d records put 32-corinth.lp

要从records数据库中的此 GridFS 集合中删除32-corinth.lp文件，可以使用以下命令：

mongofiles -d records delete 32-corinth.lp

要在records数据库的 GridFS 集合中搜索名称中带有字符串corinth的文件，可以使用以下命令：

mongofiles -d records search corinth

要列出records数据库中以字符串32开头的 GridFS 集合中的所有文件，可以使用以下命令：

mongofiles -d records list 32

要从名为records的records数据库中的 GridFS 集合中获取文件，可以使用以下命令：

mongofiles -d records get 32-corinth.lp

要使用_id: ObjectId("56feac751f417d0357e7140f")从records数据库中的 GridFS 集合中获取文件，可以使用以下命令：

mongofiles -d records get_id 'ObjectId("56feac751f417d0357e7140f")'

您必须在_id前后加上引号。