Azure Data Factory：使用自托管IR上传图片至本地SQL varbinary列遇问题

核心问题解析 #

你遇到的两个错误本质是对ADF Copy Data活动的源/接收器类型匹配逻辑理解有误：

• Sink must be binary when source is binary dataset：ADF的二进制源仅支持二进制类型接收器（如Blob存储、ADLS），SQL Server不属于这类接收器，因此直接用二进制源→SQL的Copy Data不成立
• Row/Column delimiter cannot be empty string：DelimitedText数据集是为文本文件设计的，无法处理二进制图片文件，自然会报错

可行实现方案：Lookup+ForEach+Copy Data（带存储过程） #

步骤1：确认自托管IR连通性 #

• 确保自托管IR已安装在本地机器，且能同时访问本地文件系统和SQL Server
• 分别测试文件系统链接服务、SQL Server链接服务的连通性，验证通过自托管IR可正常访问

步骤2：创建所需数据集 #

1. 文件系统二进制数据集：指向图片文件夹，文件路径设为*.jpg;*.png（过滤目标文件），用于后续获取文件列表
2. SQL Server数据集：指向目标数据库的DocumentBinary表

步骤3：创建SQL存储过程 #

在目标数据库中创建用于插入二进制数据的存储过程（根据你的表结构调整列名）：

CREATE PROCEDURE InsertDocumentBinary
    @FileName NVARCHAR(255),
    @FileData VARBINARY(MAX)
AS
BEGIN
    INSERT INTO DocumentBinary (FileName, FileContent)
    VALUES (@FileName, @FileData)
END

步骤4：构建ADF管道 #

活动1：Lookup活动

• 源选择上述文件系统二进制数据集
• 配置为获取文件夹下所有匹配的文件列表，输出包含每个文件的Name（文件名）和Path（完整路径）

活动2：ForEach活动

• 输入数据集设为@activity('Lookup1').output.value（Lookup活动的文件列表输出）
• 可设置批量计数（如100），控制并发处理数量避免性能问题

活动3：Copy Data活动（嵌套在ForEach内）

源配置

• 源类型选「文件系统」，数据集用之前的二进制数据集
• 源选项中，文件路径设为@item().Path（动态指定当前循环的单个文件）
• 格式选「二进制」

接收器配置

• 接收器类型选「SQL Server」，数据集用之前的SQL数据集
• 接收器选项中，写入方式选「存储过程」，指定存储过程名InsertDocumentBinary
• 参数映射：
  • @FileName → @item().Name
  • @FileData → 源的BinaryData列（二进制文件内容）

替代方案（无需存储过程） #

如果不想创建存储过程，可直接在Copy Data活动中映射列：

• 确保DocumentBinary表有VARBINARY(MAX)类型的列（如FileContent）
• 在Copy Data的列映射中，将源的BinaryData列映射到SQL的FileContent列
• 文件名可通过动态内容@item().Name映射到SQL表的对应列

内容的提问来源于stack exchange，提问作者Christopher Page