| <!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/199.246f826f.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/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/SeriesReader.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/SeriesReader.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/SeriesReader.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/DataQuery/SeriesReader.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" aria-current="page" class="active sidebar-link">查询基础组件</a></li><li><a href="/zh/SystemDesign/DataQuery/RawDataQuery.html" class="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>IoTDB server 模块共提供 3 种不同形式的针对单个时间序列的读取接口，以支持不同形式的查询。</p> <ul><li>原始数据查询接口，返回 BatchData，可带时间过滤条件或值过滤条件，两种过滤不可同时存在。</li> <li>聚合查询接口 （主要用于聚合查询和降采样查询）</li> <li>按递增时间戳查询对应值的接口（主要用于带值过滤的查询）</li></ul> <h2 id="相关接口"><a href="#相关接口" class="header-anchor">#</a> 相关接口</h2> <p>以上三种读取单个时间序列数据的方式对应代码里的三个接口</p> <h3 id="org-apache-iotdb-tsfile-read-reader-ibatchreader"><a href="#org-apache-iotdb-tsfile-read-reader-ibatchreader" class="header-anchor">#</a> org.apache.iotdb.tsfile.read.reader.IBatchReader</h3> <h4 id="主要方法"><a href="#主要方法" class="header-anchor">#</a> 主要方法</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 判断是否还有 BatchData |
| boolean hasNextBatch() throws IOException; |
| |
| // 获得下一个 BatchData，并把游标后移 |
| BatchData nextBatch() throws IOException; |
| </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></div></div><h4 id="使用流程"><a href="#使用流程" class="header-anchor">#</a> 使用流程</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>while (batchReader.hasNextBatch()) { |
| BatchData batchData = batchReader.nextBatch(); |
| |
| // use batchData to do some work |
| ... |
| } |
| </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></div></div><h3 id="org-apache-iotdb-db-query-reader-series-iaggregatereader"><a href="#org-apache-iotdb-db-query-reader-series-iaggregatereader" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.series.IAggregateReader</h3> <h4 id="主要方法-2"><a href="#主要方法-2" class="header-anchor">#</a> 主要方法</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 判断是否还有 Chunk |
| boolean hasNextChunk() throws IOException; |
| |
| // 判断是否能够使用当前 Chunk 的统计信息 |
| boolean canUseCurrentChunkStatistics(); |
| |
| // 获得当前 Chunk 的统计信息 |
| Statistics currentChunkStatistics(); |
| |
| // 跳过当前 Chunk |
| void skipCurrentChunk(); |
| |
| // 判断当前Chunk是否还有下一个 Page |
| boolean hasNextPage() throws IOException; |
| |
| // 判断能否使用当前 Page 的统计信息 |
| boolean canUseCurrentPageStatistics() throws IOException; |
| |
| // 获得当前 Page 的统计信息 |
| Statistics currentPageStatistics() throws IOException; |
| |
| // 跳过当前的 Page |
| void skipCurrentPage(); |
| |
| // 获得当前 Page 的数据 |
| BatchData nextPage() throws IOException; |
| </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></div></div><h4 id="一般使用流程"><a href="#一般使用流程" class="header-anchor">#</a> 一般使用流程</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>while (aggregateReader.hasNextChunk()) { |
| if (aggregateReader.canUseCurrentChunkStatistics()) { |
| Statistics chunkStatistics = aggregateReader.currentChunkStatistics(); |
| |
| // 用 chunk 层的统计信息计算 |
| ... |
| |
| aggregateReader.skipCurrentChunk(); |
| continue; |
| } |
| |
| // 把当前 chunk 中的 page 消耗完 |
| while (aggregateReader.hasNextPage()) { |
| if (aggregateReader.canUseCurrentPageStatistics()) { |
| // 可以用统计信息 |
| Statistics pageStatistic = aggregateReader.currentPageStatistics(); |
| |
| // 用 page 层的统计信息计算 |
| ... |
| |
| aggregateReader.skipCurrentPage(); |
| continue; |
| } else { |
| // 不能用统计信息，需要用数据计算 |
| BatchData batchData = aggregateReader.nextOverlappedPage(); |
| |
| // 用 batchData 计算 |
| ... |
| } |
| } |
| } |
| </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><h3 id="org-apache-iotdb-db-query-reader-ireaderbytimestamp"><a href="#org-apache-iotdb-db-query-reader-ireaderbytimestamp" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.IReaderByTimestamp</h3> <h4 id="主要方法-3"><a href="#主要方法-3" class="header-anchor">#</a> 主要方法</h4> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 得到给定时间戳的值，如果不存在返回 null（要求传入的 timestamp 是递增的） |
| Object getValueInTimestamp(long timestamp) throws IOException; |
| |
| // 给定一批递增时间戳的值，返回一批结果（减少方法调用次数） |
| Object[] getValuesInTimestamps(long[] timestamps) throws IOException; |
| </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></div></div><h4 id="一般使用流程-2"><a href="#一般使用流程-2" class="header-anchor">#</a> 一般使用流程</h4> <p>该接口在带值过滤的查询中被使用，TimeGenerator生成时间戳后，使用该接口获得该时间戳对应的value</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>Object value = readerByTimestamp.getValueInTimestamp(timestamp); |
| |
| or |
| |
| Object[] values = readerByTimestamp.getValueInTimestamp(timestamps); |
| </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></div></div><h2 id="具体实现类"><a href="#具体实现类" class="header-anchor">#</a> 具体实现类</h2> <p>上述三个接口都有其对应的实现类，由于以上三种查询有共性，我们设计了一个基础的 SeriesReader 工具类，封装了对于一个时间序列读取操作的基本方法，帮助实现以上三种接口。下面首先介绍 SeriesReader 的设计原理，然后再依次介绍三个接口的具体实现。</p> <h3 id="org-apache-iotdb-db-query-reader-series-seriesreader"><a href="#org-apache-iotdb-db-query-reader-series-seriesreader" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.series.SeriesReader</h3> <h4 id="设计思想"><a href="#设计思想" class="header-anchor">#</a> 设计思想</h4> <p>背景知识：TsFile 文件（TsFileResource）解开后可以得到 ChunkMetadata，ChunkMetadata 解开后可以得到一堆 PageReader，PageReader 可以直接返回 BatchData 数据点。</p> <p>为了支持以上三种接口</p> <p>数据按照粒度从大到小分成四种：文件，Chunk，Page，相交数据点。在原始数据查询中，最大的数据块返回粒度是一个 page，如果一个 page 和其他 page 由于乱序写入相互覆盖了，就解开成数据点做合并。聚合查询中优先使用 Chunk 的统计信息，其次是 Page 的统计信息，最后是相交数据点。</p> <p>设计原则是能用粒度大的就不用粒度小的。</p> <p>首先介绍一下SeriesReader里的几个重要字段</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> |
| /* |
| * 文件层 |
| */ |
| private final List<TsFileResource> seqFileResource; |
| 顺序文件列表，因为顺序文件本身就保证有序，且时间戳互不重叠，只需使用List进行存储 |
| |
| private final PriorityQueue<TsFileResource> unseqFileResource; |
| 乱序文件列表，因为乱序文件互相之间不保证顺序性，且可能有重叠，为了保证顺序，使用优先队列进行存储 |
| |
| /* |
| * chunk 层 |
| * |
| * 三个字段之间数据永远不重复，first 永远是第一个（开始时间最小） |
| */ |
| private ChunkMetaData firstChunkMetaData; |
| 填充 chunk 层时优先填充此字段，保证这个 chunk 具有当前最小开始时间 |
| |
| private final List<ChunkMetaData> seqChunkMetadatas; |
| 顺序文件解开后得到的 ChunkMetaData 存放在此，本身有序且互不重叠，所以使用 List 存储 |
| |
| private final PriorityQueue<ChunkMetaData> unseqChunkMetadatas; |
| 乱序文件解开后得到的 ChunkMetaData 存放在此，互相之间可能有重叠，为了保证顺序，使用优先队列进行存储 |
| |
| /* |
| * page 层 |
| * |
| * 两个字段之间数据永远不重复，first 永远是第一个（开始时间最小） |
| */ |
| private VersionPageReader firstPageReader; |
| 开始时间最小的 page reader |
| |
| private PriorityQueue<VersionPageReader> cachedPageReaders; |
| 当前获得的所有 page reader，按照每个 page 的起始时间进行排序 |
| |
| /* |
| * 相交数据点层 |
| */ |
| private PriorityMergeReader mergeReader; |
| 本质上是多个带优先级的 page，按时间戳从低到高输出数据点，时间戳相同时，保留优先级高的 |
| |
| /* |
| * 相交数据点产出结果的缓存 |
| */ |
| private boolean hasCachedNextOverlappedPage; |
| 是否缓存了下一个batch |
| |
| private BatchData cachedBatchData; |
| 缓存的下一个batch的引用 |
| </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><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br></div></div><p>下面介绍一下SeriesReader里的重要方法</p> <h4 id="hasnextchunk"><a href="#hasnextchunk" class="header-anchor">#</a> hasNextChunk()</h4> <ul><li><p>主要功能：判断该时间序列还有没有下一个chunk。</p></li> <li><p>约束：在调用这个方法前，需要保证 <code>SeriesReader</code> 内已经没有 page 和 数据点 层级的数据了，也就是之前解开的 chunk 都消耗完了。</p></li> <li><p>实现：如果 <code>firstChunkMetaData</code> 不为空，则代表当前已经缓存了第一个 <code>ChunkMetaData</code>，且未被使用，直接返回<code>true</code>；</p> <p>尝试去解开第一个顺序文件和第一个乱序文件，填充 chunk 层。并解开与 <code>firstChunkMetadata</code> 相重合的所有文件。</p></li></ul> <h4 id="ischunkoverlapped"><a href="#ischunkoverlapped" class="header-anchor">#</a> isChunkOverlapped()</h4> <ul><li><p>主要功能：判断当前的 chunk 有没有与其他 Chunk 有重叠</p></li> <li><p>约束：在调用这个方法前，需要保证 chunk 层已经缓存了 <code>firstChunkMetadata</code>，也就是调用了 hasNextChunk() 并且为 true。</p></li> <li><p>实现：直接把 <code>firstChunkMetadata</code> 与 <code>seqChunkMetadatas</code> 和 <code>unseqChunkMetadatas</code> 相比较。因为此前已经保证所有和 <code>firstChunkMetadata</code> 相交的文件都被解开了。</p></li></ul> <h4 id="currentchunkstatistics"><a href="#currentchunkstatistics" class="header-anchor">#</a> currentChunkStatistics()</h4> <p>返回 <code>firstChunkMetaData</code> 的统计信息。</p> <h4 id="skipcurrentchunk"><a href="#skipcurrentchunk" class="header-anchor">#</a> skipCurrentChunk()</h4> <p>跳过当前 chunk。只需要将<code>firstChunkMetaData</code>置为<code>null</code>。</p> <h4 id="hasnextpage"><a href="#hasnextpage" class="header-anchor">#</a> hasNextPage()</h4> <ul><li><p>主要功能：判断 SeriesReader 中还有没有已经解开的 page，如果有相交的 page，就构造 <code>cachedBatchData</code> 并缓存，否则缓存 <code>firstPageReader</code>。</p></li> <li><p>实现：如果已经缓存了 <code>cachedBatchData</code> 就直接返回。如果有相交数据点，就构造 <code>cachedBatchData</code>。如果已经缓存了 <code>firstPageReader</code>，就直接返回。</p> <p>如果当前的 <code>firstChunkMetadata</code> 还没有解开，就解开与之重叠的所有 ChunkMetadata，构造 firstPageReader。</p> <p>判断，如果 <code>firstPageReader</code> 和 <code>cachedPageReaders</code> 相交，则构造 <code>cachedBatchData</code>，否则直接返回。</p></li></ul> <h4 id="ispageoverlapped"><a href="#ispageoverlapped" class="header-anchor">#</a> isPageOverlapped()</h4> <ul><li><p>主要功能：判断当前的 page 有没有与其他 page 有重叠</p></li> <li><p>约束：在调用这个方法前，需要保证调用了 hasNextPage() 并且为 true。也就是，有可能缓存了一个相交的 <code>cachedBatchData</code>，或者缓存了不相交的 <code>firstPageReader</code>。</p></li> <li><p>实现：先判断有没有 <code>cachedBatchData</code>，如果没有，就说明当前 page 不相交，则 <code>mergeReader</code> 里没数据。再判断 <code>firstPageReader</code> 是否与 <code>cachedPageReaders</code> 中的 page 相交。</p></li></ul> <h4 id="currentpagestatistics"><a href="#currentpagestatistics" class="header-anchor">#</a> currentPageStatistics()</h4> <p>返回 <code>firstPageReader</code> 的统计信息。</p> <h4 id="skipcurrentpage"><a href="#skipcurrentpage" class="header-anchor">#</a> skipCurrentPage()</h4> <p>跳过当前Page。只需要将 <code>firstPageReader</code> 置为 null。</p> <h4 id="nextpage"><a href="#nextpage" class="header-anchor">#</a> nextPage()</h4> <ul><li><p>主要功能：返回下一个相交或不想交的 page</p></li> <li><p>约束：在调用这个方法前，需要保证调用了 hasNextPage() 并且为 true。也就是，有可能缓存了一个相交的 <code>cachedBatchData</code>，或者缓存了不相交的 <code>firstPageReader</code>。</p></li> <li><p>实现：如果 <code>hasCachedNextOverlappedPage</code> 为 true，说明缓存了一个相交的 page，直接返回 <code>cachedBatchData</code>。否则当前 page 不相交，直接从 firstPageReader 里拿当前 page 的数据。</p></li></ul> <h4 id="hasnextoverlappedpage"><a href="#hasnextoverlappedpage" class="header-anchor">#</a> hasNextOverlappedPage()</h4> <ul><li><p>主要功能：内部方法，用来判断当前有没有重叠的数据，并且构造相交的 page 并缓存。</p></li> <li><p>实现：如果 <code>hasCachedNextOverlappedPage</code> 为 <code>true</code>，直接返回 <code>true</code>。</p> <p>否则，先调用 <code>tryToPutAllDirectlyOverlappedPageReadersIntoMergeReader()</code> 方法，将 <code>cachedPageReaders</code> 中所有与 <code>firstPageReader</code> 有重叠的放进 <code>mergeReader</code> 里。<code>mergeReader</code> 里维护了一个 <code>currentLargestEndTime</code> 变量，每次添加进新的 Reader 时被更新，用以记录当前添加进 <code>mergeReader</code> 的 page 的最大结束时间。 |
| 然后先从<code>mergeReader</code>里取出当前最大的结束时间，作为第一批数据的结束时间，记为<code>currentPageEndTime</code>。接着去遍历<code>mergeReader</code>，直到当前的时间戳大于<code>currentPageEndTime</code>。</p> <p>每从 mergeReader 移出一个点前，我们先要判断是否有与当前时间戳重叠的file或者chunk或者page（这里之所以还要再做一次判断，是因为，比如当前page是1-30，和他直接相交的page是20-50，还有一个page是40-60，每取一个点判断一次是想把40-60解开），如果有，解开相应的file或者chunk或者page，并将其放入<code>mergeReader</code>。完成重叠的判断后，从<code>mergeReader</code>中取出相应数据。</p> <p>完成迭代后将获得数据缓存在 <code>cachedBatchData</code> 中，并将 <code>hasCachedNextOverlappedPage</code> 置为 <code>true</code>。</p></li></ul> <h4 id="nextoverlappedpage"><a href="#nextoverlappedpage" class="header-anchor">#</a> nextOverlappedPage()</h4> <p>将缓存的<code>cachedBatchData</code>返回，并将<code>hasCachedNextOverlappedPage</code>置为<code>false</code>。</p> <h3 id="org-apache-iotdb-db-query-reader-series-seriesrawdatabatchreader"><a href="#org-apache-iotdb-db-query-reader-series-seriesrawdatabatchreader" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.series.SeriesRawDataBatchReader</h3> <p><code>SeriesRawDataBatchReader</code>实现了<code>IBatchReader</code>。</p> <p>其方法<code>hasNextBatch()</code>的核心判断流程是</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 有缓存了 batch，直接返回 |
| if (hasCachedBatchData) { |
| return true; |
| } |
| |
| /* |
| * 如果 SeriesReader 里还有 page，返回 page |
| */ |
| if (readPageData()) { |
| hasCachedBatchData = true; |
| return true; |
| } |
| |
| /* |
| * 如果有 chunk，并且有 page，返回 page |
| */ |
| while (seriesReader.hasNextChunk()) { |
| if (readPageData()) { |
| hasCachedBatchData = true; |
| return true; |
| } |
| } |
| return hasCachedBatchData; |
| </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></div></div><h3 id="org-apache-iotdb-db-query-reader-series-seriesreaderbytimestamp"><a href="#org-apache-iotdb-db-query-reader-series-seriesreaderbytimestamp" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.series.SeriesReaderByTimestamp</h3> <p><code>SeriesReaderByTimestamp</code> 实现了 <code>IReaderByTimestamp</code>。</p> <p>设计思想：当给一个时间戳要查询值时，这个时间戳可以转化为一个 time >= x 的过滤条件。不断更新这个过滤条件，并且跳过不满足的文件，chunk 和 page。</p> <p>实现方式：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>/* |
| * 优先判断下一个 page 有没有当前所查时间，能跳过就跳过 |
| */ |
| if (readPageData(timestamp)) { |
| return true; |
| } |
| |
| /* |
| * 判断下一个 chunk 有没有当前所查时间，能跳过就跳过 |
| */ |
| while (seriesReader.hasNextChunk()) { |
| Statistics statistics = seriesReader.currentChunkStatistics(); |
| if (!satisfyTimeFilter(statistics)) { |
| seriesReader.skipCurrentChunk(); |
| continue; |
| } |
| /* |
| * chunk 不能跳过，继续到 chunk 里检查 page |
| */ |
| if (readPageData(timestamp)) { |
| return true; |
| } |
| } |
| return false; |
| </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></div></div><h3 id="org-apache-iotdb-db-query-reader-series-seriesaggregatereader"><a href="#org-apache-iotdb-db-query-reader-series-seriesaggregatereader" class="header-anchor">#</a> org.apache.iotdb.db.query.reader.series.SeriesAggregateReader</h3> <p><code>SeriesAggregateReader</code> 实现了 <code>IAggregateReader</code></p> <p><code>IAggregateReader</code>的大部分接口方法都在<code>SeriesReader</code>有对应实现，除了<code>canUseCurrentChunkStatistics()</code>和<code>canUseCurrentPageStatistics()</code>两个方法。</p> <h4 id="canusecurrentchunkstatistics"><a href="#canusecurrentchunkstatistics" class="header-anchor">#</a> canUseCurrentChunkStatistics()</h4> <p>设计思想：可以用统计信息的条件是当前 chunk 不重叠，并且满足过滤条件。</p> <p>先调用<code>SeriesReader</code>的<code>currentChunkStatistics()</code>方法，获得当前chunk的统计信息，再调用<code>SeriesReader</code>的<code>isChunkOverlapped()</code>方法判断当前chunk是否重叠，如果当前chunk不重叠，且其统计信息满足过滤条件，则返回<code>true</code>，否则返回<code>false</code>。</p> <h4 id="canusecurrentpagestatistics"><a href="#canusecurrentpagestatistics" class="header-anchor">#</a> canUseCurrentPageStatistics()</h4> <p>设计思想：可以用统计信息的条件是当前 page 不重叠，并且满足过滤条件。</p> <p>先调用<code>SeriesReader</code>的 <code>currentPageStatistics()</code> 方法，获得当前page的统计信息，再调用<code>SeriesReader</code> 的 <code>isPageOverlapped()</code> 方法判断当前 page 是否重叠，如果当前page不重叠，且其统计信息满足过滤条件，则返回<code>true</code>，否则返回<code>false</code>。</p></div> <div class="page-nav"><p class="inner"><span class="prev"> |
| ← |
| <a href="/zh/SystemDesign/DataQuery/QueryFundamentals.html" class="prev"> |
| 查询基础介绍 |
| </a></span> <span class="next"><a href="/zh/SystemDesign/DataQuery/RawDataQuery.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/199.246f826f.js" defer></script> |
| </body> |
| </html> |
