ClickHouse入门实践--MergeTree原理解析

MergeTree原理解析

表引擎是ClickHouse设计实现中的一大特点。能够说，是表引擎决定了一张数据表最终的“性格”，好比数据表拥有何种特性、数据以何种形式被存储以及如何被加载。ClickHouse拥有很是庞大的表引擎体系，截至本书完成时，其共拥有合并树、外部存储、内存、文件、接口和其余6大类20多种表引擎。而在这众多的表引擎中，又属合并树（MergeTree）表引擎及其家族系列(*MergeTree)最为强大，在生产环境的绝大部分场景中，都会使用此系列的表引擎。由于只有合并树系列的表引擎才支持主键索引、数据分区、数据副本和数据采样这些特性，同时也只有此系列的表引擎支持ALTER相关操做。合并树家族自身也拥有多种表引擎的变种。其中MergeTree做为家族中最基础的表引擎，提供了主键索引、数据分区、数据副本和数据采样等基本能力，而家族中其余的表引擎则在MergeTree的基础之上各有所长。例如ReplacingMergeTree表引擎具备删除重复数据的特性，而SummingMergeTree表引擎则会按照排序键自动聚合数据。若是给合并树系列的表引擎加上Replicated前缀，又会获得一组支持数据副本的表引擎，例如ReplicatedMergeTree、ReplicatedReplacingMergeTree、ReplicatedSummingMergeTree等。合并树表引擎家族如图所示：

虽然合并树的变种不少，但MergeTree表引擎才是根基。做为合并树家族系列中最基础的表引擎，MergeTree具有了该系列其余表引擎共有的基本特征，因此吃透了MergeTree表引擎的原理，就可以掌握该系列引擎的精髓。

MergeTree的建立方式与存储结构

MergeTree在写入一批数据时，数据总会以数据片断的形式写入磁盘，且数据片断不可修改。为了不片断过多，ClickHouse会经过后台线程，按期合并这些数据片断，属于相同分区的数据片断会被合成一个新的片断。这种数据片断往复合并的特色，也正是合并树名称的由来。

MergeTree的建立方式

建立MergeTree数据表的方法，与咱们第4章介绍的定义数据表的方法大体相同，但须要将ENGINE参数声明为MergeTree()，其完整的语法以下所示：

MergeTree表引擎除了常规参数以外，还拥有一些独有的配置选项。接下来会着重介绍其中几个重要的参数，包括它们的使用方法和工做原理。可是在此以前，仍是先介绍一遍它们的做用。

（1）PARTITION BY [选填]：分区键，用于指定表数据以何种标准进行分区。分区键既能够是单个列字段，也能够经过元组的形式使用多个列字段，同时它也支持使用列表达式。若是不声明分区键，则ClickHouse会生成一个名为all的分区。合理使用数据分区，能够有效减小查询时数据文件的扫描范围。

（2）ORDER BY [必填]：排序键，用于指定在一个数据片断内，数据以何种标准排序。默认状况下主键（PRIMARY KEY）与排序键相同。排序键既能够是单个列字段，例如ORDER BY CounterID，也能够经过元组的形式使用多个列字段，例如ORDER BY（CounterID, EventDate）。当使用多个列字段排序时，以ORDERBY（CounterID, EventDate）为例，在单个数据片断内，数据首先会以CounterID排序，相同CounterID的数据再按EventDate排序。

（3）PRIMARY KEY [选填]：主键，顾名思义，声明后会依照主键字段生成一级索引，用于加速表查询。默认状况下，主键与排序键(ORDER BY)相同，因此一般直接使用ORDER BY代为指定主键，无须刻意经过PRIMARY KEY声明。因此在通常状况下，在单个数据片断内，数据与一级索引以相同的规则升序排列。与其余数据库不一样，MergeTree主键容许存在重复数据（ReplacingMergeTree能够去重）。

（4）SAMPLE BY [选填]：抽样表达式，用于声明数据以何种标准进行采样。若是使用了此配置项，那么在主键的配置中也须要声明一样的表达式，例如：

抽样表达式须要配合SAMPLE子查询使用，这项功能对于选取抽样数据十分有用。

（5）SETTINGS: index_granularity [选填]:index_granularity对于MergeTree而言是一项很是重要的参数，它表示索引的粒度，默认值为8192。也就是说，MergeTree的索引在默认状况下，每间隔8192行数据才生成一条索引，其具体声明方式以下所示：

8192是一个神奇的数字，在ClickHouse中大量数值参数都有它的影子，能够被其整除（例如最小压缩块大小min_compress_block_size:65536）。一般状况下并不须要修改此参数，但理解它的工做原理有助于咱们更好地使用MergeTree。关于索引详细的工做原理会在后续阐述。

（6）SETTINGS: index_granularity_bytes [选填]：在19.11版本以前，ClickHouse只支持固定大小的索引间隔，由index_granularity控制，默认为8192。在新版本中，它增长了自适应间隔大小的特性，即根据每一批次写入数据的体量大小，动态划分间隔大小。而数据的体量大小，正是由index_granularity_bytes参数控制的，默认为10M(10×1024×1024)，设置为0表示不启动自适应功能。

（7）SETTINGS: enable_mixed_granularity_parts [选填]：设置是否开启自适应索引间隔的功能，默认开启。

（8）SETTINGS: merge_with_ttl_timeout [选填]：从19.6版本开始，MergeTree提供了数据TTL的功能。

