blob: 41ab1789f6bfde85501e10924d818504b8477483 [file] [log] [blame]
<!DOCTYPE html>
<html lang="zh-CN">
<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/198.2b7feb5b.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/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/38.7ed5f5d7.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="/zh/" 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">文档</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/zh/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="/zh/SystemDesign/Architecture/Architecture.html" class="nav-link">系统设计</a></div><div class="nav-item"><a href="/zh/Download/" class="nav-link">下载</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">社区</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="/zh/Community/Community-Project Committers.html" class="nav-link">开发人员</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Powered By.html" class="nav-link">技术支持</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</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">
基金会
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
许可证
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
安全
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
赞助
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
致谢
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
活动
<!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/DataQuery/RawDataQuery.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">简体中文</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">文档</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/zh/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="/zh/SystemDesign/Architecture/Architecture.html" class="nav-link">系统设计</a></div><div class="nav-item"><a href="/zh/Download/" class="nav-link">下载</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">社区</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="/zh/Community/Community-Project Committers.html" class="nav-link">开发人员</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Powered By.html" class="nav-link">技术支持</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</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">
基金会
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
许可证
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
安全
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
赞助
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
致谢
<!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
活动
<!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/DataQuery/RawDataQuery.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">简体中文</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>系统设计</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>应用概览</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>查询引擎</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>元数据管理</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>存储引擎</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>数据查询</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/zh/SystemDesign/DataQuery/DataQuery.html" class="sidebar-link">数据查询</a></li><li><a href="/zh/SystemDesign/DataQuery/QueryFundamentals.html" class="sidebar-link">查询基础介绍</a></li><li><a href="/zh/SystemDesign/DataQuery/SeriesReader.html" class="sidebar-link">查询基础组件</a></li><li><a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" aria-current="page" class="active sidebar-link">原始数据查询</a></li><li><a href="/zh/SystemDesign/DataQuery/AggregationQuery.html" class="sidebar-link">聚合查询</a></li><li><a href="/zh/SystemDesign/DataQuery/GroupByQuery.html" class="sidebar-link">降采样查询</a></li><li><a href="/zh/SystemDesign/DataQuery/LastQuery.html" class="sidebar-link">最近时间戳 Last 查询</a></li><li><a href="/zh/SystemDesign/DataQuery/AlignByDeviceQuery.html" class="sidebar-link">按设备对齐查询</a></li><li><a href="/zh/SystemDesign/DataQuery/FillFunction.html" class="sidebar-link">空值填充</a></li><li><a href="/zh/SystemDesign/DataQuery/GroupByFillQuery.html" class="sidebar-link">降采样补空值查询</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>工具</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>连接器</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>客户端</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="原始数据查询"><a href="#原始数据查询" class="header-anchor">#</a> 原始数据查询</h1> <h2 id="设计原理"><a href="#设计原理" class="header-anchor">#</a> 设计原理</h2> <p>原始数据查询根据是否包含值过滤条件,可以分为两类。不包含值过滤条件时,根据结果集结构又可分为两类。</p> <ul><li>不包含值过滤条件(无过滤条件 or 仅包含时间过滤条件)
<ul><li>结果集按时间戳对齐(默认原始数据查询)</li> <li>结果集不按时间戳对齐(disable align)</li></ul></li> <li>包含值过滤条件
<ul><li>结果集按时间戳对齐</li></ul></li></ul> <p>以上三种查询在代码中对应三种不同的 DataSet,封装了这三种查询的执行逻辑。</p> <h2 id="不包含值过滤条件-结果集按时间戳对齐"><a href="#不包含值过滤条件-结果集按时间戳对齐" class="header-anchor">#</a> 不包含值过滤条件 + 结果集按时间戳对齐</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>实现了没有值过滤条件,且需要按照时间戳对齐的查询逻辑。虽然最后的查询结果需要每个时间序列按照时间戳对齐,但是每个时间序列的查询是可以做并行化的。这里借助消费者-生产者队列的思想,将每个时间序列获取数据的操作与最后对所有时间序列进行对齐的操作解耦。每个时间序列对应一个生产者线程,且有其对应的<code>BlockingQueue</code>,生产者任务负责读取相应的时间序列的数据放进<code>BlockingQueue</code>中;消费者线程只有一个,负责从每个时间序列的<code>BlockingQueue</code>中取出数据,进行时间戳对齐之后,将结果组装成<code>TSQueryDataSet</code>形式返回。</p> <p>在具体实现的时候,考虑到机器的资源限制,并非为每个查询的每一个时间序列创建一个线程,而是采用线程池技术,将每一个时间序列的生产者任务当作一个<code>Runnable</code>的task提交到线程池中执行。</p> <p>下面就先介绍生产者的代码,它被封装在是<code>RawQueryDataSetWithoutValueFilter</code>的一个内部类<code>ReadTask</code>中,实现了<code>Runnable</code>接口。</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>中有两个字段</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> private final ManagedSeriesReader reader;
private BlockingQueue&lt;BatchData&gt; blockingQueue;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><p><code>ManagedSeriesReader</code>接口继承了<code>IBatchReader</code>接口,主要用来读取单个时间序列的数据,并且新增了以下四个方法</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>前两个方法用以表征该时间序列对应的生产者任务有没有被查询管理器所管理,即生产者任务有没有因为阻塞队列满了,而自行退出(后文会解释为什么不阻塞等待,而是直接退出);后两个方法用以表征该时间序列对应的reader里还有没有数据。</p> <p><code>blockingQueue</code>就是该生产者任务的阻塞队列,实际上该阻塞队列只会在消费者取数据时单边阻塞,生产者放数据时,如果发现队列满了,便会直接退出,不会阻塞。</p> <p>下面看一下<code>ReadTask</code><code>run()</code>方法,执行流程的解释以注释的形式展现在代码中</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 {
// 这里加锁的原因是为了保证对于blockingQueue满不满的判断是正确同步的
synchronized (reader) {
// 由于每次提交生产者任务时(不论是生产者自己递归的提交自己,还是消费者发现生产者任务自行退出而提交的),都会检查队列是不是满的,如果队列满了,是不会提交生产者任务的
// 所以生产者任务一旦被提交,blockingQueue里一定是有空余位置的,我们不需要检查队列是否满
// 如果时间序列对应的reader还有数据,进入循环体
while (reader.hasNextBatch()) {
BatchData batchData = reader.nextBatch();
// 由于拿到的BatchData有可能为空,所以需要一直迭代到第一个不为空的BatchData
if (batchData.isEmpty()) {
continue;
}
// 将不为空的batchData放进阻塞队列中,此时的阻塞队列一定是不满的,所以不会阻塞
blockingQueue.put(batchData);
// 如果阻塞队列仍然没有满,生产者任务再次向线程池里递归地提交自己,进行下一个batchData的获取
if (blockingQueue.remainingCapacity() &gt; 0) {
pool.submit(this);
}
// 如果阻塞队列满了,生产者任务退出,并将对应reader的managedByQueryManager置为false
else {
reader.setManagedByQueryManager(false);
}
return;
}
// 代码执行到这边,代表之前的while循环条件不满足,即该时间序列对应的reader里没有数据了
// 我们往阻塞队列里放入一个SignalBatchData,用以告知消费者,这个时间序列已经没有数据了,不需要再从该时间序列对应的队列里取数据了
blockingQueue.put(SignalBatchData.getInstance());
// 将reader的hasRemaining字段置为false
// 通知消费者不需要再为这个时间序列提交生产者任务
reader.setHasRemaining(false);
// 将reader的managedByQueryManager字段置为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>接下来介绍消费者的代码,消费者的主要逻辑是从每个时间序列的队列里拿出值,做时间戳对齐,然后拼凑结果集。时间戳的对齐主要通过一个时间戳的最小堆来实现,如果该时间序列的时间戳等于堆顶的时间戳,则取出该值,反之,将该时间戳下该时间序列的值置为<code>null</code></p> <p>先介绍消费者任务的一些重要字段</p> <ul><li><div class="language- line-numbers-mode"><pre class="language-text"><code>TreeSet&lt;Long&gt; timeHeap
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>时间戳的最小堆,用以实现时间戳对齐操作</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>BlockingQueue&lt;BatchData&gt;[] blockingQueueArray;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>阻塞队列的数组,用以存储每个时间序列对应的阻塞队列</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>boolean[] noMoreDataInQueueArray
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>用以表征某个时间序列的阻塞队列里还有没有值,如果为false,则消费者不会再去调用<code>take()</code>方法,以防消费者线程被阻塞。</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>BatchData[] cachedBatchDataArray
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>缓存从阻塞队列里取出的一个BatchData,因为阻塞队列里<code>take()</code>出的<code>BatchData</code>并不能一次性消费完,所以需要做缓存</p></li></ul> <p>在消费者<code>RawQueryDataSetWithoutValueFilter</code>的构造函数里首先调用了<code>init()</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;();
// 为每个时间序列构建生产者任务
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]));
}
// 初始化最小堆,填充每个时间序列对应的缓存
for (int i = 0; i &lt; seriesReaderList.size(); i++) {
// 调用fillCache(int)方法填充缓存
fillCache(i);
// 尝试将每个时间序列的当前最小时间戳放进堆中
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>该方法负责从阻塞队列中取出数据,并填充缓存,具体逻辑见下文注释</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>private void fillCache(int seriesIndex) throws InterruptedException {
// 从阻塞队列中拿数据,如果没有数据,则会阻塞等待队列中有数据
BatchData batchData = blockingQueueArray[seriesIndex].take();
// 如果是一个信号BatchData,则将相应时间序列的oMoreDataInQueue置为false
if (batchData instanceof SignalBatchData) {
noMoreDataInQueueArray[seriesIndex] = true;
}
else {
// 将取出的BatchData放进cachedBatchDataArray缓存起来
cachedBatchDataArray[seriesIndex] = batchData;
// 这里加锁的原因与生产者任务那边一样,是为了保证对于blockingQueue满不满的判断是正确同步的
synchronized (seriesReaderList.get(seriesIndex)) {
// 只有当阻塞队列不满的时候,我们才需要判断是不是需要提交生产者任务,这里也保证了生产者任务会被提交,当且仅当阻塞队列不满
if (blockingQueueArray[seriesIndex].remainingCapacity() &gt; 0) {
ManagedSeriesReader reader = seriesReaderList.get(seriesIndex);、
// 如果该时间序列的reader并没有被查询管理器管理(即生产者任务由于队列满了,自行退出),并且该reader里还有数据,我们需要再次提交该时间序列的生产者任务
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>有了每个时间序列的数据,接下来就是将每个时间戳的数据做对齐,并将结果组装成<code>TSQueryDataSet</code>返回。这里的逻辑封装在<code>fillBuffer()</code>方法中,该方法里还包含了<code>limit</code><code>offset</code>,以及格式化结果集的逻辑,对此我们不作赘述,只分析其中数据读取和时间戳对齐的流程。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 从最小堆中取出当前时间戳
long minTime = timeHeap.pollFirst();
for (int seriesIndex = 0; seriesIndex &lt; seriesNum; seriesIndex++) {
if (cachedBatchDataArray[seriesIndex] == null
|| !cachedBatchDataArray[seriesIndex].hasCurrent()
|| cachedBatchDataArray[seriesIndex].currentTime() != minTime) {
// 该时间序列在当前时间戳没有数据,置为null
...
} else {
// 该时间序列在当前时间戳有数据,将该数据格式化成结果集格式
TSDataType type = cachedBatchDataArray[seriesIndex].getDataType();
...
}
// 将该时间序列缓存的batchdata游标向后移
cachedBatchDataArray[seriesIndex].next();
// 如果当前缓存的batchdata为空,并且阻塞队列依然有数据,则再次调用fillCache()方法填充缓存
if (!cachedBatchDataArray[seriesIndex].hasCurrent()
&amp;&amp; !noMoreDataInQueueArray[seriesIndex]) {
fillCache(seriesIndex);
}
// 尝试将该时间序列的下一个时间戳放进最小堆中
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="不包含值过滤条件-结果集不按时间戳对齐"><a href="#不包含值过滤条件-结果集不按时间戳对齐" class="header-anchor">#</a> 不包含值过滤条件 + 结果集不按时间戳对齐</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>实现了没有值过滤条件,且不需要按照时间戳对齐的查询逻辑。这里的查询逻辑跟<code>RawQueryDataSetWithoutValueFilter</code>很类似,但是它的消费者逻辑更为简单,因为不需要做时间戳对齐的操作。并且每个生产者任务中也可以做更多的工作,不仅可以从Reader中取出BatchData,还可以进一步讲取出的BatchData格式化为结果集需要的输出,从而提高了程序的并行度。如此,消费者只需要从每个阻塞队列里取出数据,set进<code>TSQueryNonAlignDataSet</code>相应的位置即可。</p> <p>具体的查询逻辑,在此就不再赘述了,可以参照<code>RawQueryDataSetWithoutValueFilter</code>的查询逻辑分析。</p> <h2 id="包含值过滤条件-结果集按时间戳对齐"><a href="#包含值过滤条件-结果集按时间戳对齐" class="header-anchor">#</a> 包含值过滤条件 + 结果集按时间戳对齐</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>实现了有值过滤条件的查询逻辑。</p> <p>它的查询逻辑是,首先根据查询条件生成满足过滤条件的时间戳,通过满足条件的时间戳查询投影列的值,然后返回结果集。它有四个字段</p> <ul><li><div class="language- line-numbers-mode"><pre class="language-text"><code>private EngineTimeGenerator timeGenerator;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>是用来生成满足过滤条件的时间戳的</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>private List&lt;IReaderByTimestamp&gt; seriesReaderByTimestampList;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>每个时间序列对应的reader,用来根据时间戳获取数据</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>private boolean hasCachedRowRecord;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>当前是否缓存了数据行</p></li> <li><div class="language- line-numbers-mode"><pre class="language-text"><code>private RowRecord cachedRowRecord;
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>当前缓存的数据行</p></li></ul> <p>它的主要查询逻辑封装在<code>cacheRowRecord()</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 {
// 判断有没有下一个符合条件的时间戳
while (timeGenerator.hasNext()) {
boolean hasField = false;
// 获得当前符合条件的时间戳
long timestamp = timeGenerator.next();
RowRecord rowRecord = new RowRecord(timestamp);
for (int i = 0; i &lt; seriesReaderByTimestampList.size(); i++) {
// 根获得每个时间序列当前时间戳下的value
IReaderByTimestamp reader = seriesReaderByTimestampList.get(i);
Object value = reader.getValueInTimestamp(timestamp);
// 如果该时间序列在当前时间戳下没有值,则置null
if (value == null) {
rowRecord.addField(null);
}
// 否则将hasField置为true
else {
hasField = true;
rowRecord.addField(value, dataTypes.get(i));
}
}
// 如果该时间戳下,任何一个时间序列有值,则表示该时间戳有效,缓存该数据行
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="/zh/SystemDesign/DataQuery/SeriesReader.html" class="prev">
查询基础组件
</a></span> <span class="next"><a href="/zh/SystemDesign/DataQuery/AggregationQuery.html">
聚合查询
</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/198.2b7feb5b.js" defer></script>
</body>
</html>