直连数据集使用全局参数教程

需求背景

数据库数据量太大，每次更新运行慢，页面上需要进行二次筛选。希望根据页面上输入的筛选项到数据库精确查询最新数据。

实现方法

1. 根据需要新建全局参数。有 3 种类型：文本、数值、日期。其中日期类型参数默认格式为 yyyy-MM-dd (例如 2020-08-18)。如果需要查询日期区间 (例如 2020-07-01 至 2020-08-18)，需要新建 2 个日期参数作为开始日期和结束日期。

2. 新建数据库数据集，写入 SQL 语句时直接选择已经建好的全局参数；已经创建成功的数据集，编辑数据模型，修改 SQL 语句时选择全局参数。全局参数建议用于 where 条件语句，可以引用多个参数。注意：在有的数据库中，日期类型全参数可能会被识别为字符串，需要用对应数据库函数转换格式，和数据库中日期字段格式相同后再进行比较。

3. 数据集创建并更新成功后，制作卡片。如果卡片编辑时因为数据集无数据没法预览，可以在右侧“参数默认值”下修改暂时全局参数默认值来确保有数据可预览。

4. 在页面新建筛选器，关联卡片和全局参数后即可使用。

日期筛选：建议新建日期筛选器，根据数据集SQL中日期字段比较关系设置比较操作符，设置日期默认值；进入联动页面，点击要关联的卡片，勾选卡片名字和全局参数，点击“完成”保存。也可用参数筛选器，但不显示比较操作符。

文本、数值筛选：

a. 新建选择筛选器，数据集选择其他非直连数据集，选择筛选字段并关联卡片和全局参数。优点：选择筛选器可同时联动页面内其他不使用全局参数的卡片；缺点：必须提前准备好存有筛选项内容的数据集。
b. 新建参数筛选器，引用卡片里使用的文本参数，筛选项可选择从其他数据集导入或者选择“文本输入”手动复制粘贴筛选项保存，或者勾选“自定义，不设置可选项”（勾选保存后，需要手动输入筛选项联动），保存会自动联动页面内使用了该参数的所有卡片。优点：使用灵活，方便随时调整；缺点：不能联动页面内不使用全局参数的卡片。