ClickHouse/docs/ja/engines/table-engines/mergetree-family/graphitemergetree.md

machine_translated	machine_translated_rev	toc_priority	toc_title
true	d734a8e46d	38	グラフィットメールグツリー

グラフィットメールグツリー

このエン) 黒鉛 データ。 GraphiteのデータストアとしてClickHouseを使用したい開発者にとっては役に立つかもしれません。

ロールアップが必要ない場合は、任意のclickhouseテーブルエンジンを使用してグラファイトデータを保存できますが、ロールアップが必要な場合は使用します GraphiteMergeTree. エンジンはストレージの量を減らし、Graphiteからのクエリの効率を高めます。

エンジンを継承性から MergeTree.

テーブルの作成

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, ...]

の詳細な説明を参照してください CREATE TABLE クエリ。

グラファイトデータのテーブルには、次のデータの列が必要です:

• メトリック名（黒鉛センサ）。 データ型: String.

• メトリックを測定する時間。 データ型: DateTime.

• メトリックの値。 データ型:任意の数値。

• メトリックのバージョン。 データ型:任意の数値。

  ClickHouseは、バージョンが同じであれば、最高のバージョンまたは最後に書かれた行を保存します。 その他の行は、データパーツのマージ中に削除されます。

これらの列の名前は、ロールアップ構成で設定する必要があります。

GraphiteMergeTreeパラメータ

• config_section — Name of the section in the configuration file, where are the rules of rollup set.

クエリ句

作成するとき GraphiteMergeTree テーブル、同じ 句 作成するときと同じように、必須です。 MergeTree テーブル。

テーブルを作成する非推奨の方法

!!! attention "注意" 可能であれば、古いプロジェクトを上記の方法に切り替えてください。

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 — Name of the section in the configuration file, where are the rules of rollup set.

ロールアップ構成

ロールアップの設定は、次のように定義されます。 graphite_rollup サーバー構成のパラメーター。 パラメータの名前は任意です。 複数の構成を作成し、それらを異なるテーブルに使用できます。

ロールアップ構成構造:

  required-columns
  patterns

必要な列

• path_column_name — The name of the column storing the metric name (Graphite sensor). Default value: Path.
• time_column_name — The name of the column storing the time of measuring the metric. 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 — The name of the column storing the version of the metric. Default value: Timestamp.

パターン

の構造 patterns セクション:

pattern
    regexp
    function
pattern
    regexp
    age + precision
    ...
pattern
    regexp
    function
    age + precision
    ...
pattern
    ...
default
    function
    age + precision
    ...

!!! warning "注意" パタ:

  1. Patterns without `function` or `retention`.
  1. Patterns with both `function` and `retention`.
  1. Pattern `default`.

行を処理するときに、clickhouseは次のルールをチェックします。 pattern セクション。 それぞれの pattern （を含む default)セクションには function 集計のパラメータ, retention 変数または両方。 このメトリック名が regexp、からのルール pattern セクション(またはセクション)が適用されます。 default セクションを使用します。

フィールドの pattern と default セクション:

• regexp– A pattern for the metric name.
• age – The minimum age of the data in seconds.
• precision– How precisely to define the age of the data in seconds. Should be a divisor for 86400 (seconds in a day).
• function – The name of the aggregating function to apply to data whose age falls within the range [age, age + precision].

構成例

<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>

元の記事