| import{_ as a,c as s,b as n,o as i}from"./app-C1IcKGP3.js";const t={};function r(o,e){return i(),s("div",null,[...e[0]||(e[0]=[n(`<h1 id="配置项修改介绍" tabindex="-1"><a class="header-anchor" href="#配置项修改介绍"><span>配置项修改介绍</span></a></h1><h2 id="设置方式" tabindex="-1"><a class="header-anchor" href="#设置方式"><span>设置方式</span></a></h2><ul><li>使用sql语句修改【推荐】</li><li>直接修改配置文件【不推荐】</li></ul><h2 id="生效方式" tabindex="-1"><a class="header-anchor" href="#生效方式"><span>生效方式</span></a></h2><ul><li>第一次启动后不可修改 (first_start)</li><li>重启后生效 (restart)</li><li>热加载 (hot_reload)</li></ul><h1 id="直接修改配置文件" tabindex="-1"><a class="header-anchor" href="#直接修改配置文件"><span>直接修改配置文件</span></a></h1><p>可以通过重启或以下命令生效</p><h2 id="热加载配置命令" tabindex="-1"><a class="header-anchor" href="#热加载配置命令"><span>热加载配置命令</span></a></h2><p>使支持热加载的配置项改动立即生效。<br> 对于已经写在配置文件中修改过的配置项，从配置文件中删除或注释后再进行 load configuration 将恢复默认值。</p><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>load configuration</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><h1 id="配置项操作语句" tabindex="-1"><a class="header-anchor" href="#配置项操作语句"><span>配置项操作语句</span></a></h1><p>设置配置项</p><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>set configuration 'key1' = 'value1' 'key2' = 'value2'... (on nodeId)</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><h3 id="示例1" tabindex="-1"><a class="header-anchor" href="#示例1"><span>示例1</span></a></h3><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>set configuration 'enable_cross_space_compaction' = 'false'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>对集群所有节点永久生效，设置 enable_cross_space_compaction 为 false，并写入到 iotdb-system.properties 中。</p><h3 id="示例2" tabindex="-1"><a class="header-anchor" href="#示例2"><span>示例2</span></a></h3><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>set configuration 'enable_cross_space_compaction' ='false' 'enable_seq_space_compaction' = 'false' on 1</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>对 nodeId 为 1 的节点永久生效，设置 enable_cross_space_compaction 为 false，设置 enable_seq_space_compaction 为 false，并写入到 iotdb-system.properties 中。</p><h3 id="示例3" tabindex="-1"><a class="header-anchor" href="#示例3"><span>示例3</span></a></h3><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>set configuration 'enable_cross_space_compaction' = 'false' 'timestamp_precision' = 'ns'</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>对集群所有节点永久生效，设置 enable_cross_space_compaction 为 false，timestamp_precision 为 ns，并写入到 iotdb-system.properties 中。但是，timestamp_precision 是第一次启动后就无法修改的配置项，因此会忽略这个配置项的更新，返回如下。</p><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span>Msg: org.apache.iotdb.jdbc.IoTDBSQLException: 301: ignored config items: [timestamp_precision]</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><h1 id="生效配置项" tabindex="-1"><a class="header-anchor" href="#生效配置项"><span>生效配置项</span></a></h1><p>支持热加载立即生效的配置项在 iotdb-system.properties.template 文件中标记 effectiveMode 为 hot_reload<br> 示例</p><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code class="language-"><span class="line"><span># Used for indicate cluster name and distinguish different cluster.</span></span> |
| <span class="line"><span># If you need to modify the cluster name, it's recommended to use [set configuration 'cluster_name'='xxx'] sql.</span></span> |
| <span class="line"><span># Manually modifying configuration file is not recommended, which may cause node restart fail.</span></span> |
| <span class="line"><span># effectiveMode: hot_reload</span></span> |
| <span class="line"><span># Datatype: string</span></span> |
| <span class="line"><span>cluster_name=defaultCluster</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div>`,26)])])}const c=a(t,[["render",r]]),d=JSON.parse('{"path":"/zh/UserGuide/latest/Reference/Modify-Config-Manual.html","title":"配置项修改介绍","lang":"zh-CN","frontmatter":{"description":"配置项修改介绍 设置方式 使用sql语句修改【推荐】 直接修改配置文件【不推荐】 生效方式 第一次启动后不可修改 (first_start) 重启后生效 (restart) 热加载 (hot_reload) 直接修改配置文件 可以通过重启或以下命令生效 热加载配置命令 使支持热加载的配置项改动立即生效。 对于已经写在配置文件中修改过的配置项，从配置文件...","head":[["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"配置项修改介绍\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2026-01-12T10:25:39.000Z\\",\\"author\\":[]}"],["meta",{"property":"og:url","content":"https://iotdb.apache.org/zh/UserGuide/latest/Reference/Modify-Config-Manual.html"}],["meta",{"property":"og:site_name","content":"IoTDB Website"}],["meta",{"property":"og:title","content":"配置项修改介绍"}],["meta",{"property":"og:description","content":"配置项修改介绍 设置方式 使用sql语句修改【推荐】 直接修改配置文件【不推荐】 生效方式 第一次启动后不可修改 (first_start) 重启后生效 (restart) 热加载 (hot_reload) 直接修改配置文件 可以通过重启或以下命令生效 热加载配置命令 使支持热加载的配置项改动立即生效。 对于已经写在配置文件中修改过的配置项，从配置文件..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"zh-CN"}],["meta",{"property":"og:locale:alternate","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2026-01-12T10:25:39.000Z"}],["meta",{"property":"article:modified_time","content":"2026-01-12T10:25:39.000Z"}],["link",{"rel":"alternate","hreflang":"en-us","href":"https://iotdb.apache.org/UserGuide/latest/Reference/Modify-Config-Manual.html"}]]},"git":{"createdTime":1768213539000,"updatedTime":1768213539000,"contributors":[{"name":"CritasWang","username":"CritasWang","email":"critas@outlook.com","commits":1,"url":"https://github.com/CritasWang"}]},"readingTime":{"minutes":1.67,"words":502},"filePathRelative":"zh/UserGuide/latest/Reference/Modify-Config-Manual.md","autoDesc":true}');export{c as comp,d as data}; |
