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等均会同步修改。