（9）SETTINGS: storage_policy [选填]：从19.15版本开始，MergeTree提供了多路径的存储策略。

MergeTree的存储结构

MergeTree表引擎中的数据是拥有物理存储的，数据会按照分区目录的形式保存到磁盘之上，其完整的存储结构如图所示：

从图中能够看出，一张数据表的完整物理结构分为3个层级，依次是数据表目录、分区目录及各分区下具体的数据文件。接下来就逐一介绍它们的做用。
（1）partition：分区目录，余下各种数据文件（primary.idx、[Column].mrk、[Column]. bin等）都是以分区目录的形式被组织存放的，属于相同分区的数据，最终会被合并到同一个分区目录，而不一样分区的数据，永远不会被合并在一块儿。更多关于数据分区的细节会在6.2节阐述。
（2）checksums.txt：校验文件，使用二进制格式存储。它保存了余下各种文件(primary. idx、count.txt等)的size大小及size的哈希值，用于快速校验文件的完整性和正确性。
（3）columns.txt：列信息文件，使用明文格式存储。用于保存此数据分区下的列字段信息，例如：

（4）count.txt：计数文件，使用明文格式存储。用于记录当前数据分区目录下数据的总行数：
（5）primary.idx：一级索引文件，使用二进制格式存储。用于存放稀疏索引，一张MergeTree表只能声明一次一级索引（经过ORDER BY或者PRIMARY KEY）。借助稀疏索引，在数据查询的时可以排除主键条件范围以外的数据文件，从而有效减小数据扫描范围，加速查询速度。
（6）[Column].bin：数据文件，使用压缩格式存储，默认为LZ4压缩格式，用于存储某一列的数据。因为MergeTree采用列式存储，因此每个列字段都拥有独立的．bin数据文件，并以列字段名称命名（例如CounterID.bin、EventDate.bin等）。
（7）[Column].mrk：列字段标记文件，使用二进制格式存储。标记文件中保存了．bin文件中数据的偏移量信息。标记文件与稀疏索引对齐，又与．bin文件一一对应，因此MergeTree经过标记文件创建了primary.idx稀疏索引与．bin数据文件之间的映射关系。即首先经过稀疏索引（primary.idx）找到对应数据的偏移量信息（.mrk），再经过偏移量直接从．bin文件中读取数据。因为．mrk标记文件与．bin文件一一对应，因此MergeTree中的每一个列字段都会拥有与其对应的．mrk标记文件（例如CounterID.mrk、EventDate.mrk等）。
（8）[Column].mrk2：若是使用了自适应大小的索引间隔，则标记文件会以．mrk2命名。它的工做原理和做用与．mrk标记文件相同。
（9）partition.dat与minmax_[Column].idx：若是使用了分区键，例如PARTITION BY EventTime，则会额外生成partition.dat与minmax索引文件，它们均使用二进制格式存储。partition.dat用于保存当前分区下分区表达式最终生成的值；而minmax索引用于记录当前分区下分区字段对应原始数据的最小和最大值。例如EventTime字段对应的原始数据为2019-05-0一、2019-05-05，分区表达式为PARTITION BY toYYYYMM(EventTime)。partition.dat中保存的值将会是2019-05，而minmax索引中保存的值将会是2019-05-012019-05-05。
在这些分区索引的做用下，进行数据查询时可以快速跳过没必要要的数据分区目录，从而减小最终须要扫描的数据范围。

（10）skp_idx_[Column].idx与skp_idx_[Column].mrk：若是在建表语句中声明了二级索引，则会额外生成相应的二级索引与标记文件，它们一样也使用二进制存储。二级索引在ClickHouse中又称跳数索引，目前拥有minmax、set、ngrambf_v1和tokenbf_v1四种类型。这些索引的最终目标与一级稀疏索引相同，都是为了进一步减小所需扫描的数据范围，以加速整个查询过程。

数据分区

经过先前的介绍已经知晓在MergeTree中，数据是以分区目录的形式进行组织的，每一个分区独立分开存储。借助这种形式，在对MergeTree进行数据查询时，能够有效跳过无用的数据文件，只使用最小的分区目录子集。这里有一点须要明确，在ClickHouse中，数据分区（partition）和数据分片（shard）是彻底不一样的概念。数据分区是针对本地数据而言的，是对数据的一种纵向切分。MergeTree并不能依靠分区的特性，将一张表的数据分布到多个ClickHouse服务节点。而横向切分是数据分片（shard）的能力。

数据的分区规则

MergeTree数据分区的规则由分区ID决定，而具体到每一个数据分区所对应的ID，则是由分区键的取值决定的。分区键支持使用任何一个或一组字段表达式声明，其业务语义能够是年、月、日或者组织单位等任何一种规则。针对取值数据类型的不一样，分区ID的生成逻辑目前拥有四种规则：

（1）不指定分区键：若是不使用分区键，即不使用PARTITION BY声明任何分区表达式，则分区ID默认取名为all，全部的数据都会被写入这个all分区。
（2）使用整型：若是分区键取值属于整型(兼容UInt64，包括有符号整型和无符号整型)，且没法转换为日期类型YYYYMMDD格式，则直接按照该整型的字符形式输出，做为分区ID的取值。
（3）使用日期类型：若是分区键取值属于日期类型，或者是可以转换为YYYYMMDD格式的整型，则使用按照YYYYMMDD进行格式化后的字符形式输出，并做为分区ID的取值。
（4）使用其余类型：若是分区键取值既不属于整型，也不属于日期类型，例如String、Float等，则经过128位Hash算法取其Hash值做为分区ID的取值。数据在写入时，会对照分区ID落入相应的数据分区，下表列举了分区ID在不一样规则下的一些示例。

