<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title> </title>
    <meta name="generator" content="VuePress 1.5.2">
    <link rel="icon" href="/favicon.ico">
    <meta name="description" content=" ">
    <meta name="Description" content="Apache IoTDB: Time Series Database for IoT">
    <meta name="Keywords" content="TSDB, time series, time series database, IoTDB, IoT database, IoT data management,时序数据库, 时间序列管理, IoTDB, 物联网数据库, 实时数据库, 物联网数据管理, 物联网数据">
    <meta name="baidu-site-verification" content="wfKETzB3OT">
    <meta name="google-site-verification" content="mZWAoRY0yj_HAr-s47zHCGHzx5Ju-RVm5wDbPnwQYFo">
    <link rel="preload" href="/assets/css/0.styles.47c4181e.css" as="style"><link rel="preload" href="/assets/js/app.882d9a07.js" as="script"><link rel="preload" href="/assets/js/3.1dc302ea.js" as="script"><link rel="preload" href="/assets/js/38.7ed5f5d7.js" as="script"><link rel="prefetch" href="/assets/js/10.df7ec35f.js"><link rel="prefetch" href="/assets/js/100.46f902a0.js"><link rel="prefetch" href="/assets/js/101.ba2c5257.js"><link rel="prefetch" href="/assets/js/102.8cfa62ff.js"><link rel="prefetch" href="/assets/js/103.ce6083bd.js"><link rel="prefetch" href="/assets/js/104.2c7e306e.js"><link rel="prefetch" href="/assets/js/105.659f7d7c.js"><link rel="prefetch" href="/assets/js/106.44f523c6.js"><link rel="prefetch" href="/assets/js/107.aabb4e24.js"><link rel="prefetch" href="/assets/js/108.0b847ccb.js"><link rel="prefetch" href="/assets/js/109.0ecdc3e8.js"><link rel="prefetch" href="/assets/js/11.a86e49df.js"><link rel="prefetch" href="/assets/js/110.5cb485d3.js"><link rel="prefetch" href="/assets/js/111.f84f011d.js"><link rel="prefetch" href="/assets/js/112.d91219bd.js"><link rel="prefetch" href="/assets/js/113.802ff697.js"><link rel="prefetch" href="/assets/js/114.4dfa6fa4.js"><link rel="prefetch" href="/assets/js/115.3b84b03c.js"><link rel="prefetch" href="/assets/js/116.95c8cffd.js"><link rel="prefetch" href="/assets/js/117.75446827.js"><link rel="prefetch" href="/assets/js/118.97f15742.js"><link rel="prefetch" href="/assets/js/119.b6069f00.js"><link rel="prefetch" href="/assets/js/12.97a469f4.js"><link rel="prefetch" href="/assets/js/120.de4776ca.js"><link rel="prefetch" href="/assets/js/121.86b44edd.js"><link rel="prefetch" href="/assets/js/122.793976e9.js"><link rel="prefetch" href="/assets/js/123.138a7ccb.js"><link rel="prefetch" href="/assets/js/124.16a35af8.js"><link rel="prefetch" href="/assets/js/125.c481e922.js"><link rel="prefetch" href="/assets/js/126.fb82ff27.js"><link rel="prefetch" href="/assets/js/127.17ab45fd.js"><link rel="prefetch" href="/assets/js/128.9656b085.js"><link rel="prefetch" href="/assets/js/129.0aa7aabb.js"><link rel="prefetch" href="/assets/js/13.ca512a7d.js"><link rel="prefetch" href="/assets/js/130.7d14bd29.js"><link rel="prefetch" href="/assets/js/131.e71f08bd.js"><link rel="prefetch" href="/assets/js/132.6ea6cdf1.js"><link rel="prefetch" href="/assets/js/133.a388baa8.js"><link rel="prefetch" href="/assets/js/134.54d48b3d.js"><link rel="prefetch" href="/assets/js/135.7a128f8f.js"><link rel="prefetch" href="/assets/js/136.00a01734.js"><link rel="prefetch" href="/assets/js/137.aa593fc2.js"><link rel="prefetch" href="/assets/js/138.31960a86.js"><link rel="prefetch" href="/assets/js/139.562e6302.js"><link rel="prefetch" href="/assets/js/14.f91f7aa3.js"><link rel="prefetch" href="/assets/js/140.5f453876.js"><link rel="prefetch" href="/assets/js/141.b32d4af3.js"><link rel="prefetch" href="/assets/js/142.585e2900.js"><link rel="prefetch" href="/assets/js/143.1deb8b59.js"><link rel="prefetch" href="/assets/js/144.e98c9234.js"><link rel="prefetch" href="/assets/js/145.69e3d8ba.js"><link rel="prefetch" href="/assets/js/146.854ca873.js"><link rel="prefetch" href="/assets/js/147.ce852530.js"><link rel="prefetch" href="/assets/js/148.4df7ad54.js"><link rel="prefetch" href="/assets/js/149.5885680e.js"><link rel="prefetch" href="/assets/js/15.35ce02ea.js"><link rel="prefetch" href="/assets/js/150.e77a1752.js"><link rel="prefetch" href="/assets/js/151.e256e236.js"><link rel="prefetch" href="/assets/js/152.2269a9f4.js"><link rel="prefetch" href="/assets/js/153.67177abf.js"><link rel="prefetch" href="/assets/js/154.4b8625b0.js"><link rel="prefetch" href="/assets/js/155.84ff10ab.js"><link rel="prefetch" href="/assets/js/156.bbce15cb.js"><link rel="prefetch" href="/assets/js/157.3b84194d.js"><link rel="prefetch" href="/assets/js/158.1fc4f128.js"><link rel="prefetch" href="/assets/js/159.e74da70a.js"><link rel="prefetch" href="/assets/js/16.d053c0dc.js"><link rel="prefetch" href="/assets/js/160.5757746b.js"><link rel="prefetch" href="/assets/js/161.0956a685.js"><link rel="prefetch" href="/assets/js/162.7bdbb2e8.js"><link rel="prefetch" href="/assets/js/163.caae3dd0.js"><link rel="prefetch" href="/assets/js/164.3d527296.js"><link rel="prefetch" href="/assets/js/165.9e2592b0.js"><link rel="prefetch" href="/assets/js/166.936aefc2.js"><link rel="prefetch" href="/assets/js/167.b715a39c.js"><link rel="prefetch" href="/assets/js/168.21c20463.js"><link rel="prefetch" href="/assets/js/169.0cea4d63.js"><link rel="prefetch" href="/assets/js/17.54956aa7.js"><link rel="prefetch" href="/assets/js/170.99755400.js"><link rel="prefetch" href="/assets/js/171.a503fe92.js"><link rel="prefetch" href="/assets/js/172.b62ff159.js"><link rel="prefetch" href="/assets/js/173.ad699d64.js"><link rel="prefetch" href="/assets/js/174.12971908.js"><link rel="prefetch" href="/assets/js/175.d260a942.js"><link rel="prefetch" href="/assets/js/176.15310578.js"><link rel="prefetch" href="/assets/js/177.dca59880.js"><link rel="prefetch" href="/assets/js/178.762b5655.js"><link rel="prefetch" href="/assets/js/179.8a2150fa.js"><link rel="prefetch" href="/assets/js/18.0e32b1ca.js"><link rel="prefetch" href="/assets/js/180.812eff50.js"><link rel="prefetch" href="/assets/js/181.25741a4f.js"><link rel="prefetch" href="/assets/js/182.be1ead30.js"><link rel="prefetch" href="/assets/js/183.65da99ac.js"><link rel="prefetch" href="/assets/js/184.19aa7b39.js"><link rel="prefetch" href="/assets/js/185.3b47818d.js"><link rel="prefetch" href="/assets/js/186.f17445b2.js"><link rel="prefetch" href="/assets/js/187.5ffa8fb7.js"><link rel="prefetch" href="/assets/js/188.985b2930.js"><link rel="prefetch" href="/assets/js/189.8a086656.js"><link rel="prefetch" href="/assets/js/19.e1031edc.js"><link rel="prefetch" href="/assets/js/190.e1795abc.js"><link rel="prefetch" href="/assets/js/191.ef63b7c9.js"><link rel="prefetch" href="/assets/js/192.9b54e8a1.js"><link rel="prefetch" href="/assets/js/193.b7730945.js"><link rel="prefetch" href="/assets/js/194.bdfd3b2a.js"><link rel="prefetch" href="/assets/js/195.a49577ce.js"><link rel="prefetch" href="/assets/js/196.d7d6ea08.js"><link rel="prefetch" href="/assets/js/197.0038edae.js"><link rel="prefetch" href="/assets/js/198.2b7feb5b.js"><link rel="prefetch" href="/assets/js/199.246f826f.js"><link rel="prefetch" href="/assets/js/20.6630eb9b.js"><link rel="prefetch" href="/assets/js/200.7dd47538.js"><link rel="prefetch" href="/assets/js/201.b9f3f3ba.js"><link rel="prefetch" href="/assets/js/202.88580a02.js"><link rel="prefetch" href="/assets/js/203.dc19a146.js"><link rel="prefetch" href="/assets/js/204.3ae4039b.js"><link rel="prefetch" href="/assets/js/205.11713f93.js"><link rel="prefetch" href="/assets/js/206.5009f186.js"><link rel="prefetch" href="/assets/js/207.02d308ce.js"><link rel="prefetch" href="/assets/js/208.e0d30f83.js"><link rel="prefetch" href="/assets/js/209.a189a8f5.js"><link rel="prefetch" href="/assets/js/21.6ba053c1.js"><link rel="prefetch" href="/assets/js/210.0ab50f1b.js"><link rel="prefetch" href="/assets/js/211.ba454b99.js"><link rel="prefetch" href="/assets/js/212.5ab320e9.js"><link rel="prefetch" href="/assets/js/213.0290b30c.js"><link rel="prefetch" href="/assets/js/214.05b80625.js"><link rel="prefetch" href="/assets/js/215.69f82d6d.js"><link rel="prefetch" href="/assets/js/216.ab905448.js"><link rel="prefetch" href="/assets/js/217.bde06399.js"><link rel="prefetch" href="/assets/js/218.c3d46cb2.js"><link rel="prefetch" href="/assets/js/219.cf09aab1.js"><link rel="prefetch" href="/assets/js/22.2cc6e418.js"><link rel="prefetch" href="/assets/js/220.acfa6385.js"><link rel="prefetch" href="/assets/js/221.85cade19.js"><link rel="prefetch" href="/assets/js/222.138988e9.js"><link rel="prefetch" href="/assets/js/223.33eb46d4.js"><link rel="prefetch" href="/assets/js/224.5b505a1a.js"><link rel="prefetch" href="/assets/js/225.a00c337a.js"><link rel="prefetch" href="/assets/js/226.40b7642d.js"><link rel="prefetch" href="/assets/js/227.5855e16b.js"><link rel="prefetch" href="/assets/js/228.510e8061.js"><link rel="prefetch" href="/assets/js/229.6c905504.js"><link rel="prefetch" href="/assets/js/23.44b5e587.js"><link rel="prefetch" href="/assets/js/230.80eec0cb.js"><link rel="prefetch" href="/assets/js/231.5353f9c0.js"><link rel="prefetch" href="/assets/js/232.7caab4ae.js"><link rel="prefetch" href="/assets/js/233.429eb9ac.js"><link rel="prefetch" href="/assets/js/234.92daf6aa.js"><link rel="prefetch" href="/assets/js/235.4f96a6d2.js"><link rel="prefetch" href="/assets/js/236.f6d1fcf4.js"><link rel="prefetch" href="/assets/js/237.c81eb221.js"><link rel="prefetch" href="/assets/js/238.4d0eb5a6.js"><link rel="prefetch" href="/assets/js/239.b5fea603.js"><link rel="prefetch" href="/assets/js/24.22d894b5.js"><link rel="prefetch" href="/assets/js/240.4b907e8d.js"><link rel="prefetch" href="/assets/js/241.509179a2.js"><link rel="prefetch" href="/assets/js/242.6204b29f.js"><link rel="prefetch" href="/assets/js/243.6557eaac.js"><link rel="prefetch" href="/assets/js/244.00ba8687.js"><link rel="prefetch" href="/assets/js/245.2bccaee6.js"><link rel="prefetch" href="/assets/js/246.f450dac3.js"><link rel="prefetch" href="/assets/js/247.f8bded05.js"><link rel="prefetch" href="/assets/js/248.079a3425.js"><link rel="prefetch" href="/assets/js/249.67bc3845.js"><link rel="prefetch" href="/assets/js/25.de046fce.js"><link rel="prefetch" href="/assets/js/250.205203eb.js"><link rel="prefetch" href="/assets/js/251.c02b55cc.js"><link rel="prefetch" href="/assets/js/252.4672e689.js"><link rel="prefetch" href="/assets/js/253.eb0e0af8.js"><link rel="prefetch" href="/assets/js/254.a4560c5d.js"><link rel="prefetch" href="/assets/js/255.7da81997.js"><link rel="prefetch" href="/assets/js/256.12d8ab80.js"><link rel="prefetch" href="/assets/js/257.f75acca0.js"><link rel="prefetch" href="/assets/js/258.e5a6c8e4.js"><link rel="prefetch" href="/assets/js/259.3ffb6bec.js"><link rel="prefetch" href="/assets/js/26.22388c67.js"><link rel="prefetch" href="/assets/js/260.67eed8b3.js"><link rel="prefetch" href="/assets/js/261.6f75c141.js"><link rel="prefetch" href="/assets/js/262.2931901b.js"><link rel="prefetch" href="/assets/js/263.16ee64cc.js"><link rel="prefetch" href="/assets/js/264.cd60d20b.js"><link rel="prefetch" href="/assets/js/265.77c31e29.js"><link rel="prefetch" href="/assets/js/266.a79ab7b3.js"><link rel="prefetch" href="/assets/js/267.1c871665.js"><link rel="prefetch" href="/assets/js/268.6b7edb39.js"><link rel="prefetch" href="/assets/js/269.623f7925.js"><link rel="prefetch" href="/assets/js/27.1092da6f.js"><link rel="prefetch" href="/assets/js/270.1588dc7e.js"><link rel="prefetch" href="/assets/js/271.9d8c84d1.js"><link rel="prefetch" href="/assets/js/272.62691b38.js"><link rel="prefetch" href="/assets/js/273.9edcbfec.js"><link rel="prefetch" href="/assets/js/274.adab5090.js"><link rel="prefetch" href="/assets/js/275.5d464f4c.js"><link rel="prefetch" href="/assets/js/276.56bc4fb1.js"><link rel="prefetch" href="/assets/js/277.560abb1e.js"><link rel="prefetch" href="/assets/js/278.200f23dd.js"><link rel="prefetch" href="/assets/js/279.85bb2707.js"><link rel="prefetch" href="/assets/js/28.6ac8124e.js"><link rel="prefetch" href="/assets/js/280.78cd815f.js"><link rel="prefetch" href="/assets/js/281.301cd53d.js"><link rel="prefetch" href="/assets/js/282.0efd5adf.js"><link rel="prefetch" href="/assets/js/283.cc93d532.js"><link rel="prefetch" href="/assets/js/284.813a0148.js"><link rel="prefetch" href="/assets/js/285.64d647b3.js"><link rel="prefetch" href="/assets/js/286.f08aee76.js"><link rel="prefetch" href="/assets/js/287.7b650265.js"><link rel="prefetch" href="/assets/js/288.987b1a1a.js"><link rel="prefetch" href="/assets/js/289.0a539872.js"><link rel="prefetch" href="/assets/js/29.066202c5.js"><link rel="prefetch" href="/assets/js/290.29960eb5.js"><link rel="prefetch" href="/assets/js/291.4e4d9067.js"><link rel="prefetch" href="/assets/js/292.12a67deb.js"><link rel="prefetch" href="/assets/js/293.40828f6a.js"><link rel="prefetch" href="/assets/js/294.fdd0a014.js"><link rel="prefetch" href="/assets/js/295.f9f2d91c.js"><link rel="prefetch" href="/assets/js/296.e8663dd1.js"><link rel="prefetch" href="/assets/js/297.fb8a6d71.js"><link rel="prefetch" href="/assets/js/298.caf7b822.js"><link rel="prefetch" href="/assets/js/299.6a130c21.js"><link rel="prefetch" href="/assets/js/30.f001d2e0.js"><link rel="prefetch" href="/assets/js/300.01e0caa1.js"><link rel="prefetch" href="/assets/js/301.f32807cc.js"><link rel="prefetch" href="/assets/js/302.779651c3.js"><link rel="prefetch" href="/assets/js/303.3bdd3fe3.js"><link rel="prefetch" href="/assets/js/304.f0f81199.js"><link rel="prefetch" href="/assets/js/305.193ac400.js"><link rel="prefetch" href="/assets/js/306.bdbfc571.js"><link rel="prefetch" href="/assets/js/307.e5ac5443.js"><link rel="prefetch" href="/assets/js/308.104d4362.js"><link rel="prefetch" href="/assets/js/309.93ff7c1d.js"><link rel="prefetch" href="/assets/js/31.51ef7648.js"><link rel="prefetch" href="/assets/js/310.a6f56aee.js"><link rel="prefetch" href="/assets/js/311.5bb6779a.js"><link rel="prefetch" href="/assets/js/312.d1f1032f.js"><link rel="prefetch" href="/assets/js/313.d5d7bcf5.js"><link rel="prefetch" href="/assets/js/314.6220e3b0.js"><link rel="prefetch" href="/assets/js/315.989f9c3b.js"><link rel="prefetch" href="/assets/js/316.5c6be00c.js"><link rel="prefetch" href="/assets/js/317.5f443eed.js"><link rel="prefetch" href="/assets/js/318.bc72ddf9.js"><link rel="prefetch" href="/assets/js/319.5d9d8194.js"><link rel="prefetch" href="/assets/js/32.7dba92e8.js"><link rel="prefetch" href="/assets/js/320.aee2114d.js"><link rel="prefetch" href="/assets/js/321.de477b38.js"><link rel="prefetch" href="/assets/js/322.aa9d4016.js"><link rel="prefetch" href="/assets/js/323.178065b6.js"><link rel="prefetch" href="/assets/js/324.51fb6a96.js"><link rel="prefetch" href="/assets/js/325.1d301881.js"><link rel="prefetch" href="/assets/js/326.42161b0a.js"><link rel="prefetch" href="/assets/js/327.28ab6252.js"><link rel="prefetch" href="/assets/js/328.f7cc4627.js"><link rel="prefetch" href="/assets/js/329.b5e1d8d1.js"><link rel="prefetch" href="/assets/js/33.38edc1ca.js"><link rel="prefetch" href="/assets/js/330.110568ed.js"><link rel="prefetch" href="/assets/js/331.e357336a.js"><link rel="prefetch" href="/assets/js/332.7246ff9a.js"><link rel="prefetch" href="/assets/js/34.09d75d60.js"><link rel="prefetch" href="/assets/js/35.28f77cc1.js"><link rel="prefetch" href="/assets/js/36.170a378d.js"><link rel="prefetch" href="/assets/js/37.8a712480.js"><link rel="prefetch" href="/assets/js/39.9e375df7.js"><link rel="prefetch" href="/assets/js/4.cfbdbe89.js"><link rel="prefetch" href="/assets/js/40.ca86458f.js"><link rel="prefetch" href="/assets/js/41.0a8911c5.js"><link rel="prefetch" href="/assets/js/42.1f807061.js"><link rel="prefetch" href="/assets/js/43.2ef6f503.js"><link rel="prefetch" href="/assets/js/44.5e2c4992.js"><link rel="prefetch" href="/assets/js/45.90038f5d.js"><link rel="prefetch" href="/assets/js/46.b5efd5cf.js"><link rel="prefetch" href="/assets/js/47.0aa5076d.js"><link rel="prefetch" href="/assets/js/48.b5d02afd.js"><link rel="prefetch" href="/assets/js/49.f9d012fd.js"><link rel="prefetch" href="/assets/js/5.f601e2c6.js"><link rel="prefetch" href="/assets/js/50.63eccc09.js"><link rel="prefetch" href="/assets/js/51.53cfc462.js"><link rel="prefetch" href="/assets/js/52.e9807f0e.js"><link rel="prefetch" href="/assets/js/53.cb7ce425.js"><link rel="prefetch" href="/assets/js/54.b808d48c.js"><link rel="prefetch" href="/assets/js/55.f9ab930d.js"><link rel="prefetch" href="/assets/js/56.4ef6b77e.js"><link rel="prefetch" href="/assets/js/57.ec93b220.js"><link rel="prefetch" href="/assets/js/58.8e78043b.js"><link rel="prefetch" href="/assets/js/59.33e79866.js"><link rel="prefetch" href="/assets/js/6.4e244a8f.js"><link rel="prefetch" href="/assets/js/60.416039d7.js"><link rel="prefetch" href="/assets/js/61.31256bc1.js"><link rel="prefetch" href="/assets/js/62.4dd632ab.js"><link rel="prefetch" href="/assets/js/63.d3f67d18.js"><link rel="prefetch" href="/assets/js/64.d7e3c018.js"><link rel="prefetch" href="/assets/js/65.ba0437da.js"><link rel="prefetch" href="/assets/js/66.fbe062c4.js"><link rel="prefetch" href="/assets/js/67.8b6f0f48.js"><link rel="prefetch" href="/assets/js/68.4864757c.js"><link rel="prefetch" href="/assets/js/69.0adf4b5e.js"><link rel="prefetch" href="/assets/js/7.69014dd1.js"><link rel="prefetch" href="/assets/js/70.95a01842.js"><link rel="prefetch" href="/assets/js/71.ce3fd007.js"><link rel="prefetch" href="/assets/js/72.69b7729a.js"><link rel="prefetch" href="/assets/js/73.9ae8e1ec.js"><link rel="prefetch" href="/assets/js/74.0476bee6.js"><link rel="prefetch" href="/assets/js/75.b72d48e3.js"><link rel="prefetch" href="/assets/js/76.e914a404.js"><link rel="prefetch" href="/assets/js/77.97d4a82e.js"><link rel="prefetch" href="/assets/js/78.0ccf8bcf.js"><link rel="prefetch" href="/assets/js/79.aac64bb1.js"><link rel="prefetch" href="/assets/js/8.61bc0899.js"><link rel="prefetch" href="/assets/js/80.e392086a.js"><link rel="prefetch" href="/assets/js/81.97388622.js"><link rel="prefetch" href="/assets/js/82.9366dacf.js"><link rel="prefetch" href="/assets/js/83.5ed8acc4.js"><link rel="prefetch" href="/assets/js/84.d1d33d38.js"><link rel="prefetch" href="/assets/js/85.a3ef9d25.js"><link rel="prefetch" href="/assets/js/86.31ecbe2e.js"><link rel="prefetch" href="/assets/js/87.14070733.js"><link rel="prefetch" href="/assets/js/88.1c94e8e0.js"><link rel="prefetch" href="/assets/js/89.b59e84a7.js"><link rel="prefetch" href="/assets/js/9.4c1530ec.js"><link rel="prefetch" href="/assets/js/90.4b2949f4.js"><link rel="prefetch" href="/assets/js/91.6ef1ae99.js"><link rel="prefetch" href="/assets/js/92.c13a05d5.js"><link rel="prefetch" href="/assets/js/93.4f730b35.js"><link rel="prefetch" href="/assets/js/94.2cd2abae.js"><link rel="prefetch" href="/assets/js/95.03d94edd.js"><link rel="prefetch" href="/assets/js/96.5bcbc550.js"><link rel="prefetch" href="/assets/js/97.15877723.js"><link rel="prefetch" href="/assets/js/98.beef80df.js"><link rel="prefetch" href="/assets/js/99.3c55205c.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.3b3aacb0.js">
    <link rel="stylesheet" href="/assets/css/0.styles.47c4181e.css">
  </head>
  <body>
    <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><img src="/img/logo.png" alt=" " class="logo"></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external">
  Wiki
  <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external">
  Foundation
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
  License
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
  Security
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
  Sponsorship
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
  Thanks
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
  Current Events
  <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/incubator-iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link">
    gitHub
    <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external">
  Wiki
  <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external">
  Foundation
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
  License
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
  Security
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
  Sponsorship
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
  Thanks
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
  Current Events
  <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/incubator-iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link">
    gitHub
    <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></nav>  <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>System design</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Architecture</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>TsFile</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>QueryEngine</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>SchemaManager</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>StorageEngine</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>DataQuery</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/SystemDesign/DataQuery/DataQuery.html" class="sidebar-link">DataQuery</a></li><li><a href="/SystemDesign/DataQuery/QueryFundamentals.html" class="sidebar-link">QueryFundamentals</a></li><li><a href="/SystemDesign/DataQuery/SeriesReader.html" class="sidebar-link">SeriesReader</a></li><li><a href="/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="active sidebar-link">RawDataQuery</a></li><li><a href="/SystemDesign/DataQuery/AggregationQuery.html" class="sidebar-link">AggregationQuery</a></li><li><a href="/SystemDesign/DataQuery/GroupByQuery.html" class="sidebar-link">GroupByQuery</a></li><li><a href="/SystemDesign/DataQuery/LastQuery.html" class="sidebar-link">LastQuery</a></li><li><a href="/SystemDesign/DataQuery/AlignByDeviceQuery.html" class="sidebar-link">AlignByDeviceQuery</a></li><li><a href="/SystemDesign/DataQuery/FillFunction.html" class="sidebar-link">FillFunction</a></li><li><a href="/SystemDesign/DataQuery/GroupByFillQuery.html" class="sidebar-link">GroupByFillQuery</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Tools</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Connector</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Client</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="raw-data-query"><a href="#raw-data-query" class="header-anchor">#</a> Raw data query</h1> <h2 id="design-principle"><a href="#design-principle" class="header-anchor">#</a> Design principle</h2> <p>The raw data query can be divided into two categories based on whether it contains value filtering conditions.  When no value filter is included, it can be divided into two categories based on the result set structure.</p> <ul><li>No value filter (no filter or only time filter)
