azcopy sync

将源位置复制到目标位置。 本文提供有关 azcopy sync 命令的详细参考。 若要详细了解如何在源位置和目标位置之间同步 blob,请参阅使用 AzCopy v10 与 Azure Blob 存储同步。 对于 Azure 文件存储,请参阅同步文件

摘要

上次修改时间用于比较。 如果目标中的上次修改时间与当前时间更近,则会跳过文件。 支持的配对包括:

  • 本地 <-> Azure Blob / Azure 文件(可以使用 SAS 或 OAuth 身份验证)
  • Azure Blob <-> Azure Blob(源必须包含 SAS 或可公开访问;可将 SAS 或 OAuth 身份验证用于目标)
  • Azure 文件 <-> Azure 文件(源必须包含 SAS 或可公开访问;应将 SAS 身份验证用于目标)
  • Azure Blob <-> Azure 文件

sync 命令与 copy 命令的不同之处体现在以下几个方面:

  1. 默认情况下,递归标志为 true,sync 会复制所有子目录。 如果递归标志为 false,则 sync 只复制目录中的顶级文件。
  2. 在虚拟目录之间同步时,如果存在与某个虚拟目录同名的 Blob,则在路径中添加一个尾随斜杠(参考示例)。
  3. 如果将“deleteDestination”标志设置为 true 或 prompt,则 sync 将删除目标中存在的,但在源中不存在的文件和 Blob。

高级:

请注意,如果未指定文件扩展名,则在从本地磁盘上传时,AzCopy 会根据文件扩展名或内容自动检测文件的内容类型。

内置的查找表较小,但在 Unix 上,已通过采用以下一个或多个名称的本地系统 mime.types 文件(如果可用)扩充了该查找表:

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

在 Windows 上,MIME 类型是从注册表提取的。

另请注意,同步仅从上次修改时间开始生效。 因此,对于 Azure 文件 <-> Azure 文件,将使用标头字段 Last-Modified 而非 x-ms-file-change-time,这意味着源上的元数据更改也可以触发完整副本。

azcopy sync [flags]

示例

同步单个文件:

azcopy sync "/path/to/file.txt" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/blob]"

与前面的示例相同,但还会计算文件内容的 MD5 哈希,然后将该 MD5 哈希另存为 Blob 的 Content-MD5 属性。

azcopy sync "/path/to/file.txt" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/blob]" --put-md5

同步整个目录,包括其子目录(请注意,默认已启用递归):

azcopy sync "/path/to/dir" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]"azcopy sync "/path/to/dir" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]" --put-md5

仅同步目录内的文件,但不同步子目录或子目录中的文件:

azcopy sync "/path/to/dir" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]" --recursive=false

同步目录中的一部分文件(例如:仅同步 jpg 和 pdf 文件,或者同步文件名为“exactName”的文件):

azcopy sync "/path/to/dir" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]" --include-pattern="*.jpg;*.pdf;exactName"

同步整个目录,但从同步范围中排除某些文件(例如:以 foo 开头或以 bar 结尾的每个文件):

azcopy sync "/path/to/dir" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]" --exclude-pattern="foo*;*bar"

同步单个 Blob:

azcopy sync "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/blob]?[SAS]" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/blob]"

同步虚拟目录:

azcopy sync "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]?[SAS]" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]" --recursive=true

同步与 Blob 同名的虚拟目录(在路径中添加尾随斜杠以消除歧义):

azcopy sync "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]/?[SAS]" "https://[account].blob.core.chinacloudapi.cn/[container]/[path/to/virtual/dir]/" --recursive=true

同步 Azure 文件目录(语法与 Blob 相同):

azcopy sync "https://[account].file.core.chinacloudapi.cn/[share]/[path/to/dir]?[SAS]" "https://[account].file.core.chinacloudapi.cn/[share]/[path/to/dir]" --recursive=true

注意:如果同时使用 include 和 exclude 标志,则只使用与 include 模式匹配的文件,而忽略与 exclude 模式匹配的文件。

选项

--block-size-mb(浮点数)- 在上传到 Azure 存储或从 Azure 存储下载时使用此块大小(以 MiB 为单位)。 默认值根据文件大小自动计算。 允许使用小数(例如:0.25)。

--check-md5(字符串)- 指定下载时验证 MD5 哈希的严格程度。 此选项仅在下载时可用。 可用的值包括:NoCheck、LogOnly、FailIfDifferent、FailIfDifferentOrMissing。 (默认值为“FailIfDifferent”)。 (默认值为“FailIfDifferent”)

