ClickHouse/docs/zh/engines/table-engines/mergetree-family/graphitemergetree.md
Tom Bombadil a541b51647
Update graphitemergetree.md
translate the doc to Chinese version
2020-06-18 22:27:43 +08:00

168 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
toc_priority: 38
toc_title: GraphiteMergeTree
---
# GraphiteMergeTree {#graphitemergetree}
该引擎用来对 [Graphite](http://graphite.readthedocs.io/en/latest/index.html)数据进行瘦身及汇总。对于想使用CH来存储Graphite数据的开发者来说可能有用。
如果不需要对Graphite数据做汇总那么可以使用任意的CH表引擎但若需要那就采用 `GraphiteMergeTree` 引擎。它能减少存储空间同时能提高Graphite数据的查询效率。
该引擎继承自 [MergeTree](../../../engines/table-engines/mergetree-family/mergetree.md).
## 创建表 {#creating-table}
``` sql
CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
Path String,
Time DateTime,
Value <Numeric_type>,
Version <Numeric_type>
...
) ENGINE = GraphiteMergeTree(config_section)
[PARTITION BY expr]
[ORDER BY expr]
[SAMPLE BY expr]
[SETTINGS name=value, ...]
```
建表语句的详细说明请参见 [创建表](../../../sql-reference/statements/create.md#create-table-query)
含有Graphite数据集的表应该包含以下的数据列
- 指标名称(Graphite sensor),数据类型:`String`
- 指标的时间度量,数据类型: `DateTime`
- 指标的值,数据类型:任意数值类型
- 指标的版本号,数据类型: 任意数值类型
CH以最大的版本号保存行记录若版本号相同保留最后写入的数据。
以上列必须设置在汇总参数配置中。
**GraphiteMergeTree 参数**
- `config_section` - 配置文件中标识汇总规则的节点名称
**建表语句**
在创建 `GraphiteMergeTree` 表时,需要采用和 [clauses](../../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) 相同的语句,就像创建 `MergeTree` 一样。
<details markdown="1">
<summary>已废弃的建表语句</summary>
!!! 注意 "Attention"
请不要在新项目中使用;如有可能,请将旧的项目按上述的方法进行替换。
``` sql
CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
EventDate Date,
Path String,
Time DateTime,
Value <Numeric_type>,
Version <Numeric_type>
...
) ENGINE [=] GraphiteMergeTree(date-column [, sampling_expression], (primary, key), index_granularity, config_section)
```
除了`config_section`,其它所有参数和`MergeTree`的相应参数一样.
- `config_section` —配置文件中设置汇总规则的节点
</details>
## 汇总配置的参数 {#rollup-configuration}
汇总的配置参数由服务器配置的 [graphite\_rollup](../../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-graphite) 参数定义。参数名称可以是任意的。允许为多个不同表创建多组配置并使用。
汇总配置的结构如下:
所需的列
模式Patterns
### 所需的列 {#required-columns}
- `path_column_name` — 保存指标名称的列名 (Graphite sensor). 默认值: `Path`.
- `time_column_name` — 保存指标时间度量的列名. Default value: `Time`.
- `value_column_name` — The name of the column storing the value of the metric at the time set in `time_column_name`.默认值: `Value`.
- `version_column_name` - 保存指标的版本号列. 默认值: `Timestamp`.
### 模式Patterns {#patterns}
`patterns` 的结构:
``` text
pattern
regexp
function
pattern
regexp
age + precision
...
pattern
regexp
function
age + precision
...
pattern
...
default
function
age + precision
...
```
!!! 注意 "Attention"
模式必须严格按顺序配置:
1. 不含`function` or `retention`的Patterns
1. 同时含有`function` and `retention`的Patterns
1. `default`的Patterns.
CH在处理行记录时会检查 `pattern`节点的规则。每个 `pattern`(含`default`)节点可以包含 `function` 用于聚合操作,或`retention`参数,或者两者都有。如果指标名称和 `regexp`相匹配,相应 `pattern`的规则会生效;否则,使用 `default` 节点的规则。
`pattern` 和 `default` 节点的字段设置:
- `regexp` 指标名的pattern.
- `age` 数据的最小存活时间(按秒算).
- `precision` 按秒来衡量数据存活时间时的精确程度. 必须能被86400整除 (一天的秒数).
- `function` 对于存活时间在 `[age, age + precision]`之内的数据,需要使用的聚合函数
### 配置示例 {#configuration-example}
``` xml
<graphite_rollup>
<version_column_name>Version</version_column_name>
<pattern>
<regexp>click_cost</regexp>
<function>any</function>
<retention>
<age>0</age>
<precision>5</precision>
</retention>
<retention>
<age>86400</age>
<precision>60</precision>
</retention>
</pattern>
<default>
<function>max</function>
<retention>
<age>0</age>
<precision>60</precision>
</retention>
<retention>
<age>3600</age>
<precision>300</precision>
</retention>
<retention>
<age>86400</age>
<precision>3600</precision>
</retention>
</default>
</graphite_rollup>
```
[原始文档](https://clickhouse.tech/docs/en/operations/table_engines/graphitemergetree/) <!--hide-->