DataWind 的 SQL 查询模块提供了自定义变量功能，增强了 SQL 脚本的灵活性和易用性。用户可以在 SQL 脚本中定义变量，以便在查询中动态使用。（本功能为增值模块，目前仅限私有化部署可使用，自V2.58.0及以上版本支持。如您需要使用，请联系贵公司的商务人员或客户成功经理咨询购买事宜）。

2.1 创建自定义变量

在 SQL 脚本中，如果您遇到需要使用自定义变量的地方，可以按照以下格式输入自定义变量：
{{自定义变量名}}
例： 当前需要查询某些产品的详细数据，每次只能查询一个产品，则可将筛选条件中的产品名称使用自定义变量表示，此时可创建自定义变量：{{产品名称}}。
当在 SQL 脚本中按照指定格式输入自定义变量名后，在下方变量说明下，会出现该自定义变量的输入框，此时即可使用自定义变量进行查询。

2.2 自定义变量类型设置

点击自定义变量输入框右侧的齿轮按钮即可打开输入框设置。


目前支持的类型有以下几种：

2.2.1 Text

Text 即为文本编辑框格式，设置完成后即可以在下方的自变量输入框中输入文本内容。
注意： Text 格式变量 SQL 运行时，系统不再在输入内容前后自动加''（引号）（旧版会自动在输入的内容前后加''，在使用场景上有诸多限制）。

2.2.2 Dropdown List

Dropdown List 格式可输入多个选项内容，以下拉列表的形式展现出来。
以换行符区分

2.2.3 Date

Date 类型是指日期类型，日期精确到年月日，日期的格式支持以下三种：

• YYYY-MM-DD
• YYYY/MM/DD
• YYYYMMDD

2.2.4 Date and Time

Date and Time 类型为日期类型，日期精确到年月日时分，日期的格式支持以下两种：

• YYYY-MM-DD HH:mm
• YYYY/MM/DD HH:mm

2.2.5 Date and Time (with seconds)

Date and Time(with seconds) 类型为日期类型，日期精确到年月日时分秒，日期的格式支持以下两种：

• YYYY-MM-DD HH:mm:ss
• YYYY/MM/DD HH:mm:ss