blob: 510508829cffc54009d686934c2223cd1e771f93 [file] [log] [blame]
import{_ as n,c as e,b as a,o as l}from"./app-C8175JBb.js";const o={};function t(p,s){return l(),e("div",null,s[0]||(s[0]=[a(`<h1 id="rest-api-v2" tabindex="-1"><a class="header-anchor" href="#rest-api-v2"><span>REST API V2</span></a></h1><p>IoTDB&#39;s RESTful services can be used for query, write, and management operations, using the OpenAPI standard to define interfaces and generate frameworks.</p><h2 id="_1-enable-restful-services" tabindex="-1"><a class="header-anchor" href="#_1-enable-restful-services"><span>1. Enable RESTful Services</span></a></h2><p>RESTful services are disabled by default.</p><p>Find the <code>conf/iotdb-system.properties</code> file under the IoTDB installation directory and set <code>enable_rest_service</code> to <code>true</code> to enable the module.</p><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">enable_rest_service</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">true</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><h2 id="_2-authentication" tabindex="-1"><a class="header-anchor" href="#_2-authentication"><span>2. Authentication</span></a></h2><p>Except the liveness probe API <code>/ping</code>, RESTful services use the basic authentication. Each URL request needs to carry <code>&#39;Authorization&#39;: &#39;Basic &#39; + base64.encode(username + &#39;:&#39; + password)</code>.</p><p>The username used in the following examples is: <code>root</code>, and password is: <code>root</code>.</p><p>And the authorization header is</p><div class="language- line-numbers-mode" data-highlighter="shiki" data-ext="" data-title="" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span>Authorization: Basic cm9vdDpyb290</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li><p>If a user authorized with incorrect username or password, the following error is returned:</p><p>HTTP Status Code:<code>401</code></p><p>HTTP response body:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">600</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;WRONG_LOGIN_PASSWORD_ERROR&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div></li><li><p>If the <code>Authorization</code> header is missingthe following error is returned:</p><p>HTTP Status Code:<code>401</code></p><p>HTTP response body:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">603</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;UNINITIALIZED_AUTH_ERROR&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div></li></ul><h2 id="_3-interface" tabindex="-1"><a class="header-anchor" href="#_3-interface"><span>3. Interface</span></a></h2><h3 id="_3-1-ping" tabindex="-1"><a class="header-anchor" href="#_3-1-ping"><span>3.1 ping</span></a></h3><p>The <code>/ping</code> API can be used for service liveness probing.</p><p>Request method: <code>GET</code></p><p>Request path: <code>http://ip:port/ping</code></p><p>The user name used in the example is: root, password: root</p><p>Example request:</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">$</span><span style="color:#98C379;"> curl</span><span style="color:#98C379;"> http://127.0.0.1:18080/ping</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>Response status codes:</p><ul><li><code>200</code>: The service is alive.</li><li><code>503</code>: The service cannot accept any requests now.</li></ul><p>Response parameters:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">code</td><td style="text-align:left;">integer</td><td style="text-align:left;">status code</td></tr><tr><td style="text-align:left;">message</td><td style="text-align:left;">string</td><td style="text-align:left;">message</td></tr></tbody></table><p>Sample response:</p><ul><li><p>With HTTP status code <code>200</code>:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">200</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;SUCCESS_STATUS&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div></li><li><p>With HTTP status code <code>503</code>:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">500</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;thrift service is unavailable&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div></li></ul><blockquote><p><code>/ping</code> can be accessed without authorization.</p></blockquote><h3 id="_3-2-query" tabindex="-1"><a class="header-anchor" href="#_3-2-query"><span>3.2 query</span></a></h3><p>The query interface can be used to handle data queries and metadata queries.</p><p>Request method: <code>POST</code></p><p>Request header: <code>application/json</code></p><p>Request path: <code>http://ip:port/rest/v2/query</code></p><p>Parameter Description:</p><table><thead><tr><th>parameter name</th><th>parameter type</th><th>required</th><th>parameter description</th></tr></thead><tbody><tr><td>sql</td><td>string</td><td>yes</td><td></td></tr><tr><td>row_limit</td><td>integer</td><td>no</td><td>The maximum number of rows in the result set that can be returned by a query. <br>If this parameter is not set, the <code>rest_query_default_row_size_limit</code> of the configuration file will be used as the default value. <br> When the number of rows in the returned result set exceeds the limit, the status code <code>411</code> will be returned.</td></tr></tbody></table><p>Response parameters:</p><table><thead><tr><th>parameter name</th><th>parameter type</th><th>parameter description</th></tr></thead><tbody><tr><td>expressions</td><td>array</td><td>Array of result set column names for data query, <code>null</code> for metadata query</td></tr><tr><td>column_names</td><td>array</td><td>Array of column names for metadata query result set, <code>null</code> for data query</td></tr><tr><td>timestamps</td><td>array</td><td>Timestamp column, <code>null</code> for metadata query</td></tr><tr><td>values</td><td>array</td><td>A two-dimensional array, the first dimension has the same length as the result set column name array, and the second dimension array represents a column of the result set</td></tr></tbody></table><p><strong>Examples:</strong></p><p>Tip: Statements like <code>select * from root.xx.**</code> are not recommended because those statements may cause OOM.</p><p><strong>Expression query</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select s3, s4, s3 + 1 from root.sg27 limit 2&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s3&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s4&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s3 + 1&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232143960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232153960</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 11</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> false</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> true</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 12.0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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 class="line-number"></div><div class="line-number"></div></div></div><p><strong>Show child paths</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show child paths root&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;child paths&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 class="line-number"></div></div></div><p><strong>Show child nodes</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show child nodes root&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;child nodes&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 class="line-number"></div></div></div><p><strong>Show all ttl</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show all ttl&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;database&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;ttl&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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><p><strong>Show ttl</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show ttl on root.sg27&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;database&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;ttl&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Show functions</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show functions&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;function name&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;function type&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;class name (UDF)&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;ABS&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;ACOS&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;ASIN&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#FFFFFF;"> ...</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;built-in UDTF&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;built-in UDTF&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;built-in UDTF&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#FFFFFF;"> ...</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;org.apache.iotdb.db.query.udf.builtin.UDTFAbs&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;org.apache.iotdb.db.query.udf.builtin.UDTFAcos&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;org.apache.iotdb.db.query.udf.builtin.UDTFAsin&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#FFFFFF;"> ...</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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 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><p><strong>Show timeseries</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show timeseries&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;timeseries&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;alias&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;database&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;dataType&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;encoding&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;compression&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;tags&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;attributes&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s3&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s4&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28.s3&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28.s4&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;INT32&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;BOOLEAN&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;INT32&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;BOOLEAN&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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 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 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 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 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 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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Show latest timeseries</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show latest timeseries&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;timeseries&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;alias&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;database&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;dataType&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;encoding&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;compression&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;tags&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;attributes&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28.s4&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s4&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28.s3&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s3&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;BOOLEAN&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;BOOLEAN&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;INT32&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;INT32&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;RLE&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;SNAPPY&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#56B6C2;"> null</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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 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 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 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 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 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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Count timeseries</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;count timeseries root.**&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 4</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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><p><strong>Count nodes</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;count nodes root.** level=2&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 4</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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><p><strong>Show devices</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show devices&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;devices&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;isAligned&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;false&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;false&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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><p><strong>Show devices with database</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;show devices with database&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;devices&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;database&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;isAligned&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg28&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;false&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;false&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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><p><strong>List user</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;list user&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;user&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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><p><strong>Aggregation</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select count(*) from root.sg27&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg27.s3)&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg27.s4)&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 1</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 2</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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><p><strong>Group by level</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select count(*) from root.** group by level = 1&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg27.*)&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg28.*)&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 3</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 3</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Group by</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select count(*) from root.sg27 group by([1635232143960,1635232153960),1s)&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg27.s3)&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;count(root.sg27.s4)&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232143960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232144960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232145960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232146960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232147960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232148960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232149960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232150960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232151960</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232152960</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 1</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#D19A66;"> 1</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#D19A66;"> 0</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 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 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 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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Last</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select last s3 from root.sg27&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;expressions&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">null</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;column_names&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;timeseries&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;value&quot;</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#98C379;"> &quot;dataType&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;timestamps&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#D19A66;"> 1635232143960</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;values&quot;</span><span style="color:#ABB2BF;">: [</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;root.sg27.s3&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;11&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ],</span></span>
<span class="line"><span style="color:#ABB2BF;"> [</span></span>
<span class="line"><span style="color:#98C379;"> &quot;INT32&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;"> ]</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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 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 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 class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Disable align</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select * from root.sg27 disable align&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">407</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;disable align clauses are not supported.&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><p><strong>Align by device</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select count(s3) from root.sg27 align by device&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">407</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;align by device clauses are not supported.&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><p><strong>Select into</strong></p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;select s3, s4 into root.sg29.s1, root.sg29.s2 from root.sg27&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/query</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">407</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;select into clauses are not supported.&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><h3 id="_3-3-nonquery" tabindex="-1"><a class="header-anchor" href="#_3-3-nonquery"><span>3.3 nonQuery</span></a></h3><p>Request method: <code>POST</code></p><p>Request header: <code>application/json</code></p><p>Request path: <code>http://ip:port/rest/v2/nonQuery</code></p><p>Parameter Description:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">sql</td><td style="text-align:left;">string</td><td style="text-align:left;">query content</td></tr></tbody></table><p>Example request:</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;sql&quot;:&quot;CREATE DATABASE root.ln&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/nonQuery</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>Response parameters:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">code</td><td style="text-align:left;">integer</td><td style="text-align:left;">status code</td></tr><tr><td style="text-align:left;">message</td><td style="text-align:left;">string</td><td style="text-align:left;">message</td></tr></tbody></table><p>Sample response:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">200</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;SUCCESS_STATUS&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><h3 id="_3-4-inserttablet" tabindex="-1"><a class="header-anchor" href="#_3-4-inserttablet"><span>3.4 insertTablet</span></a></h3><p>Request method: <code>POST</code></p><p>Request header: <code>application/json</code></p><p>Request path: <code>http://ip:port/rest/v2/insertTablet</code></p><p>Parameter Description:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">is required</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">timestamps</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">Time column</td></tr><tr><td style="text-align:left;">measurements</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">The name of the measuring point</td></tr><tr><td style="text-align:left;">data_types</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">The data type</td></tr><tr><td style="text-align:left;">values</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">Value columns, the values in each column can be <code>null</code></td></tr><tr><td style="text-align:left;">is_aligned</td><td style="text-align:left;">boolean</td><td style="text-align:left;">yes</td><td style="text-align:left;">Whether to align the timeseries</td></tr><tr><td style="text-align:left;">device</td><td style="text-align:left;">string</td><td style="text-align:left;">yes</td><td style="text-align:left;">Device name</td></tr></tbody></table><p>Example request:</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;timestamps&quot;:[1635232143960,1635232153960],&quot;measurements&quot;:[&quot;s3&quot;,&quot;s4&quot;],&quot;data_types&quot;:[&quot;INT32&quot;,&quot;BOOLEAN&quot;],&quot;values&quot;:[[11,null],[false,true]],&quot;is_aligned&quot;:false,&quot;device&quot;:&quot;root.sg27&quot;}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/insertTablet</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>Sample response:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">code</td><td style="text-align:left;">integer</td><td style="text-align:left;">status code</td></tr><tr><td style="text-align:left;">message</td><td style="text-align:left;">string</td><td style="text-align:left;">message</td></tr></tbody></table><p>Sample response:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">200</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;SUCCESS_STATUS&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><h3 id="_3-5-insertrecords" tabindex="-1"><a class="header-anchor" href="#_3-5-insertrecords"><span>3.5 insertRecords</span></a></h3><p>Request method: <code>POST</code></p><p>Request header: <code>application/json</code></p><p>Request path: <code>http://ip:port/rest/v2/insertRecords</code></p><p>Parameter Description:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">is required</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">timestamps</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">Time column</td></tr><tr><td style="text-align:left;">measurements_list</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">The name of the measuring point</td></tr><tr><td style="text-align:left;">data_types_list</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">The data type</td></tr><tr><td style="text-align:left;">values_list</td><td style="text-align:left;">array</td><td style="text-align:left;">yes</td><td style="text-align:left;">Value columns, the values in each column can be <code>null</code></td></tr><tr><td style="text-align:left;">devices</td><td style="text-align:left;">string</td><td style="text-align:left;">yes</td><td style="text-align:left;">Device name</td></tr><tr><td style="text-align:left;">is_aligned</td><td style="text-align:left;">boolean</td><td style="text-align:left;">yes</td><td style="text-align:left;">Whether to align the timeseries</td></tr></tbody></table><p>Example request:</p><div class="language-shell line-numbers-mode" data-highlighter="shiki" data-ext="shell" data-title="shell" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#61AFEF;">curl</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Content-Type:application/json&quot;</span><span style="color:#D19A66;"> -H</span><span style="color:#98C379;"> &quot;Authorization:Basic cm9vdDpyb290&quot;</span><span style="color:#D19A66;"> -X</span><span style="color:#98C379;"> POST</span><span style="color:#D19A66;"> --data</span><span style="color:#98C379;"> &#39;{&quot;timestamps&quot;:[1635232113960,1635232151960,1635232143960,1635232143960],&quot;measurements_list&quot;:[[&quot;s33&quot;,&quot;s44&quot;],[&quot;s55&quot;,&quot;s66&quot;],[&quot;s77&quot;,&quot;s88&quot;],[&quot;s771&quot;,&quot;s881&quot;]],&quot;data_types_list&quot;:[[&quot;INT32&quot;,&quot;INT64&quot;],[&quot;FLOAT&quot;,&quot;DOUBLE&quot;],[&quot;FLOAT&quot;,&quot;DOUBLE&quot;],[&quot;BOOLEAN&quot;,&quot;TEXT&quot;]],&quot;values_list&quot;:[[1,11],[2.1,2],[4,6],[false,&quot;cccccc&quot;]],&quot;is_aligned&quot;:false,&quot;devices&quot;:[&quot;root.s1&quot;,&quot;root.s1&quot;,&quot;root.s1&quot;,&quot;root.s3&quot;]}&#39;</span><span style="color:#98C379;"> http://127.0.0.1:18080/rest/v2/insertRecords</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>Sample response:</p><table><thead><tr><th style="text-align:left;">parameter name</th><th style="text-align:left;">parameter type</th><th style="text-align:left;">parameter describe</th></tr></thead><tbody><tr><td style="text-align:left;">code</td><td style="text-align:left;">integer</td><td style="text-align:left;">status code</td></tr><tr><td style="text-align:left;">message</td><td style="text-align:left;">string</td><td style="text-align:left;">message</td></tr></tbody></table><p>Sample response:</p><div class="language-json line-numbers-mode" data-highlighter="shiki" data-ext="json" data-title="json" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#ABB2BF;">{</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;code&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">200</span><span style="color:#ABB2BF;">,</span></span>
<span class="line"><span style="color:#E06C75;"> &quot;message&quot;</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&quot;SUCCESS_STATUS&quot;</span></span>
<span class="line"><span style="color:#ABB2BF;">}</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></div><h2 id="_4-configuration" tabindex="-1"><a class="header-anchor" href="#_4-configuration"><span>4. Configuration</span></a></h2><p>The configuration is located in &#39;iotdb-system.properties&#39;.</p><ul><li>Set &#39;enable_rest_service&#39; to &#39;true&#39; to enable the module, and &#39;false&#39; to disable the module. By default, this value is&#39; false &#39;.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">enable_rest_service</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">true</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>This parameter is valid only when &#39;enable_REST_service =true&#39;. Set &#39;rest_service_port&#39; to a number (1025 to 65535) to customize the REST service socket port. By default, the value is 18080.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">rest_service_port</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">18080</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>Set &#39;enable_swagger&#39; to &#39;true&#39; to display rest service interface information through swagger, and &#39;false&#39; to do not display the rest service interface information through the swagger. By default, this value is&#39; false &#39;.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">enable_swagger</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">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><ul><li>The maximum number of rows in the result set that can be returned by a query. When the number of rows in the returned result set exceeds the limit, the status code <code>411</code> is returned.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">rest_query_default_row_size_limit</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">10000</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>Expiration time for caching customer login information (used to speed up user authentication, in seconds, 8 hours by default)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">cache_expire</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">28800</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>Maximum number of users stored in the cache (default: 100)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">cache_max_num</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">100</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>Initial cache size (default: 10)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">cache_init_num</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">10</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>REST Service whether to enable SSL configuration, set &#39;enable_https&#39; to&#39; true &#39;to enable the module, and set&#39; false &#39;to disable the module. By default, this value is&#39; false &#39;.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">enable_https</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">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><ul><li>keyStore location path (optional)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">key_store_path</span><span style="color:#ABB2BF;">=</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>keyStore password (optional)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">key_store_pwd</span><span style="color:#ABB2BF;">=</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>trustStore location path (optional)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">trust_store_path</span><span style="color:#ABB2BF;">=</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>trustStore password (optional)</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">trust_store_pwd</span><span style="color:#ABB2BF;">=</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><ul><li>SSL timeout period, in seconds</li></ul><div class="language-properties line-numbers-mode" data-highlighter="shiki" data-ext="properties" data-title="properties" style="background-color:#282c34;color:#abb2bf;"><pre class="shiki one-dark-pro vp-code"><code><span class="line"><span style="color:#C678DD;">idle_timeout</span><span style="color:#ABB2BF;">=</span><span style="color:#98C379;">5000</span></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div>`,162)]))}const r=n(o,[["render",t],["__file","RestServiceV2.html.vue"]]),c=JSON.parse(`{"path":"/UserGuide/latest/API/RestServiceV2.html","title":"REST API V2","lang":"en-US","frontmatter":{"description":"REST API V2 IoTDB's RESTful services can be used for query, write, and management operations, using the OpenAPI standard to define interfaces and generate frameworks. 1. Enable ...","head":[["link",{"rel":"alternate","hreflang":"zh-cn","href":"https://iotdb.apache.org/zh/UserGuide/latest/API/RestServiceV2.html"}],["meta",{"property":"og:url","content":"https://iotdb.apache.org/UserGuide/latest/API/RestServiceV2.html"}],["meta",{"property":"og:site_name","content":"IoTDB Website"}],["meta",{"property":"og:title","content":"REST API V2"}],["meta",{"property":"og:description","content":"REST API V2 IoTDB's RESTful services can be used for query, write, and management operations, using the OpenAPI standard to define interfaces and generate frameworks. 1. Enable ..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:locale:alternate","content":"zh-CN"}],["meta",{"property":"og:updated_time","content":"2025-03-04T02:53:50.000Z"}],["meta",{"property":"article:modified_time","content":"2025-03-04T02:53:50.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"REST API V2\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2025-03-04T02:53:50.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"1. Enable RESTful Services","slug":"_1-enable-restful-services","link":"#_1-enable-restful-services","children":[]},{"level":2,"title":"2. Authentication","slug":"_2-authentication","link":"#_2-authentication","children":[]},{"level":2,"title":"3. Interface","slug":"_3-interface","link":"#_3-interface","children":[{"level":3,"title":"3.1 ping","slug":"_3-1-ping","link":"#_3-1-ping","children":[]},{"level":3,"title":"3.2 query","slug":"_3-2-query","link":"#_3-2-query","children":[]},{"level":3,"title":"3.3 nonQuery","slug":"_3-3-nonquery","link":"#_3-3-nonquery","children":[]},{"level":3,"title":"3.4 insertTablet","slug":"_3-4-inserttablet","link":"#_3-4-inserttablet","children":[]},{"level":3,"title":"3.5 insertRecords","slug":"_3-5-insertrecords","link":"#_3-5-insertrecords","children":[]}]},{"level":2,"title":"4. Configuration","slug":"_4-configuration","link":"#_4-configuration","children":[]}],"git":{"createdTime":1688958677000,"updatedTime":1741056830000,"contributors":[{"name":"CritasWang","username":"CritasWang","email":"critas@outlook.com","commits":3,"url":"https://github.com/CritasWang"},{"name":"Lei","username":"Lei","email":"33376433+LeiRui@users.noreply.github.com","commits":1,"url":"https://github.com/Lei"},{"name":"CloudWise-Lukemiao","username":"CloudWise-Lukemiao","email":"76942485+CloudWise-Lukemiao@users.noreply.github.com","commits":3,"url":"https://github.com/CloudWise-Lukemiao"},{"name":"Cloudwise_Luke","username":"Cloudwise_Luke","email":"282583553@qq.com","commits":1,"url":"https://github.com/Cloudwise_Luke"},{"name":"wanghui42","username":"wanghui42","email":"105700158+wanghui42@users.noreply.github.com","commits":1,"url":"https://github.com/wanghui42"},{"name":"shuwenwei","username":"shuwenwei","email":"55970239+shuwenwei@users.noreply.github.com","commits":1,"url":"https://github.com/shuwenwei"},{"name":"majialin","username":"majialin","email":"107627937+mal117@users.noreply.github.com","commits":1,"url":"https://github.com/majialin"},{"name":"石林松","username":"石林松","email":"50943998+shi10lin0s@users.noreply.github.com","commits":1,"url":"https://github.com/石林松"},{"name":"W1y1r","username":"W1y1r","email":"150988475+W1y1r@users.noreply.github.com","commits":5,"url":"https://github.com/W1y1r"},{"name":"Mister-Hope","username":"Mister-Hope","email":"mister-hope@outlook.com","commits":1,"url":"https://github.com/Mister-Hope"},{"name":"leto-b","username":"leto-b","email":"bingqian.bai@timecho.com","commits":2,"url":"https://github.com/leto-b"}]},"readingTime":{"minutes":6.64,"words":1991},"filePathRelative":"UserGuide/latest/API/RestServiceV2.md","localizedDate":"July 10, 2023","autoDesc":true}`);export{r as comp,c as data};