若是经过元组的方式使用多个分区字段，则分区ID依旧是根据上述规则生成的，只是多个ID之间经过“-”符号依次拼接。例如按照上述表格中的例子，使用两个字段分区：

则最终的分区ID会是下面的模样：

分区目录的命名规则

咱们已经知道了分区ID的生成规则。可是若是进入数据表所在的磁盘目录后，会发现MergeTree分区目录的完整物理名称并非只有ID而已，在ID以后还跟着一串奇怪的数字，例如201905_1_1_0。那么这些数字又表明着什么呢？

众所周知，对于MergeTree而言，它最核心的特色是其分区目录的合并动做。可是咱们可曾想过，从分区目录的命名中便可以解读出它的合并逻辑。在这一小节，咱们会着重对命名公式中各分项进行解读，而关于具体的目录合并过程将会留在后面小节讲解。一个完整分区目录的命名公式以下所示：

若是对照着示例数据，那么数据与公式的对照关系会如同下图所示通常。

上图中，201905表示分区目录的ID;1_1分别表示最小的数据块编号与最大的数据块编号；而最后的_0则表示目前合并的层级。接下来开始分别解释它们的含义：
（1）PartitionID：分区ID，无须多说，关于分区ID的规则在上一小节中已经作过详细阐述了。
（2）MinBlockNum和MaxBlockNum：顾名思义，最小数据块编号与最大数据块编号。ClickHouse在这里的命名彷佛有些歧义，很容易让人与稍后会介绍到的数据压缩块混淆。可是本质上它们毫无关系，这里的BlockNum是一个整型的自增加编号。若是将其设为n的话，那么计数n在单张MergeTree数据表内全局累加，n从1开始，每当新建立一个分区目录时，计数n就会累积加1。对于一个新的分区目录而言，MinBlockNum与MaxBlockNum取值同样，同等于n，例如201905_1_1_0、201906_2_2_0以此类推。可是也有例外，当分区目录发生合并时，对于新产生的合并目录MinBlockNum与MaxBlockNum有着另外的取值规则。对于合并规则，咱们留到下一小节再详细讲解。
（3）Level：合并的层级，能够理解为某个分区被合并过的次数，或者这个分区的年龄。数值越高表示年龄越大。Level计数与BlockNum有所不一样，它并非全局累加的。对于每个新建立的分区目录而言，其初始值均为0。以后，以分区为单位，若是相同分区发生合并动做，则在相应分区内计数累积加1。

分区目录的合并过程

MergeTree的分区目录和传统意义上其余数据库有所不一样。首先，MergeTree的分区目录并非在数据表被建立以后就存在的，而是在数据写入过程当中被建立的。也就是说若是一张数据表没有任何数据，那么也不会有任何分区目录存在。其次，它的分区目录在创建以后也并非一成不变的。在其余某些数据库的设计中，追加数据后目录自身不会发生变化，只是在相同分区目录中追加新的数据文件。而MergeTree彻底不一样，伴随着每一批数据的写入（一次INSERT语句）,MergeTree都会生成一批新的分区目录。即使不一样批次写入的数据属于相同分区，也会生成不一样的分区目录。也就是说，对于同一个分区而言，也会存在多个分区目录的状况。在以后的某个时刻（写入后的10～15分钟，也能够手动执行optimize查询语句）, ClickHouse会经过后台任务再将属于相同分区的多个目录合并成一个新的目录。已经存在的旧分区目录并不会当即被删除，而是在以后的某个时刻经过后台任务被删除（默认8分钟）。

属于同一个分区的多个目录，在合并以后会生成一个全新的目录，目录中的索引和数据文件也会相应地进行合并。新目录名称的合并方式遵循如下规则，其中：
❑ MinBlockNum：取同一分区内全部目录中最小的MinBlockNum值。
❑ MaxBlockNum：取同一分区内全部目录中最大的MaxBlockNum值。
❑ Level：取同一分区内最大Level值并加1。

合并目录名称的变化过程如图所示：

partition_v5测试表按日期字段格式分区，即PARTITION BYtoYYYYMM（EventTime）, T表示时间。假设在T0时刻，首先分3批（3次INSERT语句）写入3条数据人：

INSERT INTO partition_v5 values
('A','c1','2019-05-01'),
('B','c2','2019-05-02'),
('C','c1','2019-06-01');

按照目录规，上述代码会建立3个分区目录。分区目录的名称由PartitionID、MinBlockNum、MaxBlockNum和Level组成，其中PartitionID根据6.2.1节介绍的生成规则，3个分区目录的ID依次为20190五、201905和201906。而对于每一个新建的分区目录而言，它们的MinBlockNum与MaxBlockNum取值相同，均来源于表内全局自增的BlockNum。BlockNum初始为1，每次新建目录后累计加1。因此，3个分区目录的MinBlockNum与MaxBlockNum依次为0_0、1_1和2_2。最后是Level层级，每一个新建的分区目录初始Level都是0。因此3个分区目录的最终名称分别是201905_1_1_0、201905_2_2_0和201906_3_3_0。