<ul><li>Result set aligned by timestamp (default raw data query)</li> <li>The result set is not aligned with the timestamp (disable align)</li></ul></li> <li>Include value filters
<ul><li>Result set aligned by timestamp</li></ul></li></ul> <p>The above three queries correspond to three different DataSets in the code and encapsulate the execution logic of these three queries.</p> <h2 id="no-value-filter-result-set-aligned-by-timestamp"><a href="#no-value-filter-result-set-aligned-by-timestamp" class="header-anchor">#</a> No value filter + result set aligned by timestamp</h2> <h3 id="org-apache-iotdb-db-query-dataset-rawquerydatasetwithoutvaluefilter"><a href="#org-apache-iotdb-db-query-dataset-rawquerydatasetwithoutvaluefilter" class="header-anchor">#</a> org.apache.iotdb.db.query.dataset.RawQueryDataSetWithoutValueFilter</h3> <p><code>RawQueryDataSetWithoutValueFilter</code> implements query logic that has no value filtering conditions and needs to be aligned according to the timestamp.  Although the final query results require that each time series be aligned according to the timestamp, each time series query can be parallelized.  Here, with the idea of a consumer-producer queue, the operation of obtaining data for each time series is decoupled from the operation of finally aligning all time series.  Each time series corresponds to a producer thread and has its corresponding BlockingQueue. The producer task is responsible for reading the corresponding time series data and putting it into the BlockingQueue; there is only one consumer thread responsible for taking out from each time series BlockingQueue.  After the data is aligned with the timestamp, the results are assembled into a TSQueryDataSet and returned.</p> <p>In specific implementation, considering the resource constraints of the machine, instead of creating a thread for each time series of each query, the thread pool technology is used to submit each time series producer task as a Runnable task  To the thread pool for execution.</p> <p>The following introduces the producer's code first. It is encapsulated in an internal class ReadTask which is a RawQueryDataSetWithoutValueFilter and implements the Runnable interface.</p> <h3 id="org-apache-iotdb-db-query-dataset-rawquerydatasetwithoutvaluefilter-readtask"><a href="#org-apache-iotdb-db-query-dataset-rawquerydatasetwithoutvaluefilter-readtask" class="header-anchor">#</a> org.apache.iotdb.db.query.dataset.RawQueryDataSetWithoutValueFilter.ReadTask</h3> <p><code>ReadTask</code> has two fields</p> <ul><li>private final ManagedSeriesReader reader;</li> <li>private BlockingQueue&lt;BatchData&gt; blockingQueue;</li></ul> <p>The <code>ManagedSeriesReader</code> interface inherits the IBatchReader interface, which is mainly used to read data from a single time series, and adds the following four methods</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>boolean isManagedByQueryManager();

