| import{_ as n,c as a,b as e,o as t}from"./app-Bhq43HqP.js";const l={};function p(i,s){return t(),a("div",null,s[0]||(s[0]=[e(`<h1 id="restful-api-v1-not-recommend" tabindex="-1"><a class="header-anchor" href="#restful-api-v1-not-recommend"><span>RESTful API V1(Not Recommend)</span></a></h1><p>IoTDB'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="enable-restful-services" tabindex="-1"><a class="header-anchor" href="#enable-restful-services"><span>Enable RESTful Services</span></a></h2><p>RESTful services are disabled by default.</p><ul><li><p>Developer</p><p>Find the <code>IoTDBrestServiceConfig</code> class under <code>org.apache.iotdb.db.conf.rest</code> in the sever module, and modify <code>enableRestService=true</code>.</p></li><li><p>User</p><p>Find the <code>conf/conf/iotdb-datanode.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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">enable_rest_service</span><span class="token punctuation">=</span><span class="token value attr-value">true</span></span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div></li></ul><h2 id="authentication" tabindex="-1"><a class="header-anchor" href="#authentication"><span>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>'Authorization': 'Basic ' + base64.encode(username + ':' + 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-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">Authorization: Basic cm9vdDpyb2901</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">600</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"WRONG_LOGIN_PASSWORD_ERROR"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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 missing,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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">603</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"UNINITIALIZED_AUTH_ERROR"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="interface" tabindex="-1"><a class="header-anchor" href="#interface"><span>Interface</span></a></h2><h3 id="ping" tabindex="-1"><a class="header-anchor" href="#ping"><span>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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line">$ <span class="token function">curl</span> http://127.0.0.1:18080/ping</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">200</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"SUCCESS_STATUS"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">500</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"thrift service is unavailable"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="query" tabindex="-1"><a class="header-anchor" href="#query"><span>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/v1/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>rowLimit</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>columnNames</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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select s3, s4, s3 + 1 from root.sg27 limit 2"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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 instance</p><div class="language-json line-numbers-mode" data-highlighter="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s3"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s4"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s3 + 1"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1635232143960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232153960</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">11</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token boolean">false</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token boolean">true</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">12.0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show child paths root"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"child paths"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show child nodes root"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"child nodes"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show all ttl"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"database"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"ttl"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show ttl on root.sg27"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"database"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"ttl"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show functions"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"function name"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"function type"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"class name (UDF)"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"ABS"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"ACOS"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"ASIN"</span><span class="token punctuation">,</span></span> |
| <span class="line"> ...</span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"built-in UDTF"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"built-in UDTF"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"built-in UDTF"</span><span class="token punctuation">,</span></span> |
| <span class="line"> ...</span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"org.apache.iotdb.db.query.udf.builtin.UDTFAbs"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"org.apache.iotdb.db.query.udf.builtin.UDTFAcos"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"org.apache.iotdb.db.query.udf.builtin.UDTFAsin"</span><span class="token punctuation">,</span></span> |
| <span class="line"> ...</span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show timeseries"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"timeseries"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"alias"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"database"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"dataType"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"encoding"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"compression"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"tags"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"attributes"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s3"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s4"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28.s3"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28.s4"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"INT32"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"BOOLEAN"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"INT32"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"BOOLEAN"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show latest timeseries"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"timeseries"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"alias"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"database"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"dataType"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"encoding"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"compression"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"tags"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"attributes"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg28.s4"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s4"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28.s3"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s3"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"BOOLEAN"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"BOOLEAN"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"INT32"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"INT32"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"RLE"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"SNAPPY"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token null keyword">null</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"count timeseries root.**"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"count"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">4</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"count nodes root.** level=2"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"count"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">4</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show devices"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"devices"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"isAligned"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"false"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"false"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"show devices with database"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"devices"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"database"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"isAligned"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"root.sg28"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"false"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"false"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"list user"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"user"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select count(*) from root.sg27"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"count(root.sg27.s3)"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"count(root.sg27.s4)"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">0</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">2</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select count(*) from root.** group by level = 1"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"count(root.sg27.*)"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"count(root.sg28.*)"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">3</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">3</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select count(*) from root.sg27 group by([1635232143960,1635232153960),1s)"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"count(root.sg27.s3)"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"count(root.sg27.s4)"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1635232143960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232144960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232145960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232146960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232147960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232148960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232149960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232150960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232151960</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">1635232152960</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token number">0</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select last s3 from root.sg27"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"expressions"</span><span class="token operator">:</span> <span class="token null keyword">null</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"columnNames"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"timeseries"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"value"</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token string">"dataType"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"timestamps"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token number">1635232143960</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"values"</span><span class="token operator">:</span> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"root.sg27.s3"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"11"</span></span> |
| <span class="line"> <span class="token punctuation">]</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token punctuation">[</span></span> |
| <span class="line"> <span class="token string">"INT32"</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"> <span class="token punctuation">]</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select * from root.sg27 disable align"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">407</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"disable align clauses are not supported."</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select count(s3) from root.sg27 align by device"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">407</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"align by device clauses are not supported."</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"select s3, s4 into root.sg29.s1, root.sg29.s2 from root.sg27"}'</span> http://127.0.0.1:18080/rest/v1/query</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">407</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"select into clauses are not supported."</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="nonquery" tabindex="-1"><a class="header-anchor" href="#nonquery"><span>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/v1/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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"sql":"CREATE DATABASE root.ln"}'</span> http://127.0.0.1:18080/rest/v1/nonQuery</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">200</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"SUCCESS_STATUS"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="inserttablet" tabindex="-1"><a class="header-anchor" href="#inserttablet"><span>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/v1/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;">dataTypes</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;">isAligned</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;">deviceId</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-bash line-numbers-mode" data-highlighter="prismjs" data-ext="sh" data-title="sh"><pre><code><span class="line"><span class="token function">curl</span> <span class="token parameter variable">-H</span> <span class="token string">"Content-Type:application/json"</span> <span class="token parameter variable">-H</span> <span class="token string">"Authorization:Basic cm9vdDpyb290"</span> <span class="token parameter variable">-X</span> POST <span class="token parameter variable">--data</span> <span class="token string">'{"timestamps":[1635232143960,1635232153960],"measurements":["s3","s4"],"dataTypes":["INT32","BOOLEAN"],"values":[[11,null],[false,true]],"isAligned":false,"deviceId":"root.sg27"}'</span> http://127.0.0.1:18080/rest/v1/insertTablet</span> |
| <span class="line"></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="prismjs" data-ext="json" data-title="json"><pre><code><span class="line"><span class="token punctuation">{</span></span> |
| <span class="line"> <span class="token property">"code"</span><span class="token operator">:</span> <span class="token number">200</span><span class="token punctuation">,</span></span> |
| <span class="line"> <span class="token property">"message"</span><span class="token operator">:</span> <span class="token string">"SUCCESS_STATUS"</span></span> |
| <span class="line"><span class="token punctuation">}</span></span> |
| <span class="line"></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="configuration" tabindex="-1"><a class="header-anchor" href="#configuration"><span>Configuration</span></a></h2><p>The configuration is located in 'iotdb-datanode.properties'.</p><ul><li>Set 'enable_rest_service' to 'true' to enable the module, and 'false' to disable the module. By default, this value is' false '.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">enable_rest_service</span><span class="token punctuation">=</span><span class="token value attr-value">true</span></span> |
| <span class="line"></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 'enable_REST_service =true'. Set 'rest_service_port' 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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">rest_service_port</span><span class="token punctuation">=</span><span class="token value attr-value">18080</span></span> |
| <span class="line"></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 'enable_swagger' to 'true' to display rest service interface information through swagger, and 'false' to do not display the rest service interface information through the swagger. By default, this value is' false '.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">enable_swagger</span><span class="token punctuation">=</span><span class="token value attr-value">false</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">rest_query_default_row_size_limit</span><span class="token punctuation">=</span><span class="token value attr-value">10000</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">cache_expire</span><span class="token punctuation">=</span><span class="token value attr-value">28800</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">cache_max_num</span><span class="token punctuation">=</span><span class="token value attr-value">100</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">cache_init_num</span><span class="token punctuation">=</span><span class="token value attr-value">10</span></span> |
| <span class="line"></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 'enable_https' to' true 'to enable the module, and set' false 'to disable the module. By default, this value is' false '.</li></ul><div class="language-properties line-numbers-mode" data-highlighter="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">enable_https</span><span class="token punctuation">=</span><span class="token value attr-value">false</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">key_store_path</span><span class="token punctuation">=</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">key_store_pwd</span><span class="token punctuation">=</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">trust_store_path</span><span class="token punctuation">=</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">trust_store_pwd</span><span class="token punctuation">=</span></span> |
| <span class="line"></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="prismjs" data-ext="properties" data-title="properties"><pre><code><span class="line"><span class="token key attr-name">idle_timeout</span><span class="token punctuation">=</span><span class="token value attr-value">5000</span></span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div>`,150)]))}const c=n(l,[["render",p],["__file","RestServiceV1.html.vue"]]),u=JSON.parse(`{"path":"/UserGuide/latest/API/RestServiceV1.html","title":"RESTful API V1(Not Recommend)","lang":"en-US","frontmatter":{"description":"RESTful API V1(Not Recommend) IoTDB's RESTful services can be used for query, write, and management operations, using the OpenAPI standard to define interfaces and generate fram...","head":[["link",{"rel":"alternate","hreflang":"zh-cn","href":"https://iotdb.apache.org/zh/UserGuide/latest/API/RestServiceV1.html"}],["meta",{"property":"og:url","content":"https://iotdb.apache.org/UserGuide/latest/API/RestServiceV1.html"}],["meta",{"property":"og:site_name","content":"IoTDB Website"}],["meta",{"property":"og:title","content":"RESTful API V1(Not Recommend)"}],["meta",{"property":"og:description","content":"RESTful API V1(Not Recommend) IoTDB's RESTful services can be used for query, write, and management operations, using the OpenAPI standard to define interfaces and generate fram..."}],["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":"2024-09-05T02:28:48.000Z"}],["meta",{"property":"article:modified_time","content":"2024-09-05T02:28:48.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"RESTful API V1(Not Recommend)\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2024-09-05T02:28:48.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"Enable RESTful Services","slug":"enable-restful-services","link":"#enable-restful-services","children":[]},{"level":2,"title":"Authentication","slug":"authentication","link":"#authentication","children":[]},{"level":2,"title":"Interface","slug":"interface","link":"#interface","children":[{"level":3,"title":"ping","slug":"ping","link":"#ping","children":[]},{"level":3,"title":"query","slug":"query","link":"#query","children":[]},{"level":3,"title":"nonQuery","slug":"nonquery","link":"#nonquery","children":[]},{"level":3,"title":"insertTablet","slug":"inserttablet","link":"#inserttablet","children":[]}]},{"level":2,"title":"Configuration","slug":"configuration","link":"#configuration","children":[]}],"git":{"createdTime":1688958677000,"updatedTime":1725503328000,"contributors":[{"name":"W1y1r","email":"150988475+W1y1r@users.noreply.github.com","commits":2},{"name":"CritasWang","email":"critas@outlook.com","commits":1},{"name":"majialin","email":"107627937+mal117@users.noreply.github.com","commits":1},{"name":"shuwenwei","email":"55970239+shuwenwei@users.noreply.github.com","commits":1},{"name":"wanghui42","email":"105700158+wanghui42@users.noreply.github.com","commits":1},{"name":"石林松","email":"50943998+shi10lin0s@users.noreply.github.com","commits":1}]},"readingTime":{"minutes":6.19,"words":1856},"filePathRelative":"UserGuide/latest/API/RestServiceV1.md","localizedDate":"July 10, 2023","autoDesc":true}`);export{c as comp,u as data}; |