假设在T1时刻，MergeTree的合并动做开始了，那么属于同一分区的201905_1_1_0与201905_2_2_0目录将发生合并。从图6-4所示过程当中能够发现，合并动做完成后，生成了一个新的分区201905_1_2_1。根据本节所述的合并规则，其中，MinBlockNum取同一分区内全部目录中最小的MinBlockNum值，因此是1; MaxBlockNum取同一分区内全部目录中最大的MaxBlockNum值，因此是2；而Level则取同一分区内，最大Level值加1，因此是1。然后续T2时刻的合并规则，只是在重复刚才所述的过程而已。

至此，你们已经知道了分区ID、目录命名和目录合并的相关规则。最后，再用一张完整的示例图做为总结，描述MergeTree分区目录从建立、合并到删除的整个过程:

分区目录在发生合并以后，旧的分区目录并无被当即删除，而是会存留一段时间。可是旧的分区目录已再也不是激活状态(active=0)，因此在数据查询时，它们会被自动过滤掉。

一级索引

MergeTree的主键使用PRIMARY KEY定义，待主键定义以后，MergeTree会依据index_granularity间隔（默认8192行），为数据表生成一级索引并保存至primary.idx文件内，索引数据按照PRIMARY KEY排序。相比使用PRIMARY KEY定义，更为常见的简化形式是经过ORDER BY指代主键。在此种情形下，PRIMARY KEY与ORDER BY定义相同，因此索引（primary.idx）和数据（.bin）会按照彻底相同的规则排序。

稀疏索引

primary.idx文件内的一级索引采用稀疏索引实现。此时有人可能会问，既然提到了稀疏索引，那么是否是也有稠密索引呢？还真有！稀疏索引和稠密索引的区别如图所示。

简单来讲，在稠密索引中每一行索引标记都会对应到一行具体的数据记录。而在稀疏索引中，每一行索引标记对应的是一段数据，而不是一行。用一个形象的例子来讲明：若是把MergeTree比做一本书，那么稀疏索引就比如是这本书的一级章节目录。一级章节目录不会具体对应到每一个字的位置，只会记录每一个章节的起始页码。

稀疏索引的优点是显而易见的，它仅需使用少许的索引标记就可以记录大量数据的区间位置信息，且数据量越大优点越为明显。以默认的索引粒度（8192）为例，MergeTree只须要12208行索引标记就能为1亿行数据记录提供索引。因为稀疏索引占用空间小，因此primary.idx内的索引数据常驻内存，取用速度天然极快。

索引粒度

在先前的篇幅中已经数次出现过index_granularity这个参数了，它表示索引的粒度。虽然在新版本中，ClickHouse提供了自适应粒度大小的特性，可是为了便于理解，仍然会使用固定的索引粒度（默认8192）进行讲解。索引粒度对MergeTree而言是一个很是重要的概念，所以颇有必要对它作一番深刻解读。索引粒度就如同标尺通常，会丈量整个数据的长度，并依照刻度对数据进行标注，最终将数据标记成多个间隔的小段:

数据以index_granularity的粒度(默认8192)被标记成多个小的区间，其中每一个区间最多8192行数据。MergeTree使用MarkRange表示一个具体的区间，并经过start和end表示其具体的范围。index_granularity的命名虽然取了索引二字，但它不单只做用于一级索引(.idx)，同时也会影响数据标记(.mrk)和数据文件(.bin)。由于仅有一级索引自身是没法完成查询工做的，它须要借助数据标记才能定位数据，因此一级索引和数据标记的间隔粒度相同(同为index_granularity行)，彼此对齐。而数据文件也会依照index_granularity的间隔粒度生成压缩数据块。关于数据文件和数据标记的细节会在后面说明。

索引数据的生成规则

因为是稀疏索引，因此MergeTree须要间隔index_granularity行数据才会生成一条索引记录，其索引值会依据声明的主键字段获取。图6-8所示是对照测试表hits_v1中的真实数据具象化后的效果。hits_v1使用年月分区（PARTITION BYtoYYYYMM(EventDate)），因此2014年3月份的数据最终会被划分到同一个分区目录内。若是使用CounterID做为主键（ORDER BY CounterID），则每间隔8192行数据就会取一次CounterID的值做为索引值，索引数据最终会被写入primary.idx文件进行保存。

索引数据的生成规则

因为是稀疏索引，因此MergeTree须要间隔index_granularity行数据才会生成一条索引记录，其索引值会依据声明的主键字段获取。图6-8所示是对照测试表hits_v1中的真实数据具象化后的效果。hits_v1使用年月分区（PARTITION BYtoYYYYMM(EventDate)），因此2014年3月份的数据最终会被划分到同一个分区目录内。若是使用CounterID做为主键（ORDER BY CounterID），则每间隔8192行数据就会取一次CounterID的值做为索引值，索引数据最终会被写入primary.idx文件进行保存。

例如第0(81920)行CounterID取值57，第8192(81921)行CounterID取值1635，而第16384(8192*2)行CounterID取值3266，最终索引数据将会是5716353266。

从图中也可以看出，MergeTree对于稀疏索引的存储是很是紧凑的，索引值先后相连，按照主键字段顺序紧密地排列在一块儿。不只此处，ClickHouse中不少数据结构都被设计得很是紧凑，好比其使用位读取替代专门的标志位或状态码，能够不浪费哪怕一个字节的空间。以小见大，这也是ClickHouse为什么性能如此出众的深层缘由之一。

