> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 从 TimeSeries 表中读取经选择器过滤且时间戳位于指定时间间隔内的时间序列。

# timeSeriesSelector

从 TimeSeries 表中读取经选择器过滤且时间戳位于指定时间间隔内的时间序列。
此函数类似于 [范围选择器](https://prometheus.io/docs/prometheus/latest/querying/basics/#range-vector-selectors)，但也可用于实现 [即时选择器](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)。

<div id="syntax">
  ## 语法
</div>

```sql theme={null}
timeSeriesSelector('db_name', 'time_series_table', 'instant_query', min_time, max_time)
timeSeriesSelector(db_name.time_series_table, 'instant_query', min_time, max_time)
timeSeriesSelector('time_series_table', 'instant_query', min_time, max_time)
```

<div id="arguments">
  ## 参数
</div>

* `db_name` - TimeSeries 表所在数据库的名称。
* `time_series_table` - TimeSeries 表的名称。
* `instant_query` - 采用 [PromQL 语法](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors) 编写的即时选择器，不包含 `@` 或 `offset` 修饰符。
* \`min\_time - 起始时间戳，含边界值。
* \`max\_time - 结束时间戳，含边界值。

<div id="returned_value">
  ## 返回值
</div>

该函数返回三列：

* `id` - 包含与指定选择器匹配的时间序列标识符。
* `timestamp` - 包含时间戳。
* `value` - 包含值。

返回的数据没有固定顺序。

<div id="example">
  ## 示例
</div>

```sql theme={null}
SELECT * FROM timeSeriesSelector(mytable, 'http_requests{job="prometheus"}', now() - INTERVAL 10 MINUTES, now())
```
