Azure Synapse Analytics中如何参数化数据集的链接服务名称？

你不需要必须依赖template-parameters-definition.json，但你尝试的<DatasetName>_properties_linkedServiceName_referenceName语法确实无法直接生效，下面提供两种可行的参数化方式：

1. 直接在数据集定义中内置参数（无需额外配置文件） #

修改你的数据集JSON，给linkedServiceName.referenceName绑定一个数据集参数，具体步骤：

• 在数据集的parameters节点新增一个用于接收链接服务名称的参数
• 将linkedServiceName.referenceName的值改为表达式，引用这个新参数

修改后的数据集示例：

{
    "name": "DATALAKE_FOLDER",
    "properties": {
        "linkedServiceName": {
            "referenceName": "@dataset().linked_service_name",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "file_system": {
                "type": "string"
            },
            "folder_path": {
                "type": "string"
            },
            "linked_service_name": {
                "type": "string",
                "defaultValue": "ls_to_storage_account_1"
            }
        },
        "folder": {
            "name": "MyDataset"
        },
        "annotations": [],
        "type": "DelimitedText",
        "typeProperties": {
            "location": {
                "type": "AzureBlobFSLocation",
                "folderPath": {
                    "value": "@dataset().folder_path",
                    "type": "Expression"
                },
                "fileSystem": {
                    "value": "@dataset().file_system",
                    "type": "Expression"
                }
            },
            "columnDelimiter": ",",
            "escapeChar": "\\",
            "firstRowAsHeader": true,
            "quoteChar": "\""
        },
        "schema": []
    }
}

部署时，你只需要给DATALAKE_FOLDER_linked_service_name这个参数传递对应环境的链接服务名称即可。

2. 使用template-parameters-definition.json（适合批量参数化场景） #

如果希望沿用类似触发器的参数化路径语法，需要在template-parameters-definition.json中定义数据集链接服务的参数映射规则：

{
  "Microsoft.DataFactory/factories/datasets": {
    "*": {
      "properties/linkedServiceName/referenceName": "linkedServiceName"
    }
  }
}

配置后，部署时就可以用<DatasetName>_linkedServiceName作为参数名（比如DATALAKE_FOLDER_linkedServiceName）来指定链接服务名称，和你之前处理触发器参数的逻辑一致。

为什么之前的语法无效？ #

Synapse/ADF对触发器的部分属性路径做了默认的参数化支持，但数据集的linkedServiceName.referenceName不在默认支持的路径列表里，所以无法直接用<DatasetName>_properties_linkedServiceName_referenceName这种格式，必须通过上述两种方式手动配置参数化规则。

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