若是使用多个主键，例如ORDER BY (CounterID, EventDate)，则每间隔8192行能够同时取CounterID与EventDate两列的值做为索引值，具体如图所示。

索引的查询过程

在介绍了上述关于索引的一些概念以后，接下来讲明索引具体是如何工做的。首先，咱们须要了解什么是MarkRange。MarkRange在ClickHouse中是用于定义标记区间的对象。经过先前的介绍已知，MergeTree按照index_granularity的间隔粒度，将一段完整的数据划分红了多个小的间隔数据段，一个具体的数据段便是一个MarkRange。MarkRange与索引编号对应，使用start和end两个属性表示其区间范围。经过与start及end对应的索引编号的取值，即可以获得它所对应的数值区间。而数值区间表示了此MarkRange包含的数据范围。

若是只是这么干巴巴地介绍，你们可能会以为比较抽象，下面用一份示例数据来进一步说明。假如如今有一份测试数据，共192行记录。其中，主键ID为String类型，ID的取值从A000开始，后面依次为A00一、A002……直至A192为止。MergeTree的索引粒度index_granularity = 3，根据索引的生成规则，primary.idx文件内的索引数据会如图所示。

根据索引数据，MergeTree会将此数据片断划分红192/3=64个小的MarkRange，两个相邻MarkRange相距的步长为1。其中，全部MarkRange（整个数据片断）的最大数值区间为[A000 , +inf)，其完整的示意如图所示。

在引出了数值区间的概念以后，对于索引的查询过程就很好解释了。索引查询其实就是两个数值区间的交集判断。其中，一个区间是由基于主键的查询条件转换而来的条件区间；而另外一个区间是刚才所讲述的与MarkRange对应的数值区间。整个索引查询过程能够大体分为3个步骤。

（1）生成查询条件区间：首先，将查询条件转换为条件区间。即使是单个值的查询条件，也会被转换成区间的形式，例以下面的例子。

（2）递归交集判断：以递归的形式，依次对MarkRange的数值区间与条件区间作交集判断。从最大的区间[A000 , +inf)开始：

❑ 若是不存在交集，则直接经过剪枝算法优化此整段MarkRange。

❑ 若是存在交集，且MarkRange步长大于8(end - start)，则将此区间进一步拆分红8个子区间（由merge_tree_coarse_index_granularity指定，默认值为8），并重复此规则，继续作递归交集判断。

❑ 若是存在交集，且MarkRange不可再分解（步长小于8），则记录MarkRange并返回。

（3）合并MarkRange区间：将最终匹配的MarkRange聚在一块儿，合并它们的范围。

MergeTree经过递归的形式持续向下拆分区间，最终将MarkRange定位到最细的粒度，以帮助在后续读取数据的时候，可以最小化扫描数据的范围。以图6-12所示为例，当查询条件WHERE ID = 'A003’的时候，最终只须要读取[A000 , A003]和[A003 , A006]两个区间的数据，它们对应MarkRange(start:0, end:2)范围，而其余无用的区间都被裁剪掉了。由于MarkRange转换的数值区间是闭区间，因此会额外匹配到临近的一个区间。

二级索引

除了一级索引以外，MergeTree一样支持二级索引。二级索引又称跳数索引，由数据的聚合信息构建而成。根据索引类型的不一样，其聚合信息的内容也不一样。跳数索引的目的与一级索引同样，也是帮助查询时减小数据扫描的范围。跳数索引在默认状况下是关闭的，须要设置allow_experimental_data_skipping_indices（该参数在新版本中已被取消）才能使用：

SET allow_experimental_data_skipping_indices=1;

跳数索引须要在CREATE语句内定义，它支持使用元组和表达式的形式声明，其完整的定义语法以下所示：

与一级索引同样，若是在建表语句中声明了跳数索引，则会额外生成相应的索引与标记文件（skp_idx_[Column].idx与skp_idx_[Column].mrk）。

granularity与index_granularity的关系

不一样的跳数索引之间，除了它们自身独有的参数以外，还都共同拥有granularity参数。初次接触时，很容易将granularity与index_granularity的概念弄混淆。对于跳数索引而言，index_granularity定义了数据的粒度，而granularity定义了聚合信息汇总的粒度。换言之，granularity定义了一行跳数索引可以跳过多少个index_granularity区间的数据。

要解释清楚granularity的做用，就要从跳数索引的数据生成规则提及，其规则大体是这样的：首先，按照index_granularity粒度间隔将数据划分红n段，总共有[0 ,n-1]个区间（n = total_rows / index_granularity，向上取整）。接着，根据索引定义时声明的表达式，从0区间开始，依次按index_granularity粒度从数据中获取聚合信息，每次向前移动1步(n+1)，聚合信息逐步累加。最后，当移动granularity次区间时，则汇总并生成一行跳数索引数据。

以minmax索引为例，它的聚合信息是在一个index_granularity区间内数据的最小和最大极值。如下图为例，假设index_granularity=8192且granularity=3，则数据会按照index_granularity划分为n等份，MergeTree从第0段分区开始，依次获取聚合信息。当获取到第3个分区时（granularity=3），则汇总并会生成第一行minmax索引（前3段minmax极值汇总后取值为[1 , 9]），如图所示。

跳数索引的类型

目前，MergeTree共支持4种跳数索引，分别是minmax、set、ngrambf_v1和tokenbf_v1。一张数据表支持同时声明多个跳数索引，例如：

