使用历史记录页面监控查询¶
History 页面允许您查看并深入了解过去 14 天内执行的所有查询的详细信息。该页面显示查询的历史列表,包括从 SnowSQL 或其他 SQL 客户端执行的查询。
备注
有关在 Snowsight 中查看查询历史记录的详细信息,请参阅 使用 Query History 监控查询活动。
每个查询显示的默认信息包括:
查询的当前状态:在队列中等待、正在运行、已成功、已失败。
查询的 SQL 文本。
查询 ID。
有关用于执行查询的仓库的信息。
查询开始和结束时间,以及持续时间。
有关查询的信息,包括扫描的字节数和返回的行数。
备注
Start Time 和 End Time 列显示登录用户所在时区的时间。没有选项可以更改此设置。会话参数不影响此设置。
本主题内容:
功能概览¶
备注
History 页面列源自 QUERY_HISTORY 视图。请参阅 QUERY_HISTORY 视图 了解更多信息,包括列说明。
您可以在 History 页面中执行以下任务:
使用右上角的 auto-refresh 复选框可启用/禁用会话自动刷新。如果选中,页面每 10 秒刷新一次。您还可以随时点击 Refresh 图标来刷新显示。
使用 Show/Hide Filters 切换键打开/关闭一个面板,您可以在其中指定一个或多个筛选器来控制页面上显示的查询。您指定的筛选器对当前会话有效。
使用 Include client-generated statements 复选框可显示或隐藏由 SQL 工作表外部的 Web 界面会话运行的 SQL 语句。例如,每当用户导航到 Warehouses 时,Snowflake 都会在后台执行 SHOW WAREHOUSES 语句。清除 Include client-generated statements 复选框可在显示的查询列表中隐藏此“干扰”。
使用 Include queries executed by user tasks 复选框可以显示或隐藏用户任务执行的 SQL 语句或调用的存储过程。
滚动浏览显示的查询列表。列表包括匹配您筛选条件的(最多)前 100 个查询,或者最新的 100 个查询(当未应用任何筛选器时)。在列表底部,如果有更多查询可用,您可以继续搜索,此举会将(最多)100 个下一个匹配查询添加到列表中。
点击任何列标题可按列对页面进行排序或在显示中添加/删除列。
点击查询文本(或选择查询并点击 View SQL)查看用于查询的完整 SQL。
选择尚未完成的查询,并点击 Abort 中止查询。
点击查询的 ID 可查看查询的详细信息,包括查询结果和查询个人资料。
备注
History 页面显示过去 14 天内执行的查询,从最近的查询开始。您可以使用 End Time 筛选器以显示基于指定日期的查询;但是,如果您指定早于过去 14 天的日期,则不会返回任何结果。
查看查询详细信息和结果¶
Snowflake 将查询结果保留一段时间,之后将清除查询结果。此限制不可调整。有关更多信息,请参阅 使用持久化查询结果。
要查看特定查询的详细信息和结果,请点击 History 页面中的 Query ID。将出现 Query Detail 页面(见下文),您可以在其中查看查询执行详细信息以及查询结果(如果仍然可用)。
您还可以使用 Export Result 按钮将查询结果(如果仍然可用)导出到文件。
备注
您只能查看已执行的查询的结果。如果您有权查看其他用户执行的查询, Query Detail 页面显示查询的详细信息,但出于数据隐私原因,该页面不显示实际的查询结果。
导出查询结果¶
在界面中任何可以查看查询结果的页面(例如, Worksheets、 Query Detail)上,如果查询结果仍然可用,您可以将结果导出到文件。
当您点击 Export Result 按钮进行查询时,系统会提示您指定文件名和格式。Snowflake 支持使用以下文件格式导出查询:
逗号分隔值 (CSV)
制表符分隔值 (TSV)
备注
您只能导出可查看其结果的查询(即已执行的查询)的结果。如果您没有执行查询或查询结果不再可用,则不会为查询显示 Export Result 按钮。
Web 界面只支持导出大小不超过 100 MB 的结果。如果查询结果超出此限制,系统会提示您是否继续导出。
导出提示可能会因您的浏览器而异。例如,在 Safari 中,系统仅提示您输入导出格式(CSV 或者 TSV)。导出完成后,系统会提示您将导出结果下载到新窗口,您可以在其中使用 Save Page As... 浏览器选项将结果保存到文件。
查看查询配置文件¶
除了查询详细信息和结果之外,Snowflake 还提供 Query Profile 用于分析查询统计信息和详细信息,包括组成查询的各个执行组件。有关更多信息,请参阅 使用查询配置文件分析查询。
通过 Snowflake Native App 编辑的查询历史记录数据¶
对于与 Snowflake Native App 相关的查询,query_text
和 error_message
字段在下列情况下通过 查询历史记录 编辑:
安装或升级应用程序时运行的查询。
源自应用程序拥有的存储过程的子作业的查询。
在每种情况下,Snowsight 中查询历史记录的单元格显示空白。