You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@iotdb.apache.org by GitBox <gi...@apache.org> on 2022/11/16 11:04:24 UTC
[GitHub] [iotdb] qiaojialin commented on a diff in pull request #7978: [doc] Adjust the data file section of the Quick Start chapter and rearrange the file classification
qiaojialin commented on code in PR #7978:
URL: https://github.com/apache/iotdb/pull/7978#discussion_r1023847019
##########
docs/zh/UserGuide/QuickStart/Files.md:
##########
@@ -19,27 +19,91 @@
-->
-## 数据文件存储
+# 数据文件存储
本节将介绍 IoTDB 的数据存储方式，便于您对 IoTDB 的数据管理有一个直观的了解。
IoTDB 需要存储的数据分为三类，分别为数据文件、系统文件以及写前日志文件。
-### 数据文件
+## 数据文件
+> 在 basedir/data/目录下
数据文件存储了用户写入 IoTDB 系统的所有数据。包含 TsFile 文件和其他文件，可通过 [data_dirs 配置项](../Reference/DataNode-Config-Manual.md) 进行配置。
为了更好的支持用户对于磁盘空间扩展等存储需求，IoTDB 为 TsFile 的存储配置增加了多文件目录的存储方式，用户可自主配置多个存储路径作为数据的持久化位置（详情见 [data_dirs 配置项](../Reference/DataNode-Config-Manual.md)），并可以指定或自定义目录选择策略（详情见 [multi_dir_strategy 配置项](../Reference/DataNode-Config-Manual.md)）。
-### 系统文件
+### TsFile
+> 在 basedir/data/sequence or unsequence/{StorageGroupName}/{TimePartitionId}/目录下
+1. {time}-{version}-{mergeCnt}.tsfile
Review Comment:
```suggestion
1. {time}-{version}-{inner_compaction_count}-{cross_compaction_count}.tsfile
```
##########
docs/zh/UserGuide/QuickStart/Files.md:
##########
@@ -19,27 +19,91 @@
-->
-## 数据文件存储
+# 数据文件存储
本节将介绍 IoTDB 的数据存储方式，便于您对 IoTDB 的数据管理有一个直观的了解。
IoTDB 需要存储的数据分为三类，分别为数据文件、系统文件以及写前日志文件。
-### 数据文件
+## 数据文件
+> 在 basedir/data/目录下
数据文件存储了用户写入 IoTDB 系统的所有数据。包含 TsFile 文件和其他文件，可通过 [data_dirs 配置项](../Reference/DataNode-Config-Manual.md) 进行配置。
为了更好的支持用户对于磁盘空间扩展等存储需求，IoTDB 为 TsFile 的存储配置增加了多文件目录的存储方式，用户可自主配置多个存储路径作为数据的持久化位置（详情见 [data_dirs 配置项](../Reference/DataNode-Config-Manual.md)），并可以指定或自定义目录选择策略（详情见 [multi_dir_strategy 配置项](../Reference/DataNode-Config-Manual.md)）。
-### 系统文件
+### TsFile
+> 在 basedir/data/sequence or unsequence/{StorageGroupName}/{TimePartitionId}/目录下
+1. {time}-{version}-{mergeCnt}.tsfile
+ + 数据文件
+2. {TsFileName}.tsfile.mod
+ + 更新文件，主要记录删除操作
+
+### TsFileResource
+1. {TsFileName}.tsfile.resource
+ + TsFile 的概要与索引文件
+2. {TsFileName}.tsfile.resource.temp
+ + 临时文件，用于避免更新 tsfile.resource 时损坏 tsfile.resource
+3. {TsFileName}.tsfile.resource.closing
Review Comment:
no more this file
##########
docs/UserGuide/QuickStart/Files.md:
##########
@@ -19,27 +19,98 @@
-->
-## Files
+# Files
In IoTDB, there are many kinds of data needed to be stored. This section introduces IoTDB's data storage strategy to provide you an explicit understanding of IoTDB's data management.
The data in IoTDB is divided into three categories, namely data files, system files, and pre-write log files.
-### Data Files
+## Data Files
+> under directory basedir/data/
Data files store all the data that the user wrote to IoTDB, which contains TsFile and other files. TsFile storage directory can be configured with the `data_dirs` configuration item (see [file layer](../Reference/DataNode-Config-Manual.md) for details). Other files can be configured through [data_dirs](../Reference/DataNode-Config-Manual.md) configuration item (see [Engine Layer](../Reference/DataNode-Config-Manual.md) for details).
In order to support users' storage requirements such as disk space expansion better, IoTDB supports multiple file directories storage methods for TsFile storage configuration. Users can set multiple storage paths as data storage locations( see [data_dirs](../Reference/DataNode-Config-Manual.md) configuration item), and you can specify or customize the directory selection strategy (see [multi_dir_strategy](../Reference/DataNode-Config-Manual.md) configuration item for details).
-### System files
+### TsFile
+> under directory data/sequence or unsequence/{StorageGroupName}/{TimePartitionId}/
+
+1. {time}-{version}-{mergeCnt}.tsfile
+ + normal data file
+2. {TsFileName}.tsfile.mod
+ + modification file
+ + record delete operation
+
+### TsFileResource
+1. {TsFileName}.tsfile.resource
+ + descriptor and statistic file of a TsFile
+2. {TsFileName}.tsfile.resource.temp
+ + temp file
+ + avoid damaging the tsfile.resource when updating it
+3. {TsFileName}.tsfile.resource.closing
Review Comment:
no more this file
##########
docs/UserGuide/QuickStart/Files.md:
##########
@@ -19,27 +19,98 @@
-->
-## Files
+# Files
In IoTDB, there are many kinds of data needed to be stored. This section introduces IoTDB's data storage strategy to provide you an explicit understanding of IoTDB's data management.
The data in IoTDB is divided into three categories, namely data files, system files, and pre-write log files.
-### Data Files
+## Data Files
+> under directory basedir/data/
Data files store all the data that the user wrote to IoTDB, which contains TsFile and other files. TsFile storage directory can be configured with the `data_dirs` configuration item (see [file layer](../Reference/DataNode-Config-Manual.md) for details). Other files can be configured through [data_dirs](../Reference/DataNode-Config-Manual.md) configuration item (see [Engine Layer](../Reference/DataNode-Config-Manual.md) for details).
In order to support users' storage requirements such as disk space expansion better, IoTDB supports multiple file directories storage methods for TsFile storage configuration. Users can set multiple storage paths as data storage locations( see [data_dirs](../Reference/DataNode-Config-Manual.md) configuration item), and you can specify or customize the directory selection strategy (see [multi_dir_strategy](../Reference/DataNode-Config-Manual.md) configuration item for details).
-### System files
+### TsFile
+> under directory data/sequence or unsequence/{StorageGroupName}/{TimePartitionId}/
+
+1. {time}-{version}-{mergeCnt}.tsfile
Review Comment:
```suggestion
1. {time}-{version}-{inner_compaction_count}-{cross_compaction_count}.tsfile
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: reviews-unsubscribe@iotdb.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org