CREATE TABLE skip_test (
    ID String,
    URL String,
    Code String,
    EventTime Date,
    INDEX a ID TYPE minmax GRANULARITY 5,
    INDEX b (length(ID) * 8) TYPE set(2) GRANULARITY 5,
    INDEX c (ID,Code) TYPE ngrambf_v1(3,256,2,0) GRANULARITY 5,
    INDEX d ID TYPE tokenbf_v1(256,2,0) GRANULARITY 5
) ENGINE = MergeTree()
ORDER BY ID ;

接下来，就借助上面的例子逐个介绍这几种跳数索引的用法：

（1）minmax:minmax索引记录了一段数据内的最小和最大极值，其索引的做用相似分区目录的minmax索引，可以快速跳过无用的数据区间，示例以下所示：
INDEX a ID TYPE minmax GRANULARITY 5
上述示例中minmax索引会记录这段数据区间内ID字段的极值。极值的计算涉及每5个index_granularity区间中的数据。

（2）set:set索引直接记录了声明字段或表达式的取值（惟一值，无重复），其完整形式为set(max_rows)，其中max_rows是一个阈值，表示在一个index_granularity内，索引最多记录的数据行数。若是max_rows=0，则表示无限制，例如：
INDEX b (length(ID) * 8) TYPE set(2) GRANULARITY 5
上述示例中set索引会记录数据中ID的长度 * 8后的取值。其中，每一个index_granularity内最多记录100条。

（3）ngrambf_v1:ngrambf_v1索引记录的是数据短语的布隆表过滤器，只支持String和FixedString数据类型。ngrambf_v1只可以提高in、notIn、like、equals和notEquals查询的性能，其完整形式为ngrambf_v1(n,size_of_bloom_filter_in_bytes, number_of_hash_functions, random_seed)。这些参数是一个布隆过滤器的标准输入，若是你接触过布隆过滤器，应该会对此十分熟悉。它们具体的含义以下：
❑ n:token长度，依据n的长度将数据切割为token短语。
❑ size_of_bloom_filter_in_bytes：布隆过滤器的大小。
❑ number_of_hash_functions：布隆过滤器中使用Hash函数的个数。❑ random_seed: Hash函数的随机种子。

例如在下面的例子中，ngrambf_v1索引会依照3的粒度将数据切割成短语token，token会通过2个Hash函数映射后再被写入，布隆过滤器大小为256字节。
INDEX c (ID,Code) TYPE ngrambf_v1(3,256,2,0) GRANULARITY 5,
（4）tokenbf_v1:tokenbf_v1索引是ngrambf_v1的变种，一样也是一种布隆过滤器索引。tokenbf_v1除了短语token的处理方法外，其余与ngrambf_v1是彻底同样的。tokenbf_v1会自动按照非字符的、数字的字符串分割token，具体用法以下所示：
INDEX d ID TYPE tokenbf_v1(256,2,0) GRANULARITY 5

数据存储

此前已经屡次提过，在MergeTree中数据是按列存储的。可是前面的介绍都较为抽象，具体到存储的细节、MergeTree是如何工做的，读者心中不免会有疑问。数据存储，就比如一本书中的文字，在排版时，毫不会密密麻麻地把文字堆满，这样会致使难以阅读。更为优雅的作法是，将文字按段落的形式精心组织，使其错落有致。本节将进一步介绍MergeTree在数据存储方面的细节，尤为是其中关于压缩数据块的概念。

各列独立存储

在MergeTree中，数据按列存储。而具体到每一个列字段，数据也是独立存储的，每一个列字段都拥有一个与之对应的．bin数据文件。也正是这些．bin文件，最终承载着数据的物理存储。数据文件以分区目录的形式被组织存放，因此在．bin文件中只会保存当前分区片断内的这一部分数据。按列独立存储的设计优点显而易见：一是能够更好地进行数据压缩（相同类型的数据放在一块儿，对压缩更加友好），二是可以最小化数据扫描的范围。

而对应到存储的具体实现方面，MergeTree也并非一股脑地将数据直接写入．bin文件，而是通过了一番精心设计：首先，数据是通过压缩的，目前支持LZ四、ZSTD、Multiple和Delta几种算法，默认使用LZ4算法；其次，数据会事先依照ORDER BY的声明排序；最后，数据是以压缩数据块的形式被组织并写入.bin文件中的。压缩数据块就比如一本书的文字段落，是组织文字的基本单元。这个概念十分重要，值得多花些篇幅进一步展开说明。

压缩数据块

一个压缩数据块由头信息和压缩数据两部分组成。头信息固定使用9位字节表示，具体由1个UInt8（1字节）整型和2个UInt32（4字节）整型组成，分别表明使用的压缩算法类型、压缩后的数据大小和压缩前的数据大小。

从图所示中可以看到，.bin压缩文件是由多个压缩数据块组成的，而每一个压缩数据块的头信息则是基于CompressionMethod_CompressedSize_UncompressedSize公式生成的。经过ClickHouse提供的clickhouse-compressor工具，可以查询某个．bin文件中压缩数据的统计信息。以测试数据集hits_v1为例，执行下面的命令：

执行后，会看到以下信息：

其中每一行数据表明着一个压缩数据块的头信息，其分别表示该压缩块中未压缩数据大小和压缩后数据大小（打印信息与物理存储的顺序恰好相反）。每一个压缩数据块的体积，按照其压缩前的数据字节大小，都被严格控制在64KB～1MB，其上下限分别由min_compress_block_size（默认65536）与max_compress_block_size（默认1048576）参数指定。而一个压缩数据块最终的大小，则和一个间隔（index_granularity）内数据的实际大小相关（是的，没错，又见到索引粒度这个老朋友了）。

