如何通过Release Pipeline将Azure Repo中CSV导入Azure SQL？遇重叠IO错误

方案可行性 #

完全可行。将Azure Repo中的CSV通过Release Pipeline发布并插入Azure SQL数据库是DevOps场景下常见的数据同步/部署方式，技术上没有障碍，只要配置正确即可实现。

操作系统错误代码997的原因与解决办法 #

你遇到的“重叠I/O操作正在进行中”错误，核心原因通常是BULK INSERT的文件路径访问逻辑不符合Azure环境的要求，或文件被占用、权限配置错误，以下是具体解决思路：

1. 修正文件访问路径逻辑（最关键） #

Azure SQL的BULK INSERT默认读取的是SQL服务器本地文件系统的路径，而Release Pipeline生成的artifact是在代理机器上，不是SQL服务器的磁盘。直接用ArtifactAlias\foldername\filename.csv这种路径，SQL服务器根本无法访问到文件，这是导致错误的核心原因。

推荐改用Azure Blob存储中转的方案（更适配Azure生态）：

• 先在Release Pipeline中添加步骤，将CSV文件上传到Azure Blob存储容器；
• 然后在SQL脚本中通过外部数据源读取Blob中的CSV，示例脚本如下：

  -- 先创建存储账户的凭据（提前在SQL中配置）
  CREATE DATABASE SCOPED CREDENTIAL StorageCredential
  WITH IDENTITY = 'SHARED ACCESS SIGNATURE',
  SECRET = '你的Blob容器SAS密钥';
  
  -- 创建外部数据源
  CREATE EXTERNAL DATA SOURCE BlobStorage
  WITH (
      TYPE = BLOB_STORAGE,
      LOCATION = 'https://你的存储账户名.blob.core.windows.net/你的容器名',
      CREDENTIAL = StorageCredential
  );
  
  -- 执行批量插入
  BULK INSERT TargetTableName
  FROM 'foldername/filename.csv'
  WITH (
      DATA_SOURCE = 'BlobStorage',
      FIRSTROW = 2, -- 确认CSV有表头行才启用，否则改为1
      FIELDTERMINATOR = ',',
      ROWTERMINATOR = '\r\n', -- 部分CSV用回车换行，替换原'\n'试试
      FIELDQUOTE = '"', -- 直接用双引号即可，无需转义为"
      TABLOCK -- 提升插入性能，可选
  );
  

2. 若坚持使用代理机器文件的替代方案 #

如果一定要从代理机器直接读取文件，需满足以下条件：

• 将代理机器上的artifact文件夹设置为共享文件夹，并给Azure SQL服务器的服务账号配置读取权限；
• 脚本中使用UNC路径，比如\\代理机器名\共享文件夹名\foldername\filename.csv；
• 检查代理机器防火墙是否开放了文件共享端口（如SMB的445端口）；
• 确保CSV文件在插入过程中没有被Pipeline的其他任务锁定（比如文件未完成解压或复制）。

3. CSV格式适配细节 #

你的CSV中存在带逗号的字段（"123,234325"），需注意：

• FIELDQUOTE = '"'即可正确识别带引号的字段，无需转义；
• 确认ROWTERMINATOR是否匹配CSV的实际换行符，部分编辑器生成的CSV用\r\n而非\n，可替换后测试。

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