如何使用Azure Data Factory修改Azure Blob文件的Content-Type

完全可以通过Azure Data Factory批量修改目标Blob的Content-Type属性，该方案不需要重新上传或迁移文件本体，支持遍历所有容器、任意层级子文件夹下的文件，仅修改元数据不触碰文件内容，处理速度快、额外成本极低。

前置准备 #

• 给ADF实例开启系统分配托管标识，给该标识授予目标存储账户的Storage Blob Data Contributor角色，确保有权限修改Blob属性。
• 提前确认处理范围：如果需要处理存储账户下所有容器，后续配置根路径到存储账户层级即可；如果仅处理指定容器，路径配置到对应容器层级。

步骤1：创建用于遍历文件的Blob数据集 #

• 新建Azure Blob Storage类型的数据集，关联目标存储账户的链接服务。
• 路径配置为待处理的根路径，勾选「递归遍历子文件夹」选项。
• 数据集格式选择「二进制」，不做文件内容解析，避免非图片类文件读取报错。

步骤2：配置Lookup活动拉取全量待处理Blob列表 #

• 在ADF管道中添加Lookup活动，关联上一步创建的Blob数据集。
• 取消勾选「仅返回第一行」选项，开启分页功能，设置单页返回条目数为10000，适配大数量场景下列表拉取不全的问题。
• 该活动会返回所有Blob的容器名、文件路径字段，作为后续循环处理的输入源。

步骤3（可选）：添加过滤规则排除非目标文件 #

• 如果待处理路径下混存了非JPG/JPEG格式的文件，在Lookup活动后添加Filter活动，过滤条件设置为@or(endswith(toLower(item().name), '.jpg'), endswith(toLower(item().name), '.jpeg'))，仅保留后缀为jpg、jpeg的文件进入后续处理流程，避免误改其他格式文件的Content-Type。

步骤4：配置ForEach循环批量处理 #

• 添加ForEach活动，循环输入项配置为Lookup（或Filter活动）的输出值：@activity('拉取Blob列表').output.value（活动名替换为你实际配置的Lookup活动名称）。
• 可根据存储账户的限流阈值调整并发数，常规场景设置20~50并发即可，兼顾处理速度和稳定性。

步骤5：循环内配置Web活动修改Blob属性 #

在ForEach循环内部添加Web活动，调用Blob存储的原生属性修改接口完成Content-Type更新，具体配置如下：

• 请求方法：PUT
• URL：@concat('https://<替换为你的存储账户名>.blob.core.windows.net/', item().containerName, '/', item().name, '?comp=properties')
• 鉴权方式：选择「系统分配的托管标识」，资源字段填写https://storage.azure.com/，ADF会自动完成鉴权签名，无需手动配置密钥或Authorization头。
• 请求头配置：
  • x-ms-version: 2020-10-02
  • x-ms-blob-content-type: image/jpeg
• 不需要配置请求体，该接口仅修改Blob的元数据属性，不会改动文件本身的内容。

• 全量执行管道前，建议先选取1~2个测试文件夹做小范围验证，确认Content-Type修改生效、文件可正常访问后再跑全量任务。
• 该方案仅产生极少量的ADF调度费用和存储事务费用，没有文件流量、存储容量类的额外成本。
• 后续上传新图片时，建议在上传工具、SDK或存储账户的默认配置中提前指定Content-Type为image/jpeg，避免新上传的文件再次被默认赋值为application/octet-stream。

内容的提问来源于stack exchange，提问作者Azure Cloud Enthusiast