数据集的创建是将数据源中的数据表或自建的即席分析SQL添加到Quick BI中,作为前端可视化数据分析的基础。您可以通过数据源表或者即席分析SQL两种方式来创建数据集。

通过数据源表创建

  1. 登录Quick BI控制台
  2. 单击工作空间 > 数据源
  3. 在数据源页面的我的数据源列表中,找到并单击目标数据源。
    目前仅支持在MySQL 、SQL Server、MaxCompute 、Oracle中上传本地文件,本例中选择mysql数据库
  4. 您可以根据需要,选择在数据表页签或上传文件页签创建数据源。
    • 当您需要在原始数据库的数据表中创建数据集时,请单击数据表页签。创建数据集
    • 当您需要在上传的文件数据源中创建数据集时,请单击上传文件页签。
      目前仅支持在MySQL 、SQL Server、MaxCompute 、Oracle中上传本地文件。上传文件
  5. 找到目标数据表并单击操作列的创建数据集图标。
  6. 创建数据集页面填写数据集名称和存放位置后,单击确定
    创建数据集
创建成功后,页面会自动跳转到数据集管理页面,新创建的数据集会带有New的图标,方便您快速定位新的数据集。新建数据集

通过即席分析SQL创建

在数据建模过程中,一些复杂逻辑可以通过即席分析SQL创建数据集。即席分析SQL支持动态传参。基于SQL传参实现建模分析,扩展敏捷BI支撑的场景深度,满足复杂的数据分析场景诉求。

  1. 登录Quick BI控制台
  2. 单击工作空间 > 数据源
  3. 在数据源页面的我的数据源列表中,找到并单击目标数据源。
  4. 在页面右侧单击即席分析SQL
    即席分析
  5. 即席查询SQL页面,您可以进行如下操作,创建数据集。
    • 普通SQL:通过SQL在指定数据源中获取数据表。
      1. 即席查询SQL页面,您可以修改指定数据源。
      2. 确定数据源后输入SQL语句。
        示例:
        SELECT  *
        from    company_sales_record
      3. 单击执行,运行SQL语句。
      4. 在执行结果页签,查看执行结果。查看结果

        单击创建数据集填写数据集名称和保存位置完成数据集创建。创建成功后,页面会自动跳转到数据集管理页面,新创建的数据集会带有New的图标,方便快速定位新的数据集。

    • 参数SQL:通过SQL在数据源的表中增加参数。
      1. 即席查询SQL页面,您可以修改指定数据源。
      2. 确定数据源后输入SQL语句。
        示例:
        SELECT  report_date,
                order_level,
                shipping_type,
                area,
                price,
                order_number
        from    company_sales_record
        where   ${report_date :report_date}
        and     ${order_level :order_level}
        and     ${order_number :order_number}
      3. 单击执行,运行SQL语句。
      4. 查看执行结果。
        在执行结果界面您可以查看SQL执行结果。
        1. 单击执行结果页签。
        2. 单击历史记录页签可查看当前即席分析SQL执行时间、对应的SQL语句以及SQL执行耗时。
          • 单击复制,复制对应SQL语句,可将其粘贴到SQL输入框中。
          • 单击创建数据集 可直接将历史SQL语句创建为数据集。
          • 单击收起执行结果。
        即席分析SQL支持动态参数,在SQL建模时,在where语句后面追加SQL参数,参数格式为${物理字段名:参数别名},该参数可以在查询控件中被引用。
        说明 参数字段在数据集中不显示,在查询控件中会显示。
        SQL示例:
        SELECT  report_date,
                order_level,
                shipping_type,
                area,
                price,
                order_number
        from    company_sales_record
        where   ${report_date :report_date}
        and     ${order_level :order_level}
        and     ${order_number :order_number}
      5. 参数设置。
        可新增参数变量和修改变量类型。目前支持文本、数值、日期-年月日、日期-年月、日期-年周、日期-年、年月日时分秒七种变量类型。
        • 单击新增参数变量新增参数别名和变量类型,此参数别名需要以${物理字段名:参数变量名}格式添加到SQL语句where条件中。
        • 单击快速提取自动获取SQL语句中的参数别名,变量类型默认为文本,可手动修改。快速提取
        • 单击格式化可格式化SQL语句。
        单击创建数据集填写数据集名称和保存位置完成数据集创建。创建成功后,页面会自动跳转到数据集管理页面,新创建的数据集会带有New的图标,方便快速定位新的数据集。
      6. 参数在查询控件中的应用:
        1. 在数据集管理页面,单击目标数据集所在行的新建仪表板图标。
          说明 如果您使用的是专业版,需要您手动选择进入常规模式或者全屏模式。以下示例以常规模式为例。
        2. 单击查询控件查询控件图标图标。
        3. 单击查询控件中部或者鼠标悬浮在查询控件上右上角出现的新建筛选项图标,对查询控件进行设置。新建筛选项
          • SQL参数在查询控件中的使用。
            查询条件设置页面,设置查询条件名称并选择基于包含SQL参数的数据集的图表进行关联设置。在筛选字段选择区域除展示对应的维度、度量外还会展示数据集中的SQL参数。参数字段设置
            说明 当关联字段为文本型SQL参数字段且展示类型为下拉列表(原枚举筛选)时,选项值来源不支持自动解析方式。如果设置为该方式,在查询控件中无查询值。
          • SQL占位符在查询控件中的使用。
            占位符支持情况如下:
            • 如果是文本字段,需要手动输入单引号。
            • 如果是数值字段,直接填入数值内容。
            • 如果是日期字段,可以在配置占位符时设置日期格式,在SQL运行时被当作文本替换。
            2
            查询条件设置页面,设置查询条件名称并选择基于包含占位符的数据集的图表进行关联设置。在筛选字段选择区域除展示对应的维度、度量外还会展示数据集中的占位符。1

          日期类型、数值类型、文本型的查询设置请参见日期查询数值查询文本查询

  6. 创建完成后,如果您想要修改即席分析SQL语句,进行如下操作。
    1. 在数据集管理页面,找到目标数据集并单击操作列的更多图标,选择修改SQL
      您也可以右键单击目标数据集并选择修改SQL
    2. 在仪表板SQL语句编辑页面,完成SQL修改并执行无误后 ,单击保存
      保存