Azure SQL/Synapse链接服务参数化后发布参数丢失问题求助

问题背景 #

在Azure Synapse Git协作模式下，为Azure SQL/Synapse链接服务配置了DBServer和DBName两个参数，协作分支内链接服务正常，ARM模板也显示预期的连接字符串值。但通过工作区发布按钮发布后，Live模式代码中无参数定义，发布分支的TemplateParameter文件为空；即使移除参数填入实际值再发布，Live模式仍无对应值。场景使用托管标识认证，无敏感信息，不想通过KeyVault引用连接字符串以保留完全动态性。

解决方案 #

• 检查发布流程的参数配置
  发布操作时，务必进入发布窗口的「参数」选项卡，手动指定DBServer和DBName的参数值，或确认勾选「从协作分支继承参数」的选项（若存在）。Synapse默认不会自动将协作分支的参数映射到发布分支，需手动完成参数绑定。

• 手动维护发布分支的TemplateParameter文件
  直接编辑发布分支下的TemplateParametersForWorkspace.json文件，添加参数定义与对应值，示例如下：

  {
    "parameters": {
      "DBServer": {
        "value": "your-target-server.database.windows.net"
      },
      "DBName": {
        "value": "your-target-db-name"
      }
    }
  }
  

  确保参数名与协作分支链接服务ARM模板中的定义完全一致，保存后重新执行发布操作。

• 验证链接服务ARM模板的参数定义
  检查协作分支内链接服务的ARM模板，确认参数在parameters节点正确声明，且连接字符串中参数引用格式无误，示例：

  {
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
      "DBServer": {
        "type": "string"
      },
      "DBName": {
        "type": "string"
      }
    },
    "resources": [
      {
        "name": "YourLinkedService",
        "type": "Microsoft.Synapse/workspaces/linkedservices",
        "apiVersion": "2021-06-01",
        "properties": {
          "type": "AzureSqlDatabase",
          "typeProperties": {
            "connectionString": "Server=tcp:@{parameters('DBServer')},1433;Database=@{parameters('DBName')};Authentication=Active Directory Integrated;"
          },
          "connectVia": {
            "referenceName": "AutoResolveIntegrationRuntime",
            "type": "IntegrationRuntimeReference"
          }
        }
      }
    ]
  }
  

  排查是否存在语法错误或参数引用格式错误。

• 重置发布分支后重新同步
  若发布分支存在缓存或历史冲突，可在Synapse工作区的Git设置中找到发布分支，执行「重置分支」操作，将其同步到协作分支的最新版本后，重新发布。

• 改用管道参数实现动态连接
  如果链接服务参数化发布问题无法解决，可切换方案：在管道中定义DBServer和DBName参数，然后在数据集的连接字符串中直接引用管道参数，示例：

  Server=tcp:@{pipeline().parameters.DBServer},1433;Database=@{pipeline().parameters.DBName};Authentication=Active Directory Integrated;
  

  此方式无需依赖链接服务参数化，管道运行时可动态传入参数，发布后参数配置不会丢失，同样能实现完全动态的连接需求。

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