如何在Synapse Studio Notebook中动态获取Pipeline参数无需预定义？

数据老陈

2026-8-9

动态获取Pipeline传入Notebook参数的方法

不需要预定义同名变量就能动态获取Pipeline参数的方案是存在的，具体实现取决于你使用的Notebook执行平台，以下是两种常见场景的实现方式：

1. Databricks Notebook场景

Databricks提供了dbutils.widgets工具集，可以直接枚举所有传入的Pipeline参数，无需提前声明变量：

# 获取所有传入的参数名称列表
all_param_names = dbutils.widgets.list()

# 遍历参数名称，构建参数名-值的字典
pipeline_params = {name: dbutils.widgets.get(name) for name in all_param_names}

# 如果需要类似sys.argv的参数列表格式，可以提取值列表
param_values = list(pipeline_params.values())

执行后，pipeline_params会包含所有Pipeline传入的参数，你可以直接遍历或按需取用，不用提前定义每个变量。

2. 通用Jupyter/本地Notebook配合Pipeline场景

多数Pipeline工具（如Airflow、Argo Workflows）会将传入的参数以环境变量的形式注入Notebook进程，你可以通过os.environ动态读取：

import os

# 假设Pipeline参数统一使用特定前缀（比如PIPELINE_PARAM_），过滤并提取参数
prefix = "PIPELINE_PARAM_"
pipeline_params = {
    key.replace(prefix, ""): value
    for key, value in os.environ.items()
    if key.startswith(prefix)
}

# 转为类似sys.argv的列表格式
param_list = list(pipeline_params.values())

这种方式不需要依赖平台特定工具，通用性更强，只要Pipeline支持将参数注入环境变量即可。