DolphinDB分区数据库教程（一）

What this page covers

• 数据库分区的目的与收益
• 分区类型与 _database_ 函数参数说明
• 范围分区示例
• 哈希分区示例
• 值分区示例
• 列表分区示例
• 组合分区示例

技能认证特训营第二期正式开启（限时报名） cta

页面顶部的活动报名与优惠信息入口。

• 页面提供技能认证特训营第二期的报名入口链接。

DolphinDB分区数据库教程（一） hero

教程文章标题与作者、日期信息。

• 文章标题为“DolphinDB分区数据库教程（一）”。
• 作者署名为 Junxi。
• 发布日期为 2021-08-05。

为什么对数据进行分区？ definition

解释数据库分区的目的与带来的性能、资源利用与可用性收益。

• 数据库分区可极大降低系统响应延迟并提高数据吞吐量。
• 分区可使大型表更易于管理。
• 分区可提高对数据子集的维护操作效率。
• 分区可通过减少扫描数据量来降低读取量。
• 单一分区存放全部数据会受磁盘访问 IO 瓶颈限制。

分区方式与_database函数创建数据库 how_it_works

列出DolphinDB支持的分区类型，并说明_database函数语法与参数含义及限制。

• DolphinDB支持 RANGE、HASH、VALUE、LIST、COMPO 分区方式。
• DolphinDB 的 database 函数用于创建数据库。
• 函数语法为 database(directory, [partitionType], [partitionScheme], [locations])。
• directory 参数表示数据库保存的目录。
• 分布式文件系统数据库或 COMPO 数据库不能使用 locations 参数。

范围分区（2.1）示例 how_it_works

说明范围分区由分区向量决定，并给出创建范围分区数据库与分区表的示例及物理目录结构说明。

• 范围分区的分区向量表示区间，包含起始值，不包含结尾值。
• 示例数据库包含两个分区：[0,5) 和 [5,10)。
• 示例创建调用为 db=database("dfs://rangedb", RANGE, 0 5 10)。
• 示例分区表创建使用 ID 作为分区列：db.createPartitionedTable(t, `pt, `ID)。
• 示例中数据生成规模为 n=1000000。

哈希分区（2.2）示例 how_it_works

说明哈希分区的机制、局限与示例，并给出物理目录结构说明。

• 哈希分区对分区列使用哈希函数以产生分区。
• 哈希分区是产生指定数量分区的简便方法。
• 哈希分区不能保证分区大小一致。
• 分区列值分布偏态时更难保证分区大小一致。
• 示例创建调用为 db=database("dfs://hashdb", HASH, [INT, 2])。

值分区（2.3）示例 how_it_works

说明值分区“一个值一个分区”的概念，并给出按月值分区的示例及目录结构说明。

• 值分区用一个值代表一个分区。
• 示例定义了 204 个分区。
• 示例每个分区表示 2000年1月到2016年12月之间的一个月。
• 示例创建调用为 db=database("dfs://valuedb", VALUE, 2000.01M..2016.12M)。

列表分区（2.4）示例 how_it_works

说明列表分区用列表代表分区的方式，并给出股票代码列表分区示例及目录结构说明。

• 列表分区用一个包含多个元素的列表代表一个分区。
• 示例包含两个分区，且每个分区由不同股票代码构成。
• 示例第一个分区包含3个股票代码。
• 示例第二个分区包含2个股票代码。
• 示例创建调用为 db=database("dfs://listdb", LIST, [`IBM`ORCL`MSFT, `GOOG`FB])。

组合分区（2.5）示例 how_it_works

说明组合分区可定义多分区列并独立采用不同分区方式，给出示例并展示两级目录结构说明。

• 组合分区可以定义2或3个分区列。
• 每列可独立采用 RANGE、VALUE 或 LIST 分区。
• 多个分区列在逻辑上并列，不存在从属关系或优先级关系。
• 示例子库定义包含一个 VALUE 子库与一个 RANGE 子库。
• 示例组合数据库创建调用为 db = database("dfs://compoDB", COMPO, [dbDate, dbID])。
• 示例分区表创建使用分区列 date 与 ID。
• 示例创建了 5 个值分区。
• 在特定日期分区 20170807 下有 2 个范围分区。

后续教程预告：教程（二） misc

说明后续文章将介绍分区原则与特殊分区方案。

• 教程（二）将介绍 DolphinDB 分区原则以及特殊的分区方案。

Facts index