void setManagedByQueryManager(boolean managedByQueryManager);

boolean hasRemaining();

void setHasRemaining(boolean hasRemaining);
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br></div></div><p>The first two methods are used to characterize whether the producer task corresponding to the time series is managed by the query manager, that is, has the producer task exited by itself because the blocking queue is full (the following will explain why it does not block waiting, and  Exit directly); the latter two methods are used to characterize whether there is any data in the reader corresponding to the time series.</p> <p><code>blockingQueue</code> is the blocking queue of the producer task. In fact, the blocking queue will only block unilaterally when the consumer fetches the data. When the producer puts the data, if the queue is full, it will exit directly without blocking.</p> <p>Let ’s take a look at the <code>run ()</code> method of <code>ReadTask</code>. The explanation of the execution process is shown in the code in the form of comments.</p> <h4 id="run"><a href="#run" class="header-anchor">#</a> run()</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void run() {
  try {
    // The reason for the lock here is to ensure that the judgment of the fullness of the blockingQueue is correctly synchronized.
    synchronized (reader) {
      // Because every time a producer task is submitted (whether the producer submits itself recursively or the consumer finds that the producer task exits and submits itself), the queue is checked to see if it is full.  Producer task
      // So once the producer task is submitted, there must be a free space in the blockingQueue, we do not need to check whether the queue is full
      // If the reader corresponding to the time series still has data, enter the loop body
      while (reader.hasNextBatch()) {
        BatchData batchData = reader.nextBatch();
        // Since the BatchData obtained may be empty, it needs to iterate to the first BatchData that is not empty
        if (batchData.isEmpty()) {
          continue;
        }
        // Put the non-empty batchData into the blocking queue. At this time, the blocking queue must be dissatisfied, so it will not block.
        blockingQueue.put(batchData);
        // If the blocking queue is still not full, the producer task recursively submits itself to the thread pool for the next batchData
        if (blockingQueue.remainingCapacity() &gt; 0) {
          pool.submit(this);
        }
        // If the blocking queue is full, the producer task exits and the managedByQueryManager corresponding to the reader is set to false
        else {
          reader.setManagedByQueryManager(false);
        }
        return;
      }
      // The code is executed here, which means that the previous while loop condition is not satisfied, that is, there is no data in the reader corresponding to the time series.
      // We put a SignalBatchData in the blocking queue to inform consumers that there is no more data in this time series, and there is no need to fetch data from the queue corresponding to this time series
      blockingQueue.put(SignalBatchData.getInstance());
      // Set the reader's hasRemaining field to false
      // Inform consumers that they no longer need to submit producer tasks for this time series
      reader.setHasRemaining(false);
      // Set the reader's managedByQueryManager field to false
      reader.setManagedByQueryManager(false);
    }
  } catch (InterruptedException e) {
    LOGGER.error(&quot;Interrupted while putting into the blocking queue: &quot;, e);
    Thread.currentThread().interrupt();
  } catch (IOException e) {
    LOGGER.error(&quot;Something gets wrong while reading from the series reader: &quot;, e);
  } catch (Exception e) {
    LOGGER.error(&quot;Something gets wrong: &quot;, e);
  }
}
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br></div></div><p>Next, introduce the code of the consumer. The main logic of the consumer is to take the value from the queue of each time series, align the timestamps, and then piece together the result set.  The alignment of timestamps is mainly achieved through a minimum heap of timestamps. If the timestamp of the time series is equal to the timestamp at the top of the heap, then the value is taken out; otherwise, the time series value under the timestamp is set to <code>null</code>.</p> <p>First introduce some important fields of consumer tasks</p> <ul><li><p>TreeSet&lt;Long&gt; timeHeap</p> <p>The smallest heap of timestamps for timestamp alignment</p></li> <li><p>BlockingQueue&lt;BatchData&gt;[] blockingQueueArray;</p> <p>An array of blocking queues to store the blocking queues corresponding to each time series</p></li> <li><p>boolean[] noMoreDataInQueueArray</p> <p>There is no value in the blocking queue to represent a certain time series. If it is false, the consumer will not call the <code>take ()</code> method to prevent the consumer thread from being blocked.</p></li> <li><p>BatchData[] cachedBatchDataArray</p> <p>Cache a BatchData fetched from the blocking queue, because the <code>BatchData</code> from<code>take ()</code>in the blocking queue cannot be consumed all at once, so you need to cache</p></li></ul> <p>The <code>init ()</code> method was first called in the constructor of the consumer <code>RawQueryDataSetWithoutValueFilter</code></p> <h4 id="init"><a href="#init" class="header-anchor">#</a> init()</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>private void init() throws InterruptedException {
	timeHeap = new TreeSet&lt;&gt;();
	// Build producer tasks for each time series
	for (int i = 0; i &lt; seriesReaderList.size(); i++) {
	  ManagedSeriesReader reader = seriesReaderList.get(i);
	  reader.setHasRemaining(true);
	  reader.setManagedByQueryManager(true);
	  pool.submit(new ReadTask(reader, blockingQueueArray[i]));
	}
	// Initialize the minimum heap and fill the cache for each time series
	for (int i = 0; i &lt; seriesReaderList.size(); i++) {
	  // Call fillCache (int) method to fill the cache
	  fillCache(i);
	  // Try to put the current minimum timestamp of each time series into the heap
	  if (cachedBatchDataArray[i] != null &amp;&amp; cachedBatchDataArray[i].hasCurrent()) {
	    long time = cachedBatchDataArray[i].currentTime();
	    timeHeap.add(time);
	  }
	}
}
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br></div></div><h4 id="fillcache-int"><a href="#fillcache-int" class="header-anchor">#</a> fillCache(int)</h4> <p>This method is responsible for fetching data from the blocking queue and filling the cache. For the specific logic, see the note below.</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>private void fillCache(int seriesIndex) throws InterruptedException {
    // Get data from the blocking queue, if there is no data, it will block waiting for data in the queue
	BatchData batchData = blockingQueueArray[seriesIndex].take();
	// If it is a signal BatchData, set oMoreDataInQueue of the corresponding time series to false
	if (batchData instanceof SignalBatchData) {
	  noMoreDataInQueueArray[seriesIndex] = true;
	}
	else {
	  // Cache the retrieved BatchData into cachedBatchDataArray
	  cachedBatchDataArray[seriesIndex] = batchData;
	
	  // The reason for locking here is the same as that of the producer task, in order to ensure that the judgment of the fullness of the blockingQueue is correctly synchronized.
	  synchronized (seriesReaderList.get(seriesIndex)) {
	    // Only when the blocking queue is not full, do we need to determine whether it is necessary to submit the producer task. This also guarantees that the producer task will be submitted if and only if the blocking queue is not full.
	    if (blockingQueueArray[seriesIndex].remainingCapacity() &gt; 0) {
	      ManagedSeriesReader reader = seriesReaderList.get(seriesIndex);、
	      // If the reader of the time series is not managed by the query manager (that is, the producer task exits because the queue is full), and there is still data in the reader, we need to submit the producer task of the time series again
	      if (!reader.isManagedByQueryManager() &amp;&amp; reader.hasRemaining()) {
	        reader.setManagedByQueryManager(true);
	        pool.submit(new ReadTask(reader, blockingQueueArray[seriesIndex]));
	      }
	    }
	  }
	}
}
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br></div></div><p>With the data for each time series, the next step is to align the data for each time stamp and assemble the results into a TSQueryDataSet to return.  The logic here is encapsulated in the fillBuffer () method. This method also contains the logic of limit and offset, and the format of the result set. We will not go into details here, but only analyze the process of data reading and time stamp alignment.</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// Fetch the current timestamp from the smallest heap
long minTime = timeHeap.pollFirst();
for (int seriesIndex = 0; seriesIndex &lt; seriesNum; seriesIndex++) {
	if (cachedBatchDataArray[seriesIndex] == null
	    || !cachedBatchDataArray[seriesIndex].hasCurrent()
	    || cachedBatchDataArray[seriesIndex].currentTime() != minTime) {
	  // The time series has no data at the current timestamp and is set to null
	  ...
	  
	} else {
	  // The time series has data at the current timestamp, and the data is formatted into a result set format
	  TSDataType type = cachedBatchDataArray[seriesIndex].getDataType();
	  ...
	  
	}
		
  // Move the batchdata cursor of this time series buffer back
  cachedBatchDataArray[seriesIndex].next();
	
  // If the currently cached batchdata is empty and the blocking queue still has data, call the fillCache () method again to fill the cache
  if (!cachedBatchDataArray[seriesIndex].hasCurrent()
      &amp;&amp; !noMoreDataInQueueArray[seriesIndex]) {
    fillCache(seriesIndex);
  }
	
  // Try to put the next timestamp of that time series into the smallest heap
  if (cachedBatchDataArray[seriesIndex].hasCurrent()) {
    long time = cachedBatchDataArray[seriesIndex].currentTime();
    timeHeap.add(time);
  }
}
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br></div></div><h2 id="no-value-filter-result-set-is-not-aligned-by-timestamp"><a href="#no-value-filter-result-set-is-not-aligned-by-timestamp" class="header-anchor">#</a> No value filter + result set is not aligned by timestamp</h2> <h3 id="org-apache-iotdb-db-query-dataset-nonalignenginedataset"><a href="#org-apache-iotdb-db-query-dataset-nonalignenginedataset" class="header-anchor">#</a> org.apache.iotdb.db.query.dataset.NonAlignEngineDataSet</h3> <p><code>NonAlignEngineDataSet</code> implements query logic that has no value filtering conditions and does not need to be aligned by timestamp.  The query logic here is similar to RawQueryDataSetWithoutValueFilter, but its consumer logic is simpler, because it does not need to perform timestamp alignment.  And each producer task can also do more work, not only can take out BatchData from Reader, but can further say that the taken out BatchData is formatted into the output required by the result set, thereby improving the parallelism of the program.  In this way, the consumer only needs to fetch data from each blocking queue and set it into the corresponding position of TSQueryNonAlignDataSet.</p> <p>The specific query logic is not repeated here. You can refer to the query logic analysis of RawQueryDataSetWithoutValueFilter.</p> <h2 id="include-value-filter-result-set-aligned-by-timestamp"><a href="#include-value-filter-result-set-aligned-by-timestamp" class="header-anchor">#</a> Include value filter + result set aligned by timestamp</h2> <h3 id="org-apache-iotdb-db-query-dataset-enginedatasetwithvaluefilter"><a href="#org-apache-iotdb-db-query-dataset-enginedatasetwithvaluefilter" class="header-anchor">#</a> org.apache.iotdb.db.query.dataset.EngineDataSetWithValueFilter</h3> <p><code>EngineDataSetWithValueFilter</code> implements query logic with value filter conditions.</p> <p>Its query logic is to first generate a timestamp that meets the filtering conditions according to the query conditions, query the value of the projection column by the timestamp that meets the conditions, and then return the result set.  It has four fields</p> <ul><li><p>private EngineTimeGenerator timeGenerator;</p> <p>Is used to generate timestamps that satisfy the filter</p></li> <li><p>private List&lt;IReaderByTimestamp&gt; seriesReaderByTimestampList;</p> <p>Reader for each time series, used to get data based on timestamp</p></li> <li><p>private boolean hasCachedRowRecord;</p> <p>Whether data rows are currently cached</p></li> <li><p>private RowRecord cachedRowRecord;</p> <p>Data lines currently cached</p></li></ul> <p>Its main query logic is encapsulated in the <code>cacheRowRecord ()</code> method. For detailed analysis, see the comments in the code.</p> <h4 id="cacherowrecord"><a href="#cacherowrecord" class="header-anchor">#</a> cacheRowRecord()</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>private boolean cacheRowRecord() throws IOException {
   // Determine if there is a next eligible timestamp
	while (timeGenerator.hasNext()) {
	  boolean hasField = false;
	  // Get the current eligible timestamp
	  long timestamp = timeGenerator.next();
	  RowRecord rowRecord = new RowRecord(timestamp);
	  for (int i = 0; i &lt; seriesReaderByTimestampList.size(); i++) {
	    // Root to get the value under the current timestamp of each time series
	    IReaderByTimestamp reader = seriesReaderByTimestampList.get(i);
	    Object value = reader.getValueInTimestamp(timestamp);
	    // Null if the time series has no value under the current timestamp
	    if (value == null) {
	      rowRecord.addField(null);
	    } 
	    // Otherwise set hasField to true
	    else {
	      hasField = true;
	      rowRecord.addField(value, dataTypes.get(i));
	    }
	  }
	  // If there is a value in any time series under the timestamp, it means that the timestamp is valid, and the data line is cached
	  if (hasField) {
	    hasCachedRowRecord = true;
	    cachedRowRecord = rowRecord;
	    break;
	  }
	}
	return hasCachedRowRecord;
}
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br></div></div></div> <div class="page-nav"><p class="inner"><span class="prev">
        ←
        <a href="/SystemDesign/DataQuery/SeriesReader.html" class="prev">
          SeriesReader
        </a></span> <span class="next"><a href="/SystemDesign/DataQuery/AggregationQuery.html">
          AggregationQuery
        </a>
        →
      </span></p></div> <p style="text-align: center;">Copyright © 2020 The Apache Software Foundation.<br>
     Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p> <p style="text-align:justify!important;paddingLeft:10px;paddingRight:10px;">
      Disclaimer: Apache IoTDB (incubating) is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
  </p></main></div><div class="global-ui"></div></div>
    <script src="/assets/js/app.882d9a07.js" defer></script><script src="/assets/js/3.1dc302ea.js" defer></script><script src="/assets/js/38.7ed5f5d7.js" defer></script>
  </body>
</html>