Azure Synapse Pipeline Script Activity使用脚本参数时遇语法错误

问题本质 #

在Azure Synapse管道运行的无服务器数据库初始化脚本中，尝试用脚本参数@storageAccountUrl指定CREATE EXTERNAL DATA SOURCE的LOCATION时，触发错误errorCode 2011, Incorrect syntax near '@storageAccountUrl'。硬编码LOCATION值或使用管道参数动态内容可正常执行，但脚本参数方式失效。

原因说明 #

这并非配置遗漏或Azure Bug，而是Synapse SQL无服务器的语法限制：CREATE EXTERNAL DATA SOURCE这类DDL语句的LOCATION参数不支持直接使用T-SQL变量/脚本参数，属于产品设计层面的约束，目前官方未开放该参数的参数化支持。

可行解决方案 #

方案1：使用管道参数动态生成SQL脚本 #

在Synapse管道的「SQL脚本」活动中，通过动态内容拼接完整SQL语句，示例：

IF NOT EXISTS (SELECT * FROM sys.external_data_sources WHERE name = 'bronze_data')
BEGIN
    CREATE EXTERNAL DATA SOURCE bronze_data WITH (LOCATION = '@{pipeline().parameters.storageAccountUrl}');
END

• 优势：通过管道参数统一管理多环境的存储账户URL，切换环境时只需修改管道参数值；
• 小技巧：在动态内容编辑器中编写时，可利用「预览」功能验证生成的SQL语法是否正确，避免拼接错误。

方案2：用T-SQL动态SQL拼接执行 #

若需在脚本内部处理参数，可通过动态SQL包裹DDL语句实现，示例：

-- 这里的@storageAccountUrl可替换为脚本参数传入的值
DECLARE @storageAccountUrl NVARCHAR(1000) = '<你的存储账户URL>';
DECLARE @sql NVARCHAR(MAX);

IF NOT EXISTS (SELECT * FROM sys.external_data_sources WHERE name = 'bronze_data')
BEGIN
    SET @sql = N'CREATE EXTERNAL DATA SOURCE bronze_data WITH (LOCATION = ''' + @storageAccountUrl + ''')';
    EXEC sp_executesql @sql;
END

• 注意：使用动态SQL时需确保传入的@storageAccountUrl为可信配置值，避免SQL注入风险。

补充说明 #

官方论坛中已有同类问题反馈，目前官方仍未支持在CREATE EXTERNAL DATA SOURCE的LOCATION中直接使用脚本参数，上述两种方案为当前可行的替代方案。

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