--cpk-by-name(字符串)- 客户端按名称提供的密钥使客户端可以向 Azure Blob 存储发出请求,以便按每个请求提供加密密钥。 提供的密钥名称将从 Azure 密钥保管库提取,并用于对数据进行加密

--cpk-by-value - 客户端按名称提供的密钥使客户端可以向 Azure Blob 存储发出请求,以便按每个请求提供加密密钥。 提供的密钥及其哈希将从环境变量中提取

--delete-destinatio(字符串)- 定义是否从目标中删除不在源中的多余文件。 可设置为 true、false 或 prompt。 如果设置为 prompt,则在计划要删除的文件和 Blob 之前,系统会向用户提问。 (默认值为“false”)。 (默认值为“false”)

--dry-run - 输出 sync 命令复制或删除的文件的路径。 此标志不会复制或删除实际文件。

--exclude-attributes(字符串)(仅限 Windows)- 排除其特性与特性列表相匹配的文件。 例如:A;S;R

--exclude-path(字符串)- 将源与目标进行比较时,排除这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀(例如:myFolder;myFolder/subDirName/file.pdf)。

--exclude-pattern(字符串)- 排除名称与模式列表相匹配的文件。 例如: .jpg; .pdf;exactName

--exclude-regex(字符串)- 排除与正则表达式匹配的文件的相对路径。 使用“;”分隔正则表达式。

--from-to(字符串)-(可选)指定源-目标组合。 例如 LocalBlob、BlobLocal、LocalFile、FileLocal、BlobFile、FileBlob 等。

-h--help - 关于同步的帮助

--include-attributes(字符串)-(仅限 Windows)仅包括其属性与属性列表相匹配的文件。 例如:A;S;R

--include-pattern(字符串)- 仅包括名称与模式列表相匹配的文件。 例如: .jpg; .pdf;exactName

--include-regex(字符串)- 包括与正则表达式匹配的文件的相对路径。 使用“;”分隔正则表达式。

--log-level(字符串)- 定义日志文件的日志详细程度,可用级别:INFO(所有请求和响应)、WARNING(响应缓慢)、ERROR(仅限失败的请求)和 NONE(无输出日志)。 (默认值为 INFO)。 (默认值为“INFO”)

--mirror-mode - 如果此标志设置为 true,则禁用上次修改时间比较,并覆盖目标上的冲突文件和 blob。 默认值为 false

--preserve-permissions - 默认值为 false。 保留感知资源(Windows 和 Azure 文件存储,或 ADLS Gen 2 和 ADLS Gen 2)之间的 ACL。 对于分层命名空间帐户,需要一个拥有“修改所有权”和“修改权限”权限的容器 SAS 或 OAuth 令牌。 对于下载操作,还需要使用 --backup 标志来恢复权限,其中新所有者将不是运行 AzCopy 的用户。 此标志同时适用于文件和文件夹,除非指定了“仅文件”筛选器(例如包含模式)。

--preserve-smb-info - 对于 SMB 感知位置,默认情况下,标志将设置为 true。 保留 SMB 感知资源(Azure 文件存储)之间的 SMB 属性信息(上次写入时间、创建时间、属性位)。 此标志同时适用于文件和文件夹,除非指定了“仅文件”筛选器(例如包含模式)。 为文件夹传输的信息与为文件传输的信息几乎相同,只是“上次写入时间”除外,不会为文件夹保留该信息。 (默认值为 true)

--put-md5 - 创建每个文件的 MD5 哈希,并将该哈希另存为目标 Blob 或文件的 Content-MD5 属性。 (默认不会创建哈希。)仅在上传时可用。

--recursive - 默认值为 true,即,在目录之间同步时,将以递归方式查看子目录。 (默认值为 true)。 (默认值为 true)

--s2s-preserve-access-tier - 在服务间复制过程中保留访问层。 请参阅 Azure Blob 存储:热、冷和存档访问层,确保目标存储帐户支持设置访问层。 如果不支持设置访问层,请使用 s2sPreserveAccessTier=false 来绕过访问层的复制。 (默认值为 true)。 (默认值为 true)

--s2s-preserve-blob-tags - 在 blob 存储之间进行服务到服务同步过程中保留索引标记

从父命令继承的选项

--cap-mbps (浮点数)限制传输速率,以兆位/秒为单位。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略,则吞吐量不受限制。

--output-type(字符串)命令输出的格式。 选项包括:text、json。 默认值为“text”。 (默认值为“text”)

--trusted-microsoft-suffixes(字符串)- 指定可向其中发送 Azure Active Directory 登录令牌的其他域后缀。 默认值为“.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net”。 此处列出的任何内容都会添加到默认值。 为安全起见,应只在此处放置 Azure 域。 用分号分隔多个条目。

另请参阅