You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: storage-engine/titan-configuration.md
+11Lines changed: 11 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -118,7 +118,15 @@ To disable Titan, you can configure the `rocksdb.defaultcf.titan.blob-run-mode`
118
118
- When the option is set to `read-only`, all newly written values are written into RocksDB, regardless of the value size.
119
119
- When the option is set to `fallback`, all newly written values are written into RocksDB, regardless of the value size. Also, all compacted values stored in the Titan blob file are automatically moved back to RocksDB.
120
120
121
+
<<<<<<< HEAD
121
122
To disable Titan, perform the following steps:
123
+
=======
124
+
To disable Titan for all existing and future data, you can take the following steps. Note that you can skip Step 2 because it greatly affects online traffic performance. In fact even without Step 2, the data compaction consumes extra I/O and CPU resources when it moves data from Titan to RocksDB, and performance will degrade (sometimes as much as 50%) when TiKV I/O or CPU resources are limited.
125
+
126
+
>**Warning:**
127
+
>
128
+
> When disabling Titan for TiDB versions earlier than v8.5.0, it is not recommended to modify the TiKV configuration item [`rocksdb.titan.enabled`](/tikv-configuration-file.md#enabled) to `false`, as this might cause TiKV to crash. Following Step 1 is sufficient to disable Titan.
129
+
>>>>>>> 445dea0c18 (titan-configuration: remove the unrecommended steps of updating TiKV configuration (#21217))
122
130
123
131
1. Update the configuration file of the TiKV nodes you wish to disable Titan for and restart TiKV:
124
132
@@ -137,6 +145,7 @@ To disable Titan, perform the following steps:
137
145
138
146
3. After the compaction is finished, waituntil the **Blob file count** metrics under **TiKV-Details/Titan - kv** decrease to `0`.
139
147
148
+
<<<<<<< HEAD
140
149
4. Update the configuration of these TiKV nodes to disable Titan.
141
150
142
151
```toml
@@ -148,6 +157,8 @@ To disable Titan, perform the following steps:
148
157
>
149
158
> Disabling Titan is an experimental feature. It is **NOT** recommended to use it if not necessary.
150
159
160
+
=======
161
+
>>>>>>> 445dea0c18 (titan-configuration: remove the unrecommended steps of updating TiKV configuration (#21217))
151
162
## Level Merge (experimental)
152
163
153
164
In TiKV 4.0, [Level Merge](/storage-engine/titan-overview.md#level-merge), a new algorithm, is introduced to improve the performance of range query and to reduce the impact of Titan GC on the foreground write operations. You can enable Level Merge using the following option:
Copy file name to clipboardExpand all lines: tikv-configuration-file.md
+15Lines changed: 15 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -1156,8 +1156,23 @@ Configuration items related to Titan.
1156
1156
1157
1157
### `enabled`
1158
1158
1159
+
<<<<<<< HEAD
1159
1160
+ Enables or disables Titan
1160
1161
+ Default value: `false`
1162
+
=======
1163
+
> **Warning**
1164
+
>
1165
+
> When disabling Titan for TiDB versions earlier than v8.5.0, it is not recommended to modify this configuration item to `false`, as this might cause TiKV to crash. To disable Titan, refer to the steps in [Disable Titan](/storage-engine/titan-configuration.md#disable-titan).
1166
+
1167
+
> **Note:**
1168
+
>
1169
+
> - To enhance the performance of wide table and JSON data writing and point query, starting from TiDB v7.6.0, the default value changes from `false` to `true`, which means that Titan is enabled by default.
1170
+
> - Existing clusters upgraded to v7.6.0 or later versions retain the original configuration, which means that if Titan is not explicitly enabled, it still uses RocksDB.
1171
+
> - If the cluster has enabled Titan before upgrading to TiDB v7.6.0 or later versions, Titan will be retained after the upgrade, and the [`min-blob-size`](/tikv-configuration-file.md#min-blob-size) configuration before the upgrade will be retained. If you do not explicitly configure the value before the upgrade, the default value of the previous version `1KiB` will be retained to ensure the stability of the cluster configuration after the upgrade.
1172
+
1173
+
+ Enables or disables Titan.
1174
+
+ Default value: `true`
1175
+
>>>>>>> 445dea0c18 (titan-configuration: remove the unrecommended steps of updating TiKV configuration (#21217))
0 commit comments