文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

mc od

语法

Themc 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>]
  • Brackets[]表示可选参数。

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

  • 使用竖线分隔的参数|操作符是互斥的。

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

参数

if
必需

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

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

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

尺寸
可选

文件每个上传部分的大小。 如果未指定,MinIO 将从源流中确定各部分的大小。

部件
可选

将对象分割为多少个部分进行上传。 如果未指定,MinIO 将根据源流的大小确定分块数量。

跳过
可选

文件上传过程中要跳过的部分数量。 例如,使用此选项可以仅针对对象的部分内容测试包含多个部分的大型文件的上传速度。

全局标志

此命令支持任何全局标志.

示例

上传完整文件,每个分块大小为40MiB

使用mc od将文件以指定大小的分块形式上传到 MinIO。sizeoption 允许您指定所需的分段大小。

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

  • 替换size具有所需尺寸的物体部件。

MinIO会检查源文件并将其分割成必要数量的部分,确保每个部分都不超过指定的40MiB分块大小。

上传文件的前五个40 MiB部分

使用mc od将文件分块上传到 MinIO,每个分块的大小可指定。sizeoption 允许您指定所需的分段大小。partsoption 允许您指定用于对象的总部件数。

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

  • 替换size具有所需尺寸的物体部件。

  • 替换parts使用所需的分割部分数量来处理对象。

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

重要

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

分5部分上传完整文件

读取源文件,将文件分割为指定数量的分块,然后将所有文件分块上传到MinIO目标存储。

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

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

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建,并已通过 MinIO 和 AWS S3 测试,确保功能与行为符合预期。

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