| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| |
| --> |
| |
| ## 文件 |
| |
| 本节将介绍IoTDB的数据存储方式，便于您对IoTDB的数据管理有一个直观的了解。 |
| |
| IoTDB需要存储的数据分为三类，分别为数据文件、系统文件以及写前日志文件。 |
| |
| ### 数据文件 |
| |
| 数据文件存储了用户写入IoTDB系统的所有数据。包含TsFile文件和其他文件，可通过[data_dirs配置项](../Appendix/Config-Manual.md)进行配置。 |
| |
| 为了更好的支持用户对于磁盘空间扩展等存储需求，IoTDB为TsFile的存储配置增加了多文件目录的存储方式，用户可自主配置多个存储路径作为数据的持久化位置（详情见[data_dirs配置项](../Appendix/Config-Manual.md)），并可以指定或自定义目录选择策略（详情见[mult_dir_strategy配置项](../Appendix/Config-Manual.md)）。 |
| |
| ### 系统文件 |
| |
| 系统Schema文件，存储了数据文件的元数据信息。可通过base_dir配置项进行配置（详情见[base_dir配置项](../Appendix/Config-Manual.md)）。 |
| |
| ### 写前日志文件 |
| |
| 写前日志文件存储了系统的写前日志。可通过`wal_dir`配置项进行配置（详情见[wal_dir配置项](../Appendix/Config-Manual.md)）。 |
| |
| ### 数据存储目录设置举例 |
| |
| 接下来我们将举一个数据目录配置的例子，来具体说明如何配置数据的存储目录。 |
| |
| IoTDB涉及到的所有数据目录路径有：data_dirs, mult_dir_strategy, base_dir和wal_dir，它们分别涉及的是IoTDB的数据文件、系统文件以及写前日志文件。您可以选择输入路径自行配置，也可以不进行任何操作使用系统默认的配置项。 |
| |
| 以下我们给出一个用户对五个目录都进行自行配置的例子。 |
| |
| ``` |
| base_dir = $IOTDB_HOME/data |
| data_dirs = /data1/data, /data2/data, /data3/data |
| multi_dir_strategy=MaxDiskUsableSpaceFirstStrategy |
| wal_dir= $IOTDB_HOME/data/wal |
| ``` |
| 按照上述配置，系统会： |
| |
| * 将TsFile存储在路径/data1/data、路径/data2/data和路径data3/data3中。且对这三个路径的选择策略是：`优先选择磁盘剩余空间最大的目录`，即在每次数据持久化到磁盘时系统会自动选择磁盘剩余空间最大的一个目录将数据进行写入 |
| * 将系统文件存储在$IOTDB_HOME/data |
| * 将写前日志文件存储在$IOTDB_HOME/data/wal |
| |