MergeTree在数据具体的写入过程当中，会依照索引粒度（默认状况下，每次取8192行），按批次获取数据并进行处理。若是把一批数据的未压缩大小设为size，则整个写入过程遵循如下规则：

（1）单个批次数据 size < 64KB：若是单个批次数据小于64KB，则继续获取下一批数据，直至累积到size >= 64KB时，生成下一个压缩数据块。

（2）单个批次数据 64KB<= size <=1MB：若是单个批次数据大小刚好在64KB与1MB之间，则直接生成下一个压缩数据块。

（3）单个批次数据 size > 1MB：若是单个批次数据直接超过1MB，则首先按照1MB大小截断并生成下一个压缩数据块。剩余数据继续依照上述规则执行。此时，会出现一个批次数据生成多个压缩数据块的状况。
整个过程逻辑如图所示。

通过上述的介绍后咱们知道，一个．bin文件是由1至多个压缩数据块组成的，每一个压缩块大小在64KB～1MB之间。多个压缩数据块之间，按照写入顺序首尾相接，紧密地排列在一块儿。

在．bin文件中引入压缩数据块的目的至少有如下两个：

其一，虽然数据被压缩后可以有效减小数据大小，下降存储空间并加速数据传输效率，但数据的压缩和解压动做，其自己也会带来额外的性能损耗。因此须要控制被压缩数据的大小，以求在性能损耗和压缩率之间寻求一种平衡。

其二，在具体读取某一列数据时（.bin文件），首先须要将压缩数据加载到内存并解压，这样才能进行后续的数据处理。经过压缩数据块，能够在不读取整个.bin文件的状况下将读取粒度下降到压缩数据块级别，从而进一步缩小数据读取的范围。

数据标记

若是把MergeTree比做一本书，primary.idx一级索引比如这本书的一级章节目录，.bin文件中的数据比如这本书中的文字，那么数据标记(.mrk)会为一级章节目录和具体的文字之间创建关联。对于数据标记而言，它记录了两点重要信息：

其一，是一级章节对应的页码信息；

其二，是一段文字在某一页中的起始位置信息。这样一来，经过数据标记就可以很快地从一本书中当即翻到关注内容所在的那一页，并知道从第几行开始阅读。

数据标记的生成规则

数据标记做为衔接一级索引和数据的桥梁，其像极了作过标记小抄的书签，并且书本中每一个一级章节都拥有各自的书签。它们之间的关系如图所示。

从图中一眼就能发现数据标记的首个特征，即数据标记和索引区间是对齐的，均按照index_granularity的粒度间隔。如此一来，只需简单经过索引区间的下标编号就能够直接找到对应的数据标记。

为了可以与数据衔接，数据标记文件也与．bin文件一一对应。即每个列字段[Column].bin文件都有一个与之对应的[Column].mrk数据标记文件，用于记录数据在．bin文件中的偏移量信息。

一行标记数据使用一个元组表示，元组内包含两个整型数值的偏移量信息。它们分别表示在此段数据区间内，在对应的．bin压缩文件中，压缩数据块的起始偏移量；以及将该数据压缩块解压后，其未压缩数据的起始偏移量。图所示是．mrk文件内标记数据的示意。

每一行标记数据都表示了一个片断的数据（默认8192行）在．bin压缩文件中的读取位置信息。标记数据与一级索引数据不一样，它并不能常驻内存，而是使用LRU（最近最少使用）缓存策略加快其取用速度。

数据标记的工做方式

MergeTree在读取数据时，必须经过标记数据的位置信息才可以找到所须要的数据。整个查找过程大体能够分为读取压缩数据块和读取数据两个步骤。为了便于解释，这里继续使用测试表hits_v1中的真实数据进行说明。图所示为hits_v1测试表的JavaEnable字段及其标记数据与压缩数据的对应关系。

首先，对图所示左侧的标记数据作一番解释说明。JavaEnable字段的数据类型为UInt8，因此每行数值占用1字节。而hits_v1数据表的index_granularity粒度为8192，因此一个索引片断的数据大小刚好是8192B。按照6.5.2节介绍的压缩数据块的生成规则，若是单个批次数据小于64KB，则继续获取下一批数据，直至累积到size>=64KB时，生成下一个压缩数据块。所以在JavaEnable的标记文件中，每8行标记数据对应1个压缩数据块（1B * 8192 = 8192B, 64KB = 65536B,65536 / 8192 = 8）。因此，从图6-19所示中可以看到，其左侧的标记数据中，8行数据的压缩文件偏移量都是相同的，由于这8行标记都指向了同一个压缩数据块。而在这8行的标记数据中，它们的解压缩数据块中的偏移量，则依次按照8192B（每行数据1B，每个批次8192行数据）累加，当累加达到65536(64KB)时则置0。由于根据规则，此时会生成下一个压缩数据块。

理解了上述标记数据以后，接下来就开始介绍MergeTree具体是如何定位压缩数据块并读取数据的。

（1）读取压缩数据块：在查询某一列数据时，MergeTree无须一次性加载整个．bin文件，而是能够根据须要，只加载特定的压缩数据块。而这项特性须要借助标记文件中所保存的压缩文件中的偏移量。

