文档

mc od

语法

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

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

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

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>]
  • 方括号 [] 表示可选参数。

  • 同一行上的参数是相互依赖的。

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

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

参数

if
必需

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

mc od if=file.zip of=myminio/mybucket/file.zip
of
必需

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

size
可选

要上传的文件每个部分的大小。如果未指定,MinIO 会根据源流确定部分的大小。

parts
可选

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

skip
可选

在上传过程中跳过的文件部分数量。例如,使用此选项仅测试对象部分一部分的大文件的上传速度。

全局标志

此命令支持任何全局标志

示例

上传具有 40 MiB 部分的完整文件

使用 mc od 将文件上传到 MinIO 中的一组指定大小的部分。 size 选项允许您指定所需的部分大小。

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

  • size 替换为所需的对象部分大小。

MinIO 检查源文件并将其划分为必要数量的部分,以便任何部分都不大于指定的 40 MiB 部分大小。

上传文件的第一个五个 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 替换为要用于对象的所需部分数。

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

重要

以这种方式使用命令可能无法上传对象的全部内容。

将完整文件上传到 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 命令可能按文档记录的方式工作,但任何此类使用均由您自行承担风险。