中文文档

mc od

语法

mc od 命令将本地文件分块并按指定的部分和部分大小复制到远程位置。 该命令输出了上传文件所花费的时间。

使用 mc od 命令模仿 Linux dd 命令的功能。

以下命令将文件的前200MiB上传到存储桶中,分为5个部分,每部分大小为40MiB。 输出显示了上传的结果,包括上传完成所需的时间长度。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB parts=5

如果传递了 --json 全局标志,该命令的输出将与以下类似:

{
  "source": "home/user/file.zip"
  "target": "myminio/mybucket/file.zip"
  "partSize": 41943040
  "totalSize": 209715200
  "parts": 5
  "elapsed": "314ms"
}

该命令具有以下语法:

mc [GLOBALFLAGS] od                                            \
                 if=<path of source file to upload>            \
                 of=<target MinIO path to upload to>           \
                 [size=<size of file>]                         \
                 [parts=<number of parts to split file into>]  \
                 [skip=<number of parts to skip>]
  • 方括号 [] 表示可选参数。

  • 参数在同一行表示它们是相互依赖的。

  • 使用管道 | 运算符分隔的参数是相互排斥的。

在终端/壳中运行命令之前,将示例复制到文本编辑器中并按需进行修改。

参数

if
Required

用于上传的源对象的路径。 使用相对于您当前位置的完整路径。

mc od if=file.zip of=myminio/mybucket/file.zip
of
Required

上传对象到的完整目标路径。

size
Optional

每个文件部分的尺寸(大小)用于上传。 如果未指定,MinIO 会从源流中确定部分的大小。

parts
Optional

上传对象时分成的部分数量。 如果未指定,MinIO 会根据源流的大小来确定部分的数量。

skip
Optional

在上传过程中跳过的文件部分的数量。 例如,使用这个选项来测试大型文件的许多部分在上传过程中的速度,只针对对象的部分部分进行测试。

全局标记

此命令支持任何 全局标志

示例

上传包含 40MiB 部分的完整文件

使用mc命令行工具的 mc od 命令,可以将文件分批上传到 MinIO,每批的大小可以指定。 size 选项允许您指定所需的分片大小。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB
  • myminio/mybucket/file.zip 替换为要上传的对象或文件流的路径。

  • size 替换为对象分片的目标大小。

MinIO检查源文件并将其分成所需的多个部分,以确保没有任何一部分大于指定的40MiB部分大小。

上传一个文件的第一个5个40 MiB的部分。

使用 mc od 将文件的部分以指定的部分大小上传到 MinIO。 size 选项允许您指定所需的部分大小。 parts 选项允许您指定用于对象的总部分数。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB parts=5
  • myminio/mybucket/file.zip 替换为要上传的对象或文件流的路径。

  • size 替换为对象分片的目标大小。

  • parts 替换为要为对象使用的所需部分数。

在这个命令示例中,如果源对象流大于200MiB(5个40MiB的部分),则只上传文件的前200MiB。

重要

以这种方式使用命令可能无法上传整个对象。

分 5 部分上传完整文件

取一个源文件,将其分成指定数量的部分,然后将文件的的所有部分上传到MinIO目标。

mc od if=file.zip of=myminio/mybucket/file.zip parts=5

上述命令将源文件分成五个相等的部分,然后上传这些部分。

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的,并且已经过测试, 以确保在与 MinIO 和 AWS S3 配合使用时,功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证,因为它们的 S3 API 实现是 未知的,因此不受支持。尽管 mc 命令 可能 如文档中所 述工作,但任何此类使用都是您自己的风险。

Join Slack 商业支持购买咨询