TapCub 正式上线:统计、分析、客服一个平台免费用
帮助中心

怎么用 SQL 查询我的数据?

在行为分析里打开 SQL 页签,对四张已限定到当前站点的视图(v_events、v_sessions、v_persons、v_autocapture)写一条 SELECT。讲清限制、{filters} 占位符和两个查询例子。

数据分析1 分钟阅读最后更新 2026 年 11 月 4 日TapCub 团队

还有其他问题?

没找到答案?每条消息都有真人阅读,工作日通常几小时内回复。

在线咨询

简短回答

在 全端分析 › 行为分析 › 行为分析 里打开 SQL 页签,对 v_events、v_sessions、v_persons 或 v_autocapture 写一条 SELECT,这些视图已限定到当前站点和日期范围。最多返回 50,000 行,超时 30 秒。

简短回答

打开 全端分析 › 行为分析 › 行为分析,切到 SQL 页签。对视图 v_events、v_sessions、v_persons 或 v_autocapture 写一条 SELECT(或 WITH … SELECT)。这些视图已经限定在当前站点和所选日期范围内。按 Command-Enter 或 Ctrl-Enter 运行。

SQL 适合内置模型给不了的交叉表和一次性清单。经常要看的比率,改为保存一个自定义指标。

四张视图

视图范围常用列
v_events当前站点、所选日期ts、name、path、title、ref_channel、utm_source、utm_campaign、country、device_type、props、session_id、subject
v_sessions当前站点、按会话开始时间id、started_at、entry_path、exit_path、pageviews、duration、channel、is_bounce、engaged、device_type、subject
v_persons当前站点,不按时间截取person_id、first_seen、last_seen、identified_by、device_count、props
v_autocapture当前站点、所选日期kind、path、selector、el_text、x、y、depth

subject 是人、访客还是账户,取决于构建器里选的口径。

两个查询例子

按渠道和设备看会话数和有效会话数:

SELECT channel, device_type,
       COUNT(*) AS sessions,
       SUM(CASE WHEN engaged = 1 THEN 1 ELSE 0 END) AS engaged_sessions
FROM v_sessions
GROUP BY channel, device_type
ORDER BY sessions DESC

包含注册的会话,入口页是哪些:

WITH signups AS (
  SELECT DISTINCT session_id FROM v_events WHERE name = 'signup'
)
SELECT s.entry_path, COUNT(*) AS sessions
FROM v_sessions s
JOIN signups g ON s.id = g.session_id
GROUP BY s.entry_path
ORDER BY sessions DESC
LIMIT 20

要套用构建器的全局筛选,在 WHERE 里写 {filters}:WHERE {filters}。没有筛选时它会变成恒为真,而且只对视图里有的列生效。「返回改写后的 SQL」可以看到实际执行的语句。

限制

  • 只能有一条 SELECT 或 WITH 语句。注释、分号、反引号、写操作和系统表都会被拒绝,真实表名也一样。
  • 最多返回 50,000 行(结果被截断时底部会提示),超时 30 秒,SQL 最长 20,000 个字符。
  • 没有拆分控件,也没有对比区间;分群对比会被拒绝。
  • 有隐藏属性的成员不能运行 SQL。

常见错误

提示处理
必须引用至少一张视图查询 v_events、v_sessions、v_persons 或 v_autocapture
只能查询四张视图去掉库名和表名,改用视图
超时缩小日期范围、尽早聚合、加上 LIMIT

要生成一个文件给别人以后下载?用导出任务,见导出原始数据。

这篇回答解决你的问题了吗?

我们会根据反馈修改和补充这篇内容。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie