跳到主要内容
跳到主要内容

时间序列引擎

Experimental feature. Learn more.
Not supported in ClickHouse Cloud

一个存储时间序列的表引擎，即与时间戳和标签（或标记）相关联的一组值：

信息

这是一个实验性功能，未来版本中可能会以不向后兼容的方式进行更改。 使用 allow_experimental_time_series_table 设置启用时间序列表引擎。 输入命令 set allow_experimental_time_series_table = 1。

语法​

用法​

默认设置下开始会更容易（可以创建一个不指定列列表的 TimeSeries 表）：

然后这个表可以通过以下协议使用（必须在服务器配置中分配一个端口）：

目标表​

TimeSeries 表没有自己的数据，所有数据都存储在其目标表中。 这与 物化视图 的工作方式类似， 不同之处在于物化视图只有一个目标表， 而 TimeSeries 表有三个目标表，分别命名为 data、tags 和 metrics。

目标表既可以在 CREATE TABLE 查询中显式指定， 也可以让 TimeSeries 表引擎自动生成内部目标表。

目标表如下：

数据表​

数据 表包含与某个标识符相关的时间序列。

数据 表必须包含以下列：

名称必需？默认类型可能类型描述
id[x]UUID任意标识一组度量名称和标签的组合
timestamp[x]DateTime64(3)DateTime64(X)时间点
value[x]Float64Float32 或 Float64与 timestamp 相关联的值

标签表​

标签 表包含为每个度量名称和标签组合计算出的标识符。

标签 表必须包含以下列：

名称必需？默认类型可能类型描述
id[x]UUID任何（必须与 data 表中的 id 类型匹配）一个 id 标识度量名称和标签的组合。DEFAULT 表达式指定如何计算该标识符
metric_name[x]LowCardinality(String)String 或 LowCardinality(String)一个度量的名称
<tag_value_column>[ ]StringString 或 LowCardinality(String) 或 LowCardinality(Nullable(String))特定标签的值，标签的名称和相应列的名称在 tags_to_columns 设置中指定
tags[x]Map(LowCardinality(String), String)Map(String, String) 或 Map(LowCardinality(String), String) 或 Map(LowCardinality(String), LowCardinality(String))标签的映射，排除标签 __name__，包含度量名称，并排除在 tags_to_columns 设置中列举的标签
all_tags[ ]Map(String, String)Map(String, String) 或 Map(LowCardinality(String), String) 或 Map(LowCardinality(String), LowCardinality(String))瞬态列，每一行是所有标签的映射，仅排除标签 __name__，包含度量名称。该列的唯一目的是在计算 id 时使用
min_time[ ]Nullable(DateTime64(3))DateTime64(X) 或 Nullable(DateTime64(X))具有该 id 的时间序列的最小时间戳。若 store_min_time_and_max_time 为 true，则会创建该列
max_time[ ]Nullable(DateTime64(3))DateTime64(X) 或 Nullable(DateTime64(X))具有该 id 的时间序列的最大时间戳。若 store_min_time_and_max_time 为 true，则会创建该列

度量表​

度量 表包含有关收集的度量、这些度量的类型及其描述的一些信息。

度量 表必须包含以下列：

名称必需？默认类型可能类型描述
metric_family_name[x]StringString 或 LowCardinality(String)度量系列的名称
type[x]StringString 或 LowCardinality(String)度量系列的类型，可以是 "counter"、"gauge"、"summary"、"stateset"、"histogram"、"gaugehistogram" 之一
unit[x]StringString 或 LowCardinality(String)度量中使用的单位
help[x]StringString 或 LowCardinality(String)度量的描述

插入到 TimeSeries 表中的任何行实际上将存储在这三个目标表中。 TimeSeries 表包含来自 data、tags、metrics 表的所有这些列。

创建​

可以通过多种方法创建使用 TimeSeries 表引擎的表。 最简单的语句

实际上会创建如下表（您可以通过执行 SHOW CREATE TABLE my_table 查看）：

因此列是自动生成的，并且该语句中还有三个内部 UUID - 每个内部目标表一个 UUID。 （内部 UUID 通常不会显示，直到设置 show_table_uuid_in_table_create_query_if_not_nil 被设置。）

内部目标表的名称类似于 .inner_id.data.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx、 .inner_id.tags.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx、.inner_id.metrics.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx， 每个目标表的列是主 TimeSeries 表列的一个子集：

调整列的类型​

您可以通过在定义主表时显式指定几乎任何内部目标表的列类型来调整它们的类型。例如，

将使内部 data 表以微秒存储时间戳，而不是毫秒：

id 列​

id 列包含标识符，每个标识符是为度量名称和标签组合计算得出的。 id 列的 DEFAULT 表达式是用于计算这些标识符的表达式。 您可以通过显式指定它们来调整 id 列的类型和该表达式：

tags 和 all_tags 列​

有两个包含标签映射的列 - tags 和 all_tags。在此示例中，它们的意思是相同的，然而如果使用设置 tags_to_columns，它们可能会不同。该设置允许指定特定标签应该存储在单独的列中，而不是存储在 tags 列中的映射内：

该语句将添加列

到 my_table 和其内部 tags 目标表的定义中。这种情况下 tags 列将不包含标签 instance 和 job， 但 all_tags 列将包含它们。all_tags 列是瞬态的，其唯一目的用于 id 列的 DEFAULT 表达式。

可以通过显式指定它们来调整列的类型：

内部目标表的表引擎​

默认情况下，内部目标表使用以下表引擎：

  • data 表使用 MergeTree；
  • tags 表使用 AggregatingMergeTree，因为该表通常多次插入相同的数据，因此我们需要一种去除重复项的方法，同时也因为需要对 min_time 和 max_time 列进行聚合；
  • metrics 表使用 ReplacingMergeTree，因为该表通常多次插入相同的数据，因此我们需要一种去除重复项的方法。

如果指定，也可以为内部目标表使用其他表引擎：

外部目标表​

可以使 TimeSeries 表使用手动创建的表：

设置​

以下是定义 TimeSeries 表时可以指定的设置列表：

名称类型默认描述
tags_to_columnsMap映射，指定哪些标签应该放到 tags 表中的单独列中。语法： {'tag1': 'column1', 'tag2' : column2, ...}
use_all_tags_column_to_generate_idBooltrue当生成计算时间序列标识符的表达式时，该标志启用使用 all_tags 列进行该计算
store_min_time_and_max_timeBooltrue如果设置为 true，则该表将存储每个时间序列的 min_time 和 max_time
aggregate_min_time_and_max_timeBooltrue在创建内部目标 tags 表时，该标志启用使用 SimpleAggregateFunction(min, Nullable(DateTime64(3))) 而不是仅仅使用 Nullable(DateTime64(3)) 作为 min_time 列的类型，最大时间列同理
filter_by_min_time_and_max_timeBooltrue如果设置为 true，则该表将使用 min_time 和 max_time 列过滤时间序列

函数

以下是支持 TimeSeries 表作为参数的函数列表：