1. 概述

本章节介绍如何使用SQL自助取数。SQL取数的核心功能区域分为:

  • 数据字段区
  • SQL编辑区
  • 运行结果区
  • 参数设置区

2. 数据字段区

(1)添加数据连接

SQL取数的查询基于产品的数据连接,因此首次进行SQL取数时,首先要添加数据连接,支持添加多个数据连接,但是输入SQL语句前必须选择对应的查询连接。

(2)查看库表信息

添加数据连接后,列表展示库和表,可切换查看不同库下的表,点击表名,支持查看宽表、复制表名库名、复制全部字段名称等快捷操作:

(3)数据连接的删除和编辑

添加完成的数据连接,支持删除及编辑。

3. SQL编辑区

(1)编写SQL语句

SQL编辑器允许输入SQL语句,支持运行、语法校验、格式优化功能:

  • 点击运行则进行查询
  • 点击语法校验则校验输入的SQL是否有语法错误
  • 点击格式优化则自动优化输入的SQL语句显示格式,便于查阅

(2)插入参数 输入#号可在SQL语句的where条件中插入全局参数进行动态的筛选 ,全局参数的创建详见参数。引用后可以查看项目内全局参数的列表及信息,帮助选择正确的参数:

例如: 要查询最近登录的用户信息,可以在where条件中设置最近登录时间(last_login_time)晚于(小于)某个日期时间的全局参数,点击运行后,查询结果区即出现对应参数控制器,无需修改sql语句,通过修改参数的值就能快速查看不同的数据。

4. 运行结果区

(1)查询结果的保存 SQL取数的查询结果区与可视化取数结果一样,也支持保存为我的查询/公共查询:

(2)查询结果的导出 目前前端仅展示查询结果的前500条数据,如需查看更多数据,则需要导出查询结果,目前查询结果支持导出为Excel/Csv格式的数据文件,同时可将取数结果导出到webhook,从而对接其他系统,如标签系统、活动系统等:

(3)复制数据与查看SQL 查询结果支持复制数据,也可查看SQL,复制的数据可作为筛选条件快速用于下一次的筛选。

(4)多tab页查询 一个tab页仅支持一次查询,打开新的查询时,默认打开一个新的tab页进行查询,也可点击添加按钮添加多个tab页查询窗口,同时进行多个不同查询,提高取数效率:

5. 参数设置区

(1)参数的列表刷新

运行SQL语句前,点击参数列表的刷新按钮,则自动获取当前SQL语句中使用的参数,按列表形式展示参数名称、类型、可选范围及默认值:

(2)参数的编辑

目前仅项目管理员可对全局参数进行编辑,修改参数的名称、默认值、可选范围等设置项:

注意:修改后其他使用全局参数的场景,如报告、自定义sql等均会同步修改。