Apache Doris主键模型文档修正说明

Apache Doris主键模型文档修正说明

Apache Doris作为一款高性能的MPP分析型数据库，其主键模型(Primary Key Model)是用户常用的数据模型之一。近期社区发现官方文档中关于主键模型"写时合并"特性的描述存在两处需要修正的内容。

文档问题描述

在Apache Doris 3.0版本的文档中，关于创建写时合并表的部分存在以下问题：

1. 术语错误：将"写时合并"误写为"写实合并"
2. 默认行为描述错误：将"默认开启写时合并"误写为"默认开启读时合并"

技术背景解析

主键模型的两种合并方式

Apache Doris的主键模型支持两种数据合并方式：

1. 读时合并(Merge-On-Read)

   • 在查询时实时合并数据
   • 适用于写入频繁但查询较少的场景
   • 会产生较多的随机IO

2. 写时合并(Merge-On-Write)

   • 在写入时就完成数据合并
   • 查询性能更好
   • 减少查询时的计算开销
   • 自Doris 2.1版本起成为默认选项

参数说明

enable_unique_key_merge_on_write参数用于控制主键表使用哪种合并方式：

• 设置为true时启用写时合并
• 设置为false时启用读时合并

文档修正内容

修正后的文档应准确描述：

1. 通过显式开启enable_unique_key_merge_on_write属性可以指定写时合并模式
2. 自Doris 2.1版本以后，默认开启写时合并模式

对用户的影响

这一修正有助于用户更准确地理解Doris主键模型的行为特性，避免在实际使用中产生误解。特别是对于从旧版本升级的用户，了解默认行为的变化非常重要。

最佳实践建议

对于大多数分析型场景，建议使用默认的写时合并模式，因为它能提供更好的查询性能。只有在写入极其频繁且查询较少的特殊场景下，才考虑使用读时合并模式。