Azure数据库导入：chunk-size参数使用报错及内存问题解决办法

为什么你的az命令报错？ #

az sql db import 命令不支持--chunk-size-mb参数，这就是你收到"unrecognized arguments"错误的原因。Azure CLI的这个导入命令没有内置分批导入的配置项，要实现分批导入来降低内存占用，确实需要使用SQLPackage工具。

用SQLPackage实现分批导入的具体操作 #

SQLPackage是微软官方推出的专用工具，专门用于SQL Server和Azure SQL数据库的备份导入、导出、同步等操作，原生支持分批处理来控制内存消耗，操作步骤如下：

1. 安装SQLPackage
   去微软官方下载对应操作系统的版本（Windows、Linux、macOS均有支持），完成安装后确保能在命令行直接调用SqlPackage.exe（Windows）或sqlpackage（Linux/macOS）。

2. 构造分批导入命令
   核心是通过/p:BatchSize参数控制每批导入的行数，数值越小，单批占用的内存越少，你可以根据自身服务器的内存情况调整。另外还可以通过/p:MaxParallelism限制并行线程数，进一步降低内存压力。

   示例命令（Windows环境）：

   SqlPackage.exe /Action:Import `
     /SourceFile:"D:\backups\your-db.bacpac" `
     /TargetServerName:"your-server.database.windows.net" `
     /TargetDatabaseName:"your-db-name" `
     /TargetUser:"admin-username" `
     /TargetPassword:"admin-password" `
     /p:BatchSize=50000 `
     /p:CommandTimeout=3600 `
     /p:MaxParallelism=2
   

   如果你的bacpac文件存储在Azure存储账户中，不需要先下载到本地，直接用存储URI访问：

   SqlPackage.exe /Action:Import `
     /SourceUrl:"https://your-storage-account.blob.core.windows.net/container/your-db.bacpac" `
     /TargetServerName:"your-server.database.windows.net" `
     /TargetDatabaseName:"your-db-name" `
     /TargetUser:"admin-username" `
     /TargetPassword:"admin-password" `
     /p:StorageAccessKey="your-storage-account-key" `
     /p:BatchSize=50000 `
     /p:CommandTimeout=3600
   

   参数说明：

   • /p:BatchSize：每批导入的行数，建议从50000开始尝试，内存紧张的话可以降到10000-20000
   • /p:MaxParallelism：并行导入的线程数，默认是8，内存不足时可以设为2-4
   • /p:CommandTimeout：设置单批操作的超时时间，避免因数据量大导致超时

其他替代方案（不推荐） #

如果不想使用SQLPackage，理论上可以手动拆分bacpac文件，但bacpac是结构化的压缩包，拆分后容易损坏文件结构，且没有官方工具支持，操作复杂度高，风险大，不如SQLPackage可靠。

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