在图所示的标记数据中，上下相邻的两个压缩文件中的起始偏移量，构成了与获取当前标记对应的压缩数据块的偏移量区间。由当前标记数据开始，向下寻找，直到找到不一样的压缩文件偏移量为止。此时获得的一组偏移量区间便是压缩数据块在．bin文件中的偏移量。例如在图所示中，读取右侧．bin文件中[0,12016]字节数据，就能获取第0个压缩数据块。

细心的读者可能会发现，在．mrk文件中，第0个压缩数据块的截止偏移量是12016。而在．bin数据文件中，第0个压缩数据块的压缩大小是12000。为何两个数值不一样呢？其实缘由很简单，12000只是数据压缩后的字节数，并无包含头信息部分。而一个完整的压缩数据块是由头信息加上压缩数据组成的，它的头信息固定由9个字节组成，压缩后大小为8个字节。因此，12016 = 8 + 12000 + 8，其定位方法如图右上角所示。压缩数据块被整个加载到内存以后，会进行解压，在这以后就进入具体数据的读取环节了。

（2）读取数据：在读取解压后的数据时，MergeTree并不须要一次性扫描整段解压数据，它能够根据须要，以index_granularity的粒度加载特定的一小段。为了实现这项特性，须要借助标记文件中保存的解压数据块中的偏移量。

一样的，在图所示的标记数据中，上下相邻两个解压缩数据块中的起始偏移量，构成了与获取当前标记对应的数据的偏移量区间。经过这个区间，可以在它的压缩块被解压以后，依照偏移量按需读取数据。例如在图所示中，经过[0,8192]可以读取压缩数据块0中的第一个数据片断。

对于分区、索引、标记和压缩数据的协同总结

分区、索引、标记和压缩数据，就比如是MergeTree给出的一套组合拳，使用恰当时威力无穷。那么，在依次介绍了各自的特色以后，如今将它们聚在一块进行一番总结。接下来，就分别从写入过程、查询过程，以及数据标记与压缩数据块的三种对应关系的角度展开介绍。

写入过程

数据写入的第一步是生成分区目录，伴随着每一批数据的写入，都会生成一个新的分区目录。在后续的某一时刻，属于相同分区的目录会依照规则合并到一块儿；接着，按照index_granularity索引粒度，会分别生成primary.idx一级索引（若是声明了二级索引，还会建立二级索引文件）、每个列字段的．mrk数据标记和．bin压缩数据文件。图所示是一张MergeTree表在写入数据时，它的分区目录、索引、标记和压缩数据的生成过程。

从分区目录201403_1_34_3可以得知，该分区数据共分34批写入，期间发生过3次合并。在数据写入的过程当中，依据index_granularity的粒度，依次为每一个区间的数据生成索引、标记和压缩数据块。其中，索引和标记区间是对齐的，而标记与压缩块则根据区间数据大小的不一样，会生成多对1、一对一和一对多三种关系。

查询过程

数据查询的本质，能够看做一个不断减少数据范围的过程。在最理想的状况下，MergeTree首先能够依次借助分区索引、一级索引和二级索引，将数据扫描范围缩至最小。而后再借助数据标记，将须要解压与计算的数据范围缩至最小。以图所示为例，它示意了在最优的状况下，通过层层过滤，最终获取最小范围数据的过程。

若是一条查询语句没有指定任何WHERE条件，或是指定了WHERE条件，但条件没有匹配到任何索引（分区索引、一级索引和二级索引），那么MergeTree就不能预先减少数据范围。在后续进行数据查询时，它会扫描全部分区目录，以及目录内索引段的最大区间。虽然不能减小数据范围，可是MergeTree仍然可以借助数据标记，以多线程的形式同时读取多个压缩数据块，以提高性能。

数据标记与压缩数据块的对应关系

因为压缩数据块的划分，与一个间隔（index_granularity）内的数据大小相关，每一个压缩数据块的体积都被严格控制在64KB～1MB。而一个间隔（index_granularity）的数据，又只会产生一行数据标记。那么根据一个间隔内数据的实际字节大小，数据标记和压缩数据块之间会产生三种不一样的对应关系。接下来使用具体示例作进一步说明，对于示例数据，仍然是测试表hits_v1，其中index_granularity粒度为8192，数据总量为8873898行。

多对一

多个数据标记对应一个压缩数据块，当一个间隔（index_granularity）内的数据未压缩大小size小于64KB时，会出现这种对应关系。以hits_v1测试表的JavaEnable字段为例。JavaEnable数据类型为UInt8，大小为1B，则一个间隔内数据大小为8192B。因此在此种情形下，每8个数据标记会对应同一个压缩数据块，如图所示。

一对一

一个数据标记对应一个压缩数据块，当一个间隔（index_granularity）内的数据未压缩大小size大于等于64KB且小于等于1MB时，会出现这种对应关系。以hits_v1测试表的URLHash字段为例。URLHash数据类型为UInt64，大小为8B，则一个间隔内数据大小为65536B，刚好等于64KB。因此在此种情形下，数据标记与压缩数据块是一对一的关系，如图所示。

一对多

一个数据标记对应多个压缩数据块，当一个间隔（index_granularity）内的数据未压缩大小size直接大于1MB时，会出现这种对应关系。以hits_v1测试表的URL字段为例。URL数据类型为String，大小根据实际内容而定。如图所示，编号45的标记对应了2个压缩数据块。