SQL Warehouse笔记本中执行CREATE WIDGET语句报语法错误求助

核心原因 #

CREATE WIDGET是Databricks交互式Notebook（非SQL Warehouse绑定）特有的语法，而SQL Warehouse的执行引擎基于标准SQL，不支持该交互式控件语法，因此会触发PARSE_SYNTAX_ERROR。

可行解决方案 #

1. 切换到普通Databricks Notebook #

如果需要交互式控件功能，创建未绑定SQL Warehouse的普通Databricks Notebook（支持SQL/Python/Scala语言），直接运行原语句即可生效：

CREATE WIDGET TEXT ENVIRONMENT DEFAULT "uat";

2. 在SQL Warehouse中用标准变量替代 #

改用SQL Warehouse支持的标准变量定义方式：

• 定义变量：

SET ENVIRONMENT = 'uat';

• 查询时引用变量：

SELECT * FROM your_table WHERE env = ${ENVIRONMENT};

3. 使用Databricks SQL的可视化参数控件 #

在Databricks SQL查询编辑器中，通过参数语法自动生成控件：

1. 在查询中嵌入参数占位符：

SELECT * FROM your_table WHERE env = '{{ ENVIRONMENT }}'

2. 执行查询后，系统会自动生成文本输入控件，可在参数设置中配置默认值为uat。

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