跳到主要内容

数据集中参数的使用

1.参数的原理​

如果我们连接数据库后，希望直接将我们数据库中所需要的内容查询出来，则直接编辑SQL语句即可，如下：

> <font color='blue'>SELECT [门店],[商品种类],[商品名称],[年],[月],[日],[单价],[成本],[销售量],[销售额],[收益],[期初库存数量],[期末库存数量],[进货数量]
> FROM [演示数据库].[dbo].[表3-门店销售表] 
> where 1=1 </font>

在对该数据进行使用的时候，我们希望对数据进行过滤，且过滤的动作，是由用户可以自己去操作的，即将用户过滤的内容动态返回给SQL语句来进行查看，则我们可以再SQL语句中添加参数变量进行占位中，在用户调用API接口时，系统可以将用户对API中变量赋予的值返回给SQL语句进行SQL执行后再将结果返回给用户进行使用。
此时，我们可以定义一个SQL语句如下，其中门店、商品种类为变量：

> <font color='blue'>SELECT [门店],[商品种类],[商品名称],[年],[月],[日],[单价],[成本],[销售量],[销售额],[收益],[期初库存数量],[期末库存数量],[进货数量]
> FROM [演示数据库].[dbo].[表3-门店销售表] 
> where 1=1  and 门店='${门店}'  and 商品种类 in (${商品种类})</font>

当用户调用API服务的时候，给变量门店赋值为：门店01；给商品种类赋值为：'时尚系列' ，则API对应执行的SQL语句为：

> <font color='blue'>LECT [门店],[商品种类],[商品名称],[年],[月],[日],[单价],[成本],[销售量],[销售额],[收益],[期初库存数量],[期末库存数量],[进货数量]
> FROM [演示数据库].[dbo].[表3-门店销售表] 
> where 1=1  and 门店='门店01'  and 商品种类 in ('时尚系列')</font>

2.参数的定义​

变量的格式为：

${变量名称}
，其中：变量名称可以自由定义。
在调用API服务时，系统会将用户返回的值自动拼接到SQL语句里面的变量位置去，以形成完整的执行SQL语句。

3.参数的设置​

如SQL语句中，带了参数变量，则要点【参数设置】区域的【刷新】，系统会自动识别出SQL中包含的参数并自动填入到下方的列表中，可以再列表中设置下参数的【类型】和【默认值】，之后再点击【执行SQL】，完成数据集创建的后续工作。

<font color='red'>【注意】</font>：有的SQL语句写法中，如果默认值为空，可能SQL报错或执行不出来数据。则可以通过数据预览对SQL进行检查。

image
Preview

*经验分享：数据预览进行排错​

点击【数据预览】，点击【预览】，如SQL执行正常，则下方可以正常预览出数据。
<font color='red'>注意：这里的数据结果，是SQL语句中把参数填充为默认值后执行出来的结果。在数据预览列表下方的框内，即可看到对应的SQL语句。通过这个可以检查自己的参数设置是否正确。</font>

image
Preview