文档文档

OFFSET 和 SOFFSET 子句

使用 OFFSET 指定在每个 InfluxQL 组中返回结果前要跳过的 数。使用 SOFFSET 指定在返回结果前要跳过的 序列数。

OFFSET 子句

OFFSET 子句在返回每个 InfluxQL 组的结果前会跳过 N 行。偏移量会遵循 LIMIT 子句中指定的行数限制,并在指定的偏移量后显示限制数量的行。将 LIMITOFFSET 一起使用可以对查询结果进行分页。

语法

SELECT_clause FROM_clause [WHERE_clause] [GROUP_BY_clause] [ORDER_BY_clause] [LIMIT_clause] OFFSET N [SLIMIT_clause] [SOFFSET_clause]

参数

  • N:在返回每个 InfluxQL 组的结果前要跳过的行数。

OFFSET 子句的注意事项

  • 如果包含 OFFSET 子句的查询中没有 LIMIT 子句,则查询将在指定偏移量处为每个 InfluxQL 组返回一行。
  • 如果查询不包含 GROUP BY 子句,则整个结果集将被视为一个组并完整返回。
  • 如果查询 按时间对数据进行分组,则偏移量将在聚合和选择器操作应用于每个时间窗口后应用。
  • 如果 WHERE 子句包含时间范围,并且 OFFSET 子句导致 InfluxQL 返回时间戳超出该时间范围的点,则 InfluxQL 不返回任何结果。

示例

以下示例使用 家庭传感器示例数据

返回第 N 行

按 3 分页结果并返回结果的第 2 页

按每个序列 3 分页结果并返回每个序列的第 2 页

SOFFSET 子句

InfluxQL 正在被重构以与 InfluxDB 3 存储引擎配合使用。此过程正在进行中,一些 InfluxQL 功能(如 SOFFSET)仍在实现中。有关更多信息,请参阅 InfluxQL 功能支持


此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2