Azure Databricks CLI最新版如何传递Notebook参数？旧版参数传递遇错求助

核心差异说明 #

新版CLI对--notebook-params的格式要求更严格，必须传递标准JSON字符串，这也是旧版报错的核心原因（旧版的宽松格式在新版不兼容）。

正确用法示例 #

1. 命令行直接传递JSON参数 #

databricks jobs run-now --job-id <你的job-id> --notebook-params '{"param_name": "param_value", "num_param": 123}'

注意：JSON的键和字符串值必须用双引号，数字、布尔值不需要加引号。

2. 通过环境变量传递参数 #

如果要通过环境变量$db_job_np传递，先确保变量存储的是合法JSON：

# 先设置环境变量（示例）
export db_job_np='{"name": "test", "threshold": 90}'

# 执行run-now命令（用双引号包裹变量，避免shell拆分内容）
databricks jobs run-now --job-id "$db_id" --notebook-params "$db_job_np"

常见问题排查 #

• 若仍报JSONDecodeError，先执行echo $db_job_np检查输出是否为标准JSON：
  • 禁止用单引号包裹JSON的键或字符串值
  • 确保没有多余的逗号、缺失的括号
  • 变量值不能为空或仅含空格

额外提示 #

新版CLI不再需要--version参数指定API版本，默认会使用兼容的最新API版本，若需指定可通过--api-version参数（格式如--api-version 2.1）。

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