Skip to content

Commit 12eb174

Browse files
authored
Update index.md
1 parent 93f65f6 commit 12eb174

File tree

1 file changed

+27
-3
lines changed

1 file changed

+27
-3
lines changed

docs/03_query/03_params/index.md

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ print(args["id"])
3737

3838
### Text
3939

40-
此参数类型用于输入一个文本。
40+
此参数类型用于输入一个文本。支持固定默认值。
4141
在 SQL 中使用时,您可能需要根据实际情况添加引号,如
4242

4343
```sql
@@ -46,11 +46,25 @@ select * from table where name = '{{name}}'
4646

4747
### Number
4848

49-
此参数类型用于选择一个数字,输出格式为数字 `123`
49+
此参数类型用于选择一个数字,输出格式为数字 `123`支持固定默认值。
5050

5151
### Date
5252

53-
此参数类型用于选择一个日期,输出格式为字符串 `2024-08-06`
53+
此参数类型用于选择一个日期,输出格式为字符串 `2024-08-06`,常用于查询或分析特定时间段的数据。该参数支持两种类型的默认值:
54+
55+
1. **固定默认值**:您可以预先设定一个固定的日期值,例如 `2024-08-06`,每次查询时自动使用此日期作为默认值。
56+
57+
2. **动态默认值**:您可以通过编写 SQL 语句动态获取默认值。例如,使用以下 SQL 查询来获取某个数据表中最大日期:
58+
59+
```sql
60+
select max(day) from table
61+
```
62+
63+
这样,参数将自动选择数据表中记录的最大日期作为默认日期,确保查询始终基于最新的数据。
64+
65+
通过支持固定和动态默认值的灵活设置,您可以根据实际需求更加精确地控制日期参数的默认行为,提升查询效率和准确性。
66+
67+
5468

5569
### Date Range
5670

@@ -63,8 +77,16 @@ select * from table where name = '{{name}}'
6377
select * from table where date between '{{ dateRange:start }}' and '{{ dateRange:end }}'
6478
```
6579

80+
该参数支持两种类型的默认值:
81+
82+
1. **固定默认值**:指定时间间隔。
83+
84+
2. **动态默认值**:过去**N**天范围。
85+
6686
### List
6787

88+
列表项设置为每行一项,不要包含空格。也支持 `value:label` 的形式。支持默认值设置。
89+
6890
在开启多选时,需要配合修饰符 `:in` 一起使用,如
6991

7092
```sql
@@ -123,6 +145,8 @@ select * from {{ table }} where id = {{ id }};
123145
return query('select * from {{ table }} where id = {{ id }}')
124146
```
125147

148+
149+
126150
效果如下
127151

128152
![params order](./01_params_order.png)

0 commit comments

Comments
 (0)