<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title> </title>
    <meta name="generator" content="VuePress 1.8.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.ccadf850.css" as="style"><link rel="preload" href="/assets/js/app.fe44b663.js" as="script"><link rel="preload" href="/assets/js/3.5626571b.js" as="script"><link rel="preload" href="/assets/js/8.68d2fe5c.js" as="script"><link rel="prefetch" href="/assets/js/10.77e7d27b.js"><link rel="prefetch" href="/assets/js/100.5392026f.js"><link rel="prefetch" href="/assets/js/101.4d24dbb3.js"><link rel="prefetch" href="/assets/js/102.4db55384.js"><link rel="prefetch" href="/assets/js/103.28a00d56.js"><link rel="prefetch" href="/assets/js/104.c1cad722.js"><link rel="prefetch" href="/assets/js/105.2dbc18e7.js"><link rel="prefetch" href="/assets/js/106.03cb3598.js"><link rel="prefetch" href="/assets/js/107.1aa2e9d5.js"><link rel="prefetch" href="/assets/js/108.c8e15789.js"><link rel="prefetch" href="/assets/js/109.4e029678.js"><link rel="prefetch" href="/assets/js/11.242ea813.js"><link rel="prefetch" href="/assets/js/110.2673e754.js"><link rel="prefetch" href="/assets/js/111.99869946.js"><link rel="prefetch" href="/assets/js/112.6931e30d.js"><link rel="prefetch" href="/assets/js/113.30edd688.js"><link rel="prefetch" href="/assets/js/114.cba21417.js"><link rel="prefetch" href="/assets/js/115.36ed9d85.js"><link rel="prefetch" href="/assets/js/116.b6f26e1b.js"><link rel="prefetch" href="/assets/js/117.b7ead194.js"><link rel="prefetch" href="/assets/js/118.0489f137.js"><link rel="prefetch" href="/assets/js/119.f4531020.js"><link rel="prefetch" href="/assets/js/12.4c48405a.js"><link rel="prefetch" href="/assets/js/120.d1bc4a0d.js"><link rel="prefetch" href="/assets/js/121.c4dac7da.js"><link rel="prefetch" href="/assets/js/122.37b6650b.js"><link rel="prefetch" href="/assets/js/123.6802c679.js"><link rel="prefetch" href="/assets/js/124.3a1dcf58.js"><link rel="prefetch" href="/assets/js/125.0c3e885a.js"><link rel="prefetch" href="/assets/js/126.fbfa46eb.js"><link rel="prefetch" href="/assets/js/127.110bc389.js"><link rel="prefetch" href="/assets/js/128.fd2a9b78.js"><link rel="prefetch" href="/assets/js/129.b0669c7b.js"><link rel="prefetch" href="/assets/js/13.16ded47d.js"><link rel="prefetch" href="/assets/js/130.830f695a.js"><link rel="prefetch" href="/assets/js/131.f74784eb.js"><link rel="prefetch" href="/assets/js/132.5bd44b31.js"><link rel="prefetch" href="/assets/js/133.4871f071.js"><link rel="prefetch" href="/assets/js/134.c1ebfd44.js"><link rel="prefetch" href="/assets/js/135.06b43884.js"><link rel="prefetch" href="/assets/js/136.4125fe2d.js"><link rel="prefetch" href="/assets/js/137.f79fb732.js"><link rel="prefetch" href="/assets/js/138.925cc589.js"><link rel="prefetch" href="/assets/js/139.269b4122.js"><link rel="prefetch" href="/assets/js/14.66eebc6d.js"><link rel="prefetch" href="/assets/js/140.8acac491.js"><link rel="prefetch" href="/assets/js/141.5739ba5c.js"><link rel="prefetch" href="/assets/js/142.0a0bb60d.js"><link rel="prefetch" href="/assets/js/143.a85602a6.js"><link rel="prefetch" href="/assets/js/144.af08976e.js"><link rel="prefetch" href="/assets/js/145.54dd8613.js"><link rel="prefetch" href="/assets/js/146.d6942192.js"><link rel="prefetch" href="/assets/js/147.58b089c2.js"><link rel="prefetch" href="/assets/js/148.f3061126.js"><link rel="prefetch" href="/assets/js/149.bed18caa.js"><link rel="prefetch" href="/assets/js/15.843fe861.js"><link rel="prefetch" href="/assets/js/150.857bbcb9.js"><link rel="prefetch" href="/assets/js/151.8df8eaff.js"><link rel="prefetch" href="/assets/js/152.7fbfa55b.js"><link rel="prefetch" href="/assets/js/153.88e78e8e.js"><link rel="prefetch" href="/assets/js/154.4c0105cf.js"><link rel="prefetch" href="/assets/js/155.56c02f22.js"><link rel="prefetch" href="/assets/js/156.3610ca5b.js"><link rel="prefetch" href="/assets/js/157.a82e8d14.js"><link rel="prefetch" href="/assets/js/158.cd306550.js"><link rel="prefetch" href="/assets/js/159.7c3f6836.js"><link rel="prefetch" href="/assets/js/16.17c1f643.js"><link rel="prefetch" href="/assets/js/160.d9e7ebc3.js"><link rel="prefetch" href="/assets/js/161.f69489a3.js"><link rel="prefetch" href="/assets/js/162.260f8f8c.js"><link rel="prefetch" href="/assets/js/163.6f4c436f.js"><link rel="prefetch" href="/assets/js/164.48a2358e.js"><link rel="prefetch" href="/assets/js/165.beba59fe.js"><link rel="prefetch" href="/assets/js/166.2534a588.js"><link rel="prefetch" href="/assets/js/167.daba1492.js"><link rel="prefetch" href="/assets/js/168.66d50e2f.js"><link rel="prefetch" href="/assets/js/169.4a288ab4.js"><link rel="prefetch" href="/assets/js/17.9b8df773.js"><link rel="prefetch" href="/assets/js/170.f0555c86.js"><link rel="prefetch" href="/assets/js/171.bbe4ba1a.js"><link rel="prefetch" href="/assets/js/172.712c6bac.js"><link rel="prefetch" href="/assets/js/173.c3917d0d.js"><link rel="prefetch" href="/assets/js/174.9d843f6f.js"><link rel="prefetch" href="/assets/js/175.ca25b135.js"><link rel="prefetch" href="/assets/js/176.35f2d232.js"><link rel="prefetch" href="/assets/js/177.e8e6286d.js"><link rel="prefetch" href="/assets/js/178.c37c5efd.js"><link rel="prefetch" href="/assets/js/179.84f3bdd6.js"><link rel="prefetch" href="/assets/js/18.122d5826.js"><link rel="prefetch" href="/assets/js/180.32503609.js"><link rel="prefetch" href="/assets/js/181.219cb189.js"><link rel="prefetch" href="/assets/js/182.e90074d5.js"><link rel="prefetch" href="/assets/js/183.87f069d1.js"><link rel="prefetch" href="/assets/js/184.6b62bd9f.js"><link rel="prefetch" href="/assets/js/185.4e6b021e.js"><link rel="prefetch" href="/assets/js/186.3679d30d.js"><link rel="prefetch" href="/assets/js/187.aeba6c58.js"><link rel="prefetch" href="/assets/js/188.cc1022eb.js"><link rel="prefetch" href="/assets/js/189.5ac3b4a4.js"><link rel="prefetch" href="/assets/js/19.9187dec1.js"><link rel="prefetch" href="/assets/js/190.ff15e49f.js"><link rel="prefetch" href="/assets/js/191.369829d5.js"><link rel="prefetch" href="/assets/js/192.1d1eb36e.js"><link rel="prefetch" href="/assets/js/193.fc0fb393.js"><link rel="prefetch" href="/assets/js/194.b47fbc4c.js"><link rel="prefetch" href="/assets/js/195.9e36d668.js"><link rel="prefetch" href="/assets/js/196.2d1223f7.js"><link rel="prefetch" href="/assets/js/197.55863e11.js"><link rel="prefetch" href="/assets/js/198.a48cc095.js"><link rel="prefetch" href="/assets/js/199.3a9c2528.js"><link rel="prefetch" href="/assets/js/20.cf088c3b.js"><link rel="prefetch" href="/assets/js/200.195ff96b.js"><link rel="prefetch" href="/assets/js/201.4d6c6e24.js"><link rel="prefetch" href="/assets/js/202.c32388f7.js"><link rel="prefetch" href="/assets/js/203.080586a5.js"><link rel="prefetch" href="/assets/js/204.a3b3ce92.js"><link rel="prefetch" href="/assets/js/205.9af51d77.js"><link rel="prefetch" href="/assets/js/206.ea246089.js"><link rel="prefetch" href="/assets/js/207.1c222b6c.js"><link rel="prefetch" href="/assets/js/208.fa41b6db.js"><link rel="prefetch" href="/assets/js/209.206e9cfe.js"><link rel="prefetch" href="/assets/js/21.fd51f269.js"><link rel="prefetch" href="/assets/js/210.e4599d5b.js"><link rel="prefetch" href="/assets/js/211.b4f21019.js"><link rel="prefetch" href="/assets/js/212.552b3f7c.js"><link rel="prefetch" href="/assets/js/213.e7924e39.js"><link rel="prefetch" href="/assets/js/214.4889616d.js"><link rel="prefetch" href="/assets/js/215.8bc1d1bf.js"><link rel="prefetch" href="/assets/js/216.aeaaff79.js"><link rel="prefetch" href="/assets/js/217.51dbbd91.js"><link rel="prefetch" href="/assets/js/218.477c1e20.js"><link rel="prefetch" href="/assets/js/219.fd6ed6fa.js"><link rel="prefetch" href="/assets/js/22.f9d73f8a.js"><link rel="prefetch" href="/assets/js/220.84349773.js"><link rel="prefetch" href="/assets/js/221.4b98b09e.js"><link rel="prefetch" href="/assets/js/222.57476182.js"><link rel="prefetch" href="/assets/js/223.1c0323f8.js"><link rel="prefetch" href="/assets/js/224.61e78712.js"><link rel="prefetch" href="/assets/js/225.9b6f0752.js"><link rel="prefetch" href="/assets/js/226.4868d0a5.js"><link rel="prefetch" href="/assets/js/227.6ba50795.js"><link rel="prefetch" href="/assets/js/228.1d3cd90f.js"><link rel="prefetch" href="/assets/js/229.6ca83068.js"><link rel="prefetch" href="/assets/js/23.6c7d7eea.js"><link rel="prefetch" href="/assets/js/230.5e6f7ed2.js"><link rel="prefetch" href="/assets/js/231.a8ecd36e.js"><link rel="prefetch" href="/assets/js/232.a18567c5.js"><link rel="prefetch" href="/assets/js/233.f79fadcf.js"><link rel="prefetch" href="/assets/js/234.d9207163.js"><link rel="prefetch" href="/assets/js/235.e81b51ae.js"><link rel="prefetch" href="/assets/js/236.b9c32f41.js"><link rel="prefetch" href="/assets/js/237.d795e1ce.js"><link rel="prefetch" href="/assets/js/238.49757612.js"><link rel="prefetch" href="/assets/js/239.aeda84ea.js"><link rel="prefetch" href="/assets/js/24.a553bb19.js"><link rel="prefetch" href="/assets/js/240.07479801.js"><link rel="prefetch" href="/assets/js/241.ba1379fe.js"><link rel="prefetch" href="/assets/js/242.ce1b153f.js"><link rel="prefetch" href="/assets/js/243.18fd3c66.js"><link rel="prefetch" href="/assets/js/244.2b98e85b.js"><link rel="prefetch" href="/assets/js/245.bf64d7c9.js"><link rel="prefetch" href="/assets/js/246.d0a5b73c.js"><link rel="prefetch" href="/assets/js/247.b9bc9104.js"><link rel="prefetch" href="/assets/js/248.714df448.js"><link rel="prefetch" href="/assets/js/249.e0039e9d.js"><link rel="prefetch" href="/assets/js/25.1e42b275.js"><link rel="prefetch" href="/assets/js/250.ca664993.js"><link rel="prefetch" href="/assets/js/251.b47f298a.js"><link rel="prefetch" href="/assets/js/252.71392152.js"><link rel="prefetch" href="/assets/js/253.e0f23ec8.js"><link rel="prefetch" href="/assets/js/254.6d43bbe7.js"><link rel="prefetch" href="/assets/js/255.c1779bd2.js"><link rel="prefetch" href="/assets/js/256.6a8a06f3.js"><link rel="prefetch" href="/assets/js/257.4e74c883.js"><link rel="prefetch" href="/assets/js/258.f4b72fd8.js"><link rel="prefetch" href="/assets/js/259.f9b80571.js"><link rel="prefetch" href="/assets/js/26.0057d37b.js"><link rel="prefetch" href="/assets/js/260.10e21bfc.js"><link rel="prefetch" href="/assets/js/261.402db160.js"><link rel="prefetch" href="/assets/js/262.02c5372b.js"><link rel="prefetch" href="/assets/js/263.3454f741.js"><link rel="prefetch" href="/assets/js/264.dfc588bd.js"><link rel="prefetch" href="/assets/js/265.f1fee64b.js"><link rel="prefetch" href="/assets/js/266.baac44a1.js"><link rel="prefetch" href="/assets/js/267.b6f584a5.js"><link rel="prefetch" href="/assets/js/268.013f92f7.js"><link rel="prefetch" href="/assets/js/269.706a27e5.js"><link rel="prefetch" href="/assets/js/27.9e25f953.js"><link rel="prefetch" href="/assets/js/270.397dc6f7.js"><link rel="prefetch" href="/assets/js/271.5f063e14.js"><link rel="prefetch" href="/assets/js/272.b88b9e6e.js"><link rel="prefetch" href="/assets/js/273.f7eeeb80.js"><link rel="prefetch" href="/assets/js/274.8d7d8c2a.js"><link rel="prefetch" href="/assets/js/275.167633d2.js"><link rel="prefetch" href="/assets/js/276.bf42d85f.js"><link rel="prefetch" href="/assets/js/277.195beb55.js"><link rel="prefetch" href="/assets/js/278.852d1996.js"><link rel="prefetch" href="/assets/js/279.a3fb5857.js"><link rel="prefetch" href="/assets/js/28.0a801078.js"><link rel="prefetch" href="/assets/js/280.de229c1d.js"><link rel="prefetch" href="/assets/js/281.47d676fa.js"><link rel="prefetch" href="/assets/js/282.1db3920a.js"><link rel="prefetch" href="/assets/js/283.0ed31a9c.js"><link rel="prefetch" href="/assets/js/284.d2f802aa.js"><link rel="prefetch" href="/assets/js/285.0a18923e.js"><link rel="prefetch" href="/assets/js/286.60438a30.js"><link rel="prefetch" href="/assets/js/287.6fa63573.js"><link rel="prefetch" href="/assets/js/288.4432c980.js"><link rel="prefetch" href="/assets/js/289.789f44e7.js"><link rel="prefetch" href="/assets/js/29.a31435b1.js"><link rel="prefetch" href="/assets/js/290.3c1f2e4c.js"><link rel="prefetch" href="/assets/js/291.a340398b.js"><link rel="prefetch" href="/assets/js/292.8568adc1.js"><link rel="prefetch" href="/assets/js/293.42107ac0.js"><link rel="prefetch" href="/assets/js/294.5fae363a.js"><link rel="prefetch" href="/assets/js/295.eb955643.js"><link rel="prefetch" href="/assets/js/296.77ae03d2.js"><link rel="prefetch" href="/assets/js/297.e548ba7e.js"><link rel="prefetch" href="/assets/js/298.d08bd092.js"><link rel="prefetch" href="/assets/js/299.a9495179.js"><link rel="prefetch" href="/assets/js/30.60649b66.js"><link rel="prefetch" href="/assets/js/300.1f1c6539.js"><link rel="prefetch" href="/assets/js/301.45e54d01.js"><link rel="prefetch" href="/assets/js/302.41fa5b16.js"><link rel="prefetch" href="/assets/js/303.50302303.js"><link rel="prefetch" href="/assets/js/304.45ec5f49.js"><link rel="prefetch" href="/assets/js/305.4667a075.js"><link rel="prefetch" href="/assets/js/306.9adbbd88.js"><link rel="prefetch" href="/assets/js/307.01fbd282.js"><link rel="prefetch" href="/assets/js/308.ee661372.js"><link rel="prefetch" href="/assets/js/309.71fd6514.js"><link rel="prefetch" href="/assets/js/31.b5e715ce.js"><link rel="prefetch" href="/assets/js/310.2c1b5f58.js"><link rel="prefetch" href="/assets/js/311.bf369b6f.js"><link rel="prefetch" href="/assets/js/312.ee6deb53.js"><link rel="prefetch" href="/assets/js/313.b173305e.js"><link rel="prefetch" href="/assets/js/314.9bf7681c.js"><link rel="prefetch" href="/assets/js/315.9dced4c4.js"><link rel="prefetch" href="/assets/js/316.d1625f8e.js"><link rel="prefetch" href="/assets/js/317.ff874148.js"><link rel="prefetch" href="/assets/js/318.bc83f98a.js"><link rel="prefetch" href="/assets/js/319.eb7b75c1.js"><link rel="prefetch" href="/assets/js/32.e5e702b0.js"><link rel="prefetch" href="/assets/js/320.017cca1c.js"><link rel="prefetch" href="/assets/js/321.e34387cb.js"><link rel="prefetch" href="/assets/js/322.5aae6989.js"><link rel="prefetch" href="/assets/js/323.e4fd51b3.js"><link rel="prefetch" href="/assets/js/324.1ba3ee32.js"><link rel="prefetch" href="/assets/js/325.21254638.js"><link rel="prefetch" href="/assets/js/326.377d3f46.js"><link rel="prefetch" href="/assets/js/327.7734ba1d.js"><link rel="prefetch" href="/assets/js/328.e9791163.js"><link rel="prefetch" href="/assets/js/329.8acd00bc.js"><link rel="prefetch" href="/assets/js/33.b678d537.js"><link rel="prefetch" href="/assets/js/330.6cff02ec.js"><link rel="prefetch" href="/assets/js/331.98ebbe7d.js"><link rel="prefetch" href="/assets/js/332.1d9d1a04.js"><link rel="prefetch" href="/assets/js/333.e8be9a85.js"><link rel="prefetch" href="/assets/js/334.677f7d89.js"><link rel="prefetch" href="/assets/js/335.9bca2b37.js"><link rel="prefetch" href="/assets/js/336.b2a7394a.js"><link rel="prefetch" href="/assets/js/337.0231a5b2.js"><link rel="prefetch" href="/assets/js/338.1979cb4d.js"><link rel="prefetch" href="/assets/js/339.4bb8f0a9.js"><link rel="prefetch" href="/assets/js/34.f1aa3803.js"><link rel="prefetch" href="/assets/js/340.f0fa3c52.js"><link rel="prefetch" href="/assets/js/341.f8178251.js"><link rel="prefetch" href="/assets/js/342.7dd47706.js"><link rel="prefetch" href="/assets/js/343.363f2cae.js"><link rel="prefetch" href="/assets/js/344.2b4d1572.js"><link rel="prefetch" href="/assets/js/345.54e08f16.js"><link rel="prefetch" href="/assets/js/346.541ef94e.js"><link rel="prefetch" href="/assets/js/347.1f8a56e7.js"><link rel="prefetch" href="/assets/js/348.ff08d1b4.js"><link rel="prefetch" href="/assets/js/349.97e1160f.js"><link rel="prefetch" href="/assets/js/35.5612ab6a.js"><link rel="prefetch" href="/assets/js/350.1fa64f48.js"><link rel="prefetch" href="/assets/js/351.0cdcbb68.js"><link rel="prefetch" href="/assets/js/352.04f35660.js"><link rel="prefetch" href="/assets/js/353.c63abb11.js"><link rel="prefetch" href="/assets/js/354.f07fe232.js"><link rel="prefetch" href="/assets/js/355.9db8e984.js"><link rel="prefetch" href="/assets/js/356.7e54a7f7.js"><link rel="prefetch" href="/assets/js/357.b8b2c19a.js"><link rel="prefetch" href="/assets/js/358.ec88593c.js"><link rel="prefetch" href="/assets/js/359.57a348e6.js"><link rel="prefetch" href="/assets/js/36.4e36f97e.js"><link rel="prefetch" href="/assets/js/360.f91d4985.js"><link rel="prefetch" href="/assets/js/361.fd0b896b.js"><link rel="prefetch" href="/assets/js/362.3078bc4c.js"><link rel="prefetch" href="/assets/js/363.970af9b1.js"><link rel="prefetch" href="/assets/js/364.ce305e49.js"><link rel="prefetch" href="/assets/js/365.228a2005.js"><link rel="prefetch" href="/assets/js/366.3e0ce2e8.js"><link rel="prefetch" href="/assets/js/367.dfba61c0.js"><link rel="prefetch" href="/assets/js/368.d4307f98.js"><link rel="prefetch" href="/assets/js/369.730e7097.js"><link rel="prefetch" href="/assets/js/37.13b65e5d.js"><link rel="prefetch" href="/assets/js/370.e7a52728.js"><link rel="prefetch" href="/assets/js/371.99346247.js"><link rel="prefetch" href="/assets/js/372.09676253.js"><link rel="prefetch" href="/assets/js/373.2a7b274a.js"><link rel="prefetch" href="/assets/js/374.e347ead4.js"><link rel="prefetch" href="/assets/js/375.f70bcedd.js"><link rel="prefetch" href="/assets/js/376.c776b0ed.js"><link rel="prefetch" href="/assets/js/377.3d81f722.js"><link rel="prefetch" href="/assets/js/378.a7f10c5f.js"><link rel="prefetch" href="/assets/js/379.b18f1c51.js"><link rel="prefetch" href="/assets/js/38.c6f83038.js"><link rel="prefetch" href="/assets/js/380.a84e788a.js"><link rel="prefetch" href="/assets/js/381.521f1a2b.js"><link rel="prefetch" href="/assets/js/382.10ebffdc.js"><link rel="prefetch" href="/assets/js/383.fa0c4858.js"><link rel="prefetch" href="/assets/js/384.4d3a1d3e.js"><link rel="prefetch" href="/assets/js/385.edbe545d.js"><link rel="prefetch" href="/assets/js/386.aa0e0479.js"><link rel="prefetch" href="/assets/js/387.d08b9da1.js"><link rel="prefetch" href="/assets/js/388.3cafa76f.js"><link rel="prefetch" href="/assets/js/389.1c150739.js"><link rel="prefetch" href="/assets/js/39.41707d32.js"><link rel="prefetch" href="/assets/js/390.e3c6dc5b.js"><link rel="prefetch" href="/assets/js/391.097ce5d5.js"><link rel="prefetch" href="/assets/js/392.b1450deb.js"><link rel="prefetch" href="/assets/js/393.a9be5042.js"><link rel="prefetch" href="/assets/js/394.0f496e89.js"><link rel="prefetch" href="/assets/js/395.d66b20d2.js"><link rel="prefetch" href="/assets/js/396.a238eb17.js"><link rel="prefetch" href="/assets/js/397.c76a0b8d.js"><link rel="prefetch" href="/assets/js/398.3812b640.js"><link rel="prefetch" href="/assets/js/399.e6940f90.js"><link rel="prefetch" href="/assets/js/4.9c4b1c6d.js"><link rel="prefetch" href="/assets/js/40.f82f0187.js"><link rel="prefetch" href="/assets/js/400.5e0cfb93.js"><link rel="prefetch" href="/assets/js/401.f613f2ba.js"><link rel="prefetch" href="/assets/js/402.be1f5783.js"><link rel="prefetch" href="/assets/js/403.33c1396d.js"><link rel="prefetch" href="/assets/js/404.562089b0.js"><link rel="prefetch" href="/assets/js/405.93f42baf.js"><link rel="prefetch" href="/assets/js/406.ba8d00d1.js"><link rel="prefetch" href="/assets/js/407.0150b19f.js"><link rel="prefetch" href="/assets/js/408.728a1d15.js"><link rel="prefetch" href="/assets/js/409.ef560ed7.js"><link rel="prefetch" href="/assets/js/41.b6799c44.js"><link rel="prefetch" href="/assets/js/410.d3f65621.js"><link rel="prefetch" href="/assets/js/411.07ef2c9f.js"><link rel="prefetch" href="/assets/js/412.4a1d8057.js"><link rel="prefetch" href="/assets/js/413.ebf9aafc.js"><link rel="prefetch" href="/assets/js/414.a5433120.js"><link rel="prefetch" href="/assets/js/415.4dcc07c7.js"><link rel="prefetch" href="/assets/js/416.11747f6b.js"><link rel="prefetch" href="/assets/js/417.5270e086.js"><link rel="prefetch" href="/assets/js/418.d5fc9d05.js"><link rel="prefetch" href="/assets/js/419.540dcd2a.js"><link rel="prefetch" href="/assets/js/42.e6b0aae2.js"><link rel="prefetch" href="/assets/js/420.28641617.js"><link rel="prefetch" href="/assets/js/421.a6c3c8af.js"><link rel="prefetch" href="/assets/js/422.52ab97a6.js"><link rel="prefetch" href="/assets/js/423.7c5da32e.js"><link rel="prefetch" href="/assets/js/424.d39b15e0.js"><link rel="prefetch" href="/assets/js/425.2c8fbc5a.js"><link rel="prefetch" href="/assets/js/426.b6957825.js"><link rel="prefetch" href="/assets/js/427.b96cf924.js"><link rel="prefetch" href="/assets/js/428.6440b235.js"><link rel="prefetch" href="/assets/js/429.57902fe0.js"><link rel="prefetch" href="/assets/js/43.3fff5a4c.js"><link rel="prefetch" href="/assets/js/430.04255b2f.js"><link rel="prefetch" href="/assets/js/431.321286eb.js"><link rel="prefetch" href="/assets/js/432.72fdf31f.js"><link rel="prefetch" href="/assets/js/433.52676bc7.js"><link rel="prefetch" href="/assets/js/434.7bc3fee7.js"><link rel="prefetch" href="/assets/js/435.deac35a6.js"><link rel="prefetch" href="/assets/js/436.46f753f4.js"><link rel="prefetch" href="/assets/js/437.6a675a68.js"><link rel="prefetch" href="/assets/js/438.e8c8ae5b.js"><link rel="prefetch" href="/assets/js/439.ba3f2700.js"><link rel="prefetch" href="/assets/js/44.fee39d6b.js"><link rel="prefetch" href="/assets/js/440.98a7bff0.js"><link rel="prefetch" href="/assets/js/441.e12292fb.js"><link rel="prefetch" href="/assets/js/442.08f60114.js"><link rel="prefetch" href="/assets/js/443.d5d255b9.js"><link rel="prefetch" href="/assets/js/444.01c13452.js"><link rel="prefetch" href="/assets/js/445.954c3b0b.js"><link rel="prefetch" href="/assets/js/446.81521199.js"><link rel="prefetch" href="/assets/js/447.0cf2269e.js"><link rel="prefetch" href="/assets/js/448.fb62b763.js"><link rel="prefetch" href="/assets/js/449.2fd7ec4e.js"><link rel="prefetch" href="/assets/js/45.244b7680.js"><link rel="prefetch" href="/assets/js/450.3ff3ce7b.js"><link rel="prefetch" href="/assets/js/451.4b455f4a.js"><link rel="prefetch" href="/assets/js/452.51fbf6e4.js"><link rel="prefetch" href="/assets/js/453.4d5d4319.js"><link rel="prefetch" href="/assets/js/454.99948bc3.js"><link rel="prefetch" href="/assets/js/455.d1380266.js"><link rel="prefetch" href="/assets/js/456.22423caf.js"><link rel="prefetch" href="/assets/js/457.05a6e43b.js"><link rel="prefetch" href="/assets/js/458.2a93e9bc.js"><link rel="prefetch" href="/assets/js/459.dfc3d492.js"><link rel="prefetch" href="/assets/js/46.539f062d.js"><link rel="prefetch" href="/assets/js/460.2a50d5c4.js"><link rel="prefetch" href="/assets/js/461.07548ac3.js"><link rel="prefetch" href="/assets/js/462.214e91ce.js"><link rel="prefetch" href="/assets/js/463.414bc138.js"><link rel="prefetch" href="/assets/js/464.779a26ec.js"><link rel="prefetch" href="/assets/js/465.c61d57fa.js"><link rel="prefetch" href="/assets/js/466.ab4c1900.js"><link rel="prefetch" href="/assets/js/467.6398c8fc.js"><link rel="prefetch" href="/assets/js/468.f013763e.js"><link rel="prefetch" href="/assets/js/469.40bcf372.js"><link rel="prefetch" href="/assets/js/47.a8742825.js"><link rel="prefetch" href="/assets/js/470.ba1d5a08.js"><link rel="prefetch" href="/assets/js/471.9842c3d9.js"><link rel="prefetch" href="/assets/js/472.887667b1.js"><link rel="prefetch" href="/assets/js/473.ac9f4dc8.js"><link rel="prefetch" href="/assets/js/474.c950558a.js"><link rel="prefetch" href="/assets/js/475.ec6929d7.js"><link rel="prefetch" href="/assets/js/476.d351ffef.js"><link rel="prefetch" href="/assets/js/477.cbb436f4.js"><link rel="prefetch" href="/assets/js/478.10a8af05.js"><link rel="prefetch" href="/assets/js/479.3e21eec2.js"><link rel="prefetch" href="/assets/js/48.656f2900.js"><link rel="prefetch" href="/assets/js/480.2889f790.js"><link rel="prefetch" href="/assets/js/481.6504abc3.js"><link rel="prefetch" href="/assets/js/482.25c23f5a.js"><link rel="prefetch" href="/assets/js/483.11c430e0.js"><link rel="prefetch" href="/assets/js/484.4fb1d507.js"><link rel="prefetch" href="/assets/js/485.1ecbb4e0.js"><link rel="prefetch" href="/assets/js/486.a15cc699.js"><link rel="prefetch" href="/assets/js/487.b4a9526d.js"><link rel="prefetch" href="/assets/js/488.85d13879.js"><link rel="prefetch" href="/assets/js/489.3a566e3d.js"><link rel="prefetch" href="/assets/js/49.f271ac34.js"><link rel="prefetch" href="/assets/js/490.347d23af.js"><link rel="prefetch" href="/assets/js/491.558b7aa9.js"><link rel="prefetch" href="/assets/js/492.af9c4c53.js"><link rel="prefetch" href="/assets/js/493.f89bdb3c.js"><link rel="prefetch" href="/assets/js/494.a0142c98.js"><link rel="prefetch" href="/assets/js/495.d3de8850.js"><link rel="prefetch" href="/assets/js/496.d48c6630.js"><link rel="prefetch" href="/assets/js/497.3b9635e2.js"><link rel="prefetch" href="/assets/js/498.f587a80e.js"><link rel="prefetch" href="/assets/js/499.22f6be18.js"><link rel="prefetch" href="/assets/js/5.2a4451ec.js"><link rel="prefetch" href="/assets/js/50.7d8944cd.js"><link rel="prefetch" href="/assets/js/500.d054de5c.js"><link rel="prefetch" href="/assets/js/501.954e1b5c.js"><link rel="prefetch" href="/assets/js/502.4b184e51.js"><link rel="prefetch" href="/assets/js/503.10334ca5.js"><link rel="prefetch" href="/assets/js/504.0e074cd3.js"><link rel="prefetch" href="/assets/js/505.4993e90d.js"><link rel="prefetch" href="/assets/js/506.6f94a2f8.js"><link rel="prefetch" href="/assets/js/507.b255fcfd.js"><link rel="prefetch" href="/assets/js/508.95c9551e.js"><link rel="prefetch" href="/assets/js/509.1d2ab0fb.js"><link rel="prefetch" href="/assets/js/51.fd01b1a1.js"><link rel="prefetch" href="/assets/js/510.36c66e50.js"><link rel="prefetch" href="/assets/js/511.caf2e589.js"><link rel="prefetch" href="/assets/js/512.133bca04.js"><link rel="prefetch" href="/assets/js/513.e3f62ca2.js"><link rel="prefetch" href="/assets/js/514.f17c4a44.js"><link rel="prefetch" href="/assets/js/515.f637b155.js"><link rel="prefetch" href="/assets/js/516.3cccca96.js"><link rel="prefetch" href="/assets/js/517.80c43b59.js"><link rel="prefetch" href="/assets/js/518.f3438412.js"><link rel="prefetch" href="/assets/js/519.5a0ef98b.js"><link rel="prefetch" href="/assets/js/52.10d8a15b.js"><link rel="prefetch" href="/assets/js/520.d83038f1.js"><link rel="prefetch" href="/assets/js/521.4726d233.js"><link rel="prefetch" href="/assets/js/522.045aff30.js"><link rel="prefetch" href="/assets/js/523.9d9b45b5.js"><link rel="prefetch" href="/assets/js/524.86a7c6cf.js"><link rel="prefetch" href="/assets/js/525.1d6e7b79.js"><link rel="prefetch" href="/assets/js/526.c365bd67.js"><link rel="prefetch" href="/assets/js/527.555f8b61.js"><link rel="prefetch" href="/assets/js/528.690272cc.js"><link rel="prefetch" href="/assets/js/529.7f05b847.js"><link rel="prefetch" href="/assets/js/53.79f66cea.js"><link rel="prefetch" href="/assets/js/530.3fb31398.js"><link rel="prefetch" href="/assets/js/531.54b0ee66.js"><link rel="prefetch" href="/assets/js/532.42a967ca.js"><link rel="prefetch" href="/assets/js/54.1ec48dc5.js"><link rel="prefetch" href="/assets/js/55.9d4b8667.js"><link rel="prefetch" href="/assets/js/56.aa94202c.js"><link rel="prefetch" href="/assets/js/57.dd80489d.js"><link rel="prefetch" href="/assets/js/58.9af3c40d.js"><link rel="prefetch" href="/assets/js/59.70e0291b.js"><link rel="prefetch" href="/assets/js/6.3450075a.js"><link rel="prefetch" href="/assets/js/60.53b7d88b.js"><link rel="prefetch" href="/assets/js/61.b70ccd57.js"><link rel="prefetch" href="/assets/js/62.eef65e9b.js"><link rel="prefetch" href="/assets/js/63.3a66528e.js"><link rel="prefetch" href="/assets/js/64.ed6b77b6.js"><link rel="prefetch" href="/assets/js/65.5573ce3d.js"><link rel="prefetch" href="/assets/js/66.aa4ead2c.js"><link rel="prefetch" href="/assets/js/67.29edf638.js"><link rel="prefetch" href="/assets/js/68.38ac76fc.js"><link rel="prefetch" href="/assets/js/69.7f8c7118.js"><link rel="prefetch" href="/assets/js/7.c5c54fb4.js"><link rel="prefetch" href="/assets/js/70.368e2128.js"><link rel="prefetch" href="/assets/js/71.cf483d39.js"><link rel="prefetch" href="/assets/js/72.b095c9c5.js"><link rel="prefetch" href="/assets/js/73.7f2ffe57.js"><link rel="prefetch" href="/assets/js/74.d67c3927.js"><link rel="prefetch" href="/assets/js/75.d4945299.js"><link rel="prefetch" href="/assets/js/76.f01b8b07.js"><link rel="prefetch" href="/assets/js/77.3c1e294c.js"><link rel="prefetch" href="/assets/js/78.cfcd53d4.js"><link rel="prefetch" href="/assets/js/79.a50c96bd.js"><link rel="prefetch" href="/assets/js/80.8358bd99.js"><link rel="prefetch" href="/assets/js/81.754e7cd2.js"><link rel="prefetch" href="/assets/js/82.e42aff88.js"><link rel="prefetch" href="/assets/js/83.152a1582.js"><link rel="prefetch" href="/assets/js/84.4867883c.js"><link rel="prefetch" href="/assets/js/85.6b2afa69.js"><link rel="prefetch" href="/assets/js/86.3e058a7a.js"><link rel="prefetch" href="/assets/js/87.cf9a4fcf.js"><link rel="prefetch" href="/assets/js/88.dc32204f.js"><link rel="prefetch" href="/assets/js/89.fb10ca17.js"><link rel="prefetch" href="/assets/js/9.e4a451d3.js"><link rel="prefetch" href="/assets/js/90.7f184d9a.js"><link rel="prefetch" href="/assets/js/91.35f464f6.js"><link rel="prefetch" href="/assets/js/92.e45a3d68.js"><link rel="prefetch" href="/assets/js/93.0d192890.js"><link rel="prefetch" href="/assets/js/94.13f91cee.js"><link rel="prefetch" href="/assets/js/95.732898b6.js"><link rel="prefetch" href="/assets/js/96.10bfabc4.js"><link rel="prefetch" href="/assets/js/97.20f5d113.js"><link rel="prefetch" href="/assets/js/98.49efa8b4.js"><link rel="prefetch" href="/assets/js/99.9abce7a4.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.eff714eb.js">
    <link rel="stylesheet" href="/assets/css/0.styles.ccadf850.css">
  </head>
  <body>
    <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><img src="/img/logo.png" alt=" " class="logo"></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external">
  Wiki
  <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external">
  Foundation
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
  License
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
  Security
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
  Sponsorship
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
  Thanks
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
  Current Events
  <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/TsFile/Read.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/TsFile/Read.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link">
    gitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external">
  Wiki
  <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external">
  Foundation
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external">
  License
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external">
  Security
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external">
  Sponsorship
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external">
  Thanks
  <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external">
  Current Events
  <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/SystemDesign/TsFile/Read.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/SystemDesign/TsFile/Read.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link">
    gitHub
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" 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> <span class="sr-only">(opens new window)</span></span></a></nav>  <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>System design</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Architecture</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>TsFile</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/SystemDesign/TsFile/TsFile.html" class="sidebar-link">TsFile</a></li><li><a href="/SystemDesign/TsFile/Format.html" class="sidebar-link">Format</a></li><li><a href="/SystemDesign/TsFile/Write.html" class="sidebar-link">Write</a></li><li><a href="/SystemDesign/TsFile/Read.html" aria-current="page" class="active sidebar-link">Read</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>QueryEngine</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>SchemaManager</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>StorageEngine</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>DataQuery</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Tools</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Connector</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Client</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="tsfile-read-process"><a href="#tsfile-read-process" class="header-anchor">#</a> TsFile Read Process</h1> <p>This chapter introduces how to read TsFile. The content is mainly divided into two parts, the introduction of Filters and Expressions , and the detailed illustration of query process in TsFile.</p> <ul><li><a href="#TsFile-Read-Process">TsFile Read Process</a> <ul><li><a href="#1-Filters-and-Expressions">1 Filters and Expressions</a> <ul><li><a href="#11-Filter">1.1 Filter</a></li> <li><a href="#12-Expression">1.2 Expression</a> <ul><li><a href="#121-SingleSeriesExpression">1.2.1 SingleSeriesExpression</a></li> <li><a href="#122-GlobalTimeExpression">1.2.2 GlobalTimeExpression</a></li> <li><a href="#123-IExpression">1.2.3 IExpression</a></li> <li><a href="#124-Executable-Expression">1.2.4 Executable Expression</a></li> <li><a href="#125-The-Algorithm-Transforming-IExpression-to-an-Executable-Expression">1.2.5 The Algorithm Transforming IExpression to an Executable Expression</a></li></ul></li></ul></li> <li><a href="#2-Query-Execution-of-TsFile">2 Query Execution of TsFile</a> <ul><li><a href="#21-Design">2.1 Design</a></li> <li><a href="#22-Three-Components">2.2 Three Components</a> <ul><li><a href="#221-FileSeriesReader">2.2.1 FileSeriesReader</a></li> <li><a href="#222-FileSeriesReaderByTimestamp">2.2.2 FileSeriesReaderByTimestamp</a></li> <li><a href="#223-TimeGeneratorImpl">2.2.3 TimeGeneratorImpl</a></li></ul></li> <li><a href="#23-Merge-Query">2.3 Merge Query</a></li> <li><a href="#24-Join-Query">2.4 Join Query</a></li> <li><a href="#25-Query-of-TsFile">2.5 Query of TsFile</a></li> <li><a href="#26-Related-Concepts">2.6 Related Concepts</a></li></ul></li></ul></li></ul> <h2 id="_1-filters-and-expressions"><a href="#_1-filters-and-expressions" class="header-anchor">#</a> 1 Filters and Expressions</h2> <h3 id="_1-1-filter"><a href="#_1-1-filter" class="header-anchor">#</a> 1.1 Filter</h3> <p>In this document, the term Filter means filter conditions. Users can customize filter conditions on timestamp, or the value of time series. We distinguish the filters which are on timestamp from those on column values. Assume t to be a timestamp constant, there are 12 basic types of Filters. In implementation, they all inherit from the super class Filter.</p> <table><thead><tr><th>Filter</th> <th>Filter Type</th> <th>Explanation</th> <th>Examples</th></tr></thead> <tbody><tr><td>TimeEq</td> <td>time filter</td> <td>timestamp = some value</td> <td>TimeEq(t) means timestamp should be equal to t</td></tr> <tr><td>TimeGt</td> <td>time filter</td> <td>timestamp &gt; some value</td> <td>TimeGt(t) means timestamp should be greater than t</td></tr> <tr><td>TimeGtEq</td> <td>time filter</td> <td>timestamp &gt;= some value</td> <td>TimeGtEq(t) means timestamp greater than or equal to t</td></tr> <tr><td>TimeLt</td> <td>time filter</td> <td>timestamp &lt; some value</td> <td>TimeLt(t) means timestamp should be less than t</td></tr> <tr><td>TimeLtEq</td> <td>time filter</td> <td>timestamp &lt;= some value</td> <td>TimeLtEq(t) means timestamp should be less than or equal to t</td></tr> <tr><td>TimeNotEq</td> <td>time filter</td> <td>timestamp != some value</td> <td>TimeNotEq(t) means timestamp should not be equal to t</td></tr> <tr><td>ValueEq</td> <td>value filter</td> <td>value on this column = some value</td> <td>ValueEq(2147483649) means value on this column should be equal to 2147483649</td></tr> <tr><td>ValueGt</td> <td>value filter</td> <td>value on this column &gt; some value</td> <td>ValueGt(100.5) means value on this column should be greater than 100.5</td></tr> <tr><td>ValueGtEq</td> <td>value filter</td> <td>value on this column &gt;= some value</td> <td>ValueGtEq(2) means value on this column should be greanter than 2</td></tr> <tr><td>ValueLt</td> <td>value filter</td> <td>value on this column &lt; some value</td> <td>ValueLt(&quot;string&quot;) means value on this column should be less than &quot;string&quot; in alphabet order</td></tr> <tr><td>ValueLtEq</td> <td>value filter</td> <td>value on this column &lt;= some value</td> <td>ValueLtEq(-100) means value on this column shold be less than or equal to -100</td></tr> <tr><td>ValueNotEq</td> <td>value filter</td> <td>value on this column != some value</td> <td>ValueNotEq(true) means value on this column should not be true</td></tr></tbody></table> <p>Filter can be composed of one or two Filter children。If a Filter is composed of a single Filter, it is also termed as UnaryFilter.If it contains two filters, it is termed as BinaryFilter. In this case, the two filters are connected with a logical relation, AND or OR, where the formar is termed as AndFilter, and the latter is OrFilter. Obviously, both AndFilter and OrFilter are BinaryFilter.</p> <p>We give some examples of AndFilter and OrFilter, where &quot;&amp;&amp;&quot; indicates relation AND and &quot;||&quot; indicates relation OR.</p> <ol><li>AndFilter(TimeGt(100), TimeLt(200)) means &quot;timestamp &gt; 100 &amp;&amp; timestamp &lt; 200&quot;</li> <li>AndFilter (TimeGt(100), ValueGt(0.5)) means &quot;timestamp &gt; 100 &amp;&amp; value &gt; 0.5&quot;</li> <li>AndFilter (AndFilter (TimeGt(100), TimeLt(200)), ValueGt(0.5)) means &quot;(timestamp &gt; 100 &amp;&amp; timestamp &lt; 200) &amp;&amp; value &gt; 0.5&quot;</li> <li>OrFilter(TimeGt(100), ValueGt(0.5)) means &quot;timestamp &gt; 100 || value &gt; 0.5&quot;</li> <li>OrFilter (AndFilter(TimeGt(100), TimeLt(200)), ValueGt(0.5)) means &quot;(timestamp &gt; 100 &amp;&amp; timestamp &lt; 200) || value &gt; 0.5&quot;</li></ol> <p>The formal definition of &quot;Filter&quot;, &quot;AndFilter&quot; and &quot;OrFilter&quot; are shown below:</p> <div class="language- extra-class"><pre><code>Filter := Basic Filter | AndFilter | OrFilter
AndFilter := Filter &amp;&amp; Filter
OrFilter := Filter &amp;&amp; Filter
</code></pre></div><p>For simplicity, we symbolize Basic Filter, AndFilter and OrFilter. Note that t is a variable of type INT64, v is a variable whose type can be BOOLEAN, INT32, INT64, FLOAT, DOUBLE or BINARY。</p> <table><thead><tr><th>Name</th> <th>symbol</th> <th>Examples</th></tr></thead> <tbody><tr><td>TimeEq</td> <td>time == t</td> <td>time == 14152176545 means timestamp should be equal to 14152176545</td></tr> <tr><td>TimeGt</td> <td>time &gt; t</td> <td>time &gt; 14152176545 means timestamp should be greater than 14152176545</td></tr> <tr><td>TimeGtEq</td> <td>time &gt;= t</td> <td>time &gt;= 14152176545 means timestamp should be greater than or equal to 14152176545</td></tr> <tr><td>TimeLt</td> <td>time &lt; t</td> <td>time &lt; 14152176545 means timestamp should be less than 14152176545</td></tr> <tr><td>TimeLtEq</td> <td>time &lt;= t</td> <td>time &lt;= 14152176545 means timestamp should be less than or equal to 14152176545</td></tr> <tr><td>TimeNotEq</td> <td>time != t</td> <td>time != 14152176545 means timestamp</td></tr></tbody></table> <p>should be equal to 14152176545
ValueEq| value == v| value == 10 means value should be equal to 10
ValueGt| value &gt; v| value &gt; 100.5 means value should be greater than 100.5
ValueGtEq| value &gt;= v| value &gt;= 2 means value should be greater than or equal to 2
ValueLt| value &lt; v| value &lt; &quot;string&quot; means value should be less than &quot;string&quot; in alphabet order
ValueLtEq| value &lt;= v| value &lt;= -100 means value should be less than or equal to -100
ValueNotEq| value != v| value != true means value should not be true
AndFilter| &lt;Filter&gt; &amp;&amp; &lt;Filter&gt;| 1. value &gt; 100 &amp;&amp; value &lt; 200 means value should be greanter than 100 and less than 200; <br>2. (value &gt;= 100 &amp;&amp; value &lt;= 200) &amp;&amp; time &gt; 14152176545 means &quot;value should be greater than or equal to 100 and value should be less than or equal to&quot; and &quot;timestamp should be greater than 14152176545&quot;
OrFilter| &lt;Filter&gt; || &lt;Filter&gt;| 1. value &gt; 100 || time &gt;  14152176545, means value should be greater than 100 or timestamp should be greater than 14152176545;<br>2. (value &gt; 100 &amp;&amp; value &lt; 200)|| time &gt; 14152176545, means &quot;value should be greater than 100 and value should be less than 200&quot; or &quot;timestamp should be greater than 14152176545&quot;</p> <h3 id="_1-2-expression"><a href="#_1-2-expression" class="header-anchor">#</a> 1.2 Expression</h3> <p>When we assign a particular time series (including the timestamp) to a Filter, it becomes an expression. For example, &quot;value &gt; 10&quot; can only describe a Filter, without the taste of a query. However, &quot;the value of time series 'd1.s1' should be greater than 10&quot; is an expression. Specifically, if the Filter only works on timestamp, it can be seen as an expression, which is called GlobalTimeExpression. The following sections introduces Expression in detail,</p> <h4 id="_1-2-1-singleseriesexpression"><a href="#_1-2-1-singleseriesexpression" class="header-anchor">#</a> 1.2.1 SingleSeriesExpression</h4> <p>SingleSeriesExpression is an expression on a time series (excluding the timestamp column) with a Filter. A SingleSeriesExpression contains a Path and a Filter. The Path is the path of the time series, and the Filter indicate the filter condition, as is introduced in section 1.1.</p> <p>The structure of SingleSeriesExpression is shown below:</p> <div class="language- extra-class"><pre><code>SingleSeriesExpression
    Path: the path of the time series in the given SingleSeriesExpression
    Filter: filter condition
</code></pre></div><p>When querying, a SingleSeriesExpression claims that the data point in the time series should satisfy the constraints in the Filter.</p> <p>Examples of SingleSeriesExpression are shown below.</p> <p>Example 1.</p> <div class="language- extra-class"><pre><code>SingleSeriesExpression
    Path: &quot;d1.s1&quot;
    Filter: AndFilter(ValueGt(100), ValueLt(200))
</code></pre></div><p>The SingleSeriesExpression claims that time series &quot;d1.s1&quot; should satisfy that &quot;value should be greater than 100 and less than 200&quot;。</p> <p>We formalize the rule as SingleSeriesExpression(&quot;d1.s1&quot;, value &gt; 100 &amp;&amp; value &lt; 200)</p> <hr> <p>Example 2.</p> <div class="language- extra-class"><pre><code>SingleSeriesExpression
    Path: &quot;d1.s1&quot;
    Filter: AndFilter(AndFilter(ValueGt(100), ValueLt(200)), TimeGt(14152176545))
</code></pre></div><p>The SingleSeriesExpression claims that time series &quot;d1.s1&quot; should satisfy that &quot;value should be greater than 100 and less than 200 and timestamp should be greater than 14152176545&quot;。</p> <p>We formalize the rule as SingleSeriesExpression(&quot;d1.s1&quot;, (value &gt; 100 &amp;&amp; value &lt; 200) &amp;&amp; time &gt; 14152176545)</p> <h4 id="_1-2-2-globaltimeexpression"><a href="#_1-2-2-globaltimeexpression" class="header-anchor">#</a> 1.2.2 GlobalTimeExpression</h4> <p>GlobalTimeExpression means a global time filter. A GlobalTimeExpression contains a Filter, which is only composed of time filters (value filters not allowed). When querying, a GlobalTimeExpression claims that data points of all selected time series should satisfy the constraints in the Filter. The structure of GlobalTimeExpression is shown below:</p> <div class="language- extra-class"><pre><code>GlobalTimeExpression
    Filter: a filter which only contains time filters。
    The formalized definition of Filter here is: 
        Filter := TimeFilter | AndExpression | OrExpression
        AndExpression := Filter &amp;&amp; Filter
        OrExpression := Filter &amp;&amp; Filter
</code></pre></div><p>Some formalized examples of GlobalTimeExpression are shown below:</p> <ol><li>GlobalTimeExpression(time &gt; 14152176545 &amp;&amp; time &lt; 14152176645) claims that the all selected time series should satisfy that the timestamp should be &quot;greater than 14152176545 and less than 14152176645&quot;</li> <li>GlobalTimeExpression((time &gt; 100 &amp;&amp; time &lt; 200) || (time &gt; 400 &amp;&amp; time &lt; 500)) claims that all selected time series should satisfy that the timestamp should be &quot;greater than 100 and less than 200&quot; or &quot;greater than 400 and less than 500&quot;</li></ol> <h4 id="_1-2-3-iexpression"><a href="#_1-2-3-iexpression" class="header-anchor">#</a> 1.2.3 IExpression</h4> <p>IExpression indicates the all filters with the corresponding columns in a query.
An IExpression can be a SingleSeriesExpression or a GlobalTimeExpression. In this case, the IExpression is a UnaryExpression. An IExpression can also contains two IExpressions, connected with relation AND or OR. Two IExpressions joined with AND relation is termed as AndExpression. Likewise, two IExpressions joined with OR relation is termed as OrExpression. An IExpression containing two children is termed BinaryExpression. UnaryExpression and BinaryExpression are both IExpression.</p> <p>The formalized definition of IExpression is shown below:</p> <div class="language- extra-class"><pre><code>IExpression := SingleSeriesExpression | GlobalTimeExpression | AndExpression | OrExpression
AndExpression := IExpression &amp;&amp; IExpression
OrExpression := IExpression || IExpression
</code></pre></div><p>We use a tree-like structure to formalize an IExpression. Here are some examples.</p> <ol><li><p>An IExpression only contains a SingleSeriesExpression:</p> <div class="language- extra-class"><pre><code> IExpression(SingleSeriesExpression(&quot;d1.s1&quot;, value &gt; 100 &amp;&amp; value &lt; 200))
</code></pre></div></li> <li><p>An IExpression only contains a GlobalTimeExpression:</p> <div class="language- extra-class"><pre><code> IExpression(GlobalTimeExpression (time &gt; 14152176545 &amp;&amp; time &lt; 14152176645))
</code></pre></div></li> <li><p>An IExpression contains multiple SingleSeriesExpressions:</p> <div class="language- extra-class"><pre><code> IExpression(
     AndExpression
         SingleSeriesExpression(&quot;d1.s1&quot;, (value &gt; 100 &amp;&amp; value &lt; 200) || time &gt; 14152176645)
         SingleSeriesExpression(&quot;d1.s2&quot;, value &gt; 0.5 &amp;&amp; value &lt; 1.5)
 )
</code></pre></div><p><strong>Note</strong>: The IExpression is an AndExpression, where the time series &quot;d1.s1&quot; and &quot;d1.s2&quot; should satisfy the constraints in the Filter.</p></li> <li><p>An IExpression contains both SingleSeriesExpressions and GlobalTimeExpressions</p> <div class="language- extra-class"><pre><code> IExpression(
     AndExpression
         AndExpression
             SingleSeriesExpression(&quot;d1.s1&quot;, (value &gt; 100 &amp;&amp; value &lt; 200) || time &gt; 14152176645)
             SingleSeriesExpression(&quot;d1.s2&quot;, value &gt; 0.5 &amp;&amp; value &lt; 1.5)
         GlobalTimeExpression(time &gt; 14152176545 &amp;&amp; time &lt; 14152176645)
 )
</code></pre></div><p><strong>Note</strong>: The IExpression is an AndExpression, where the time series &quot;d1.s1&quot; and &quot;d1.s2&quot; should not only satisfy the constraints in corresponding Filters in SingleSeriesExpression, but also the constraints of the GlobalTimeExpression.</p></li></ol> <h4 id="_1-2-4-executable-expression"><a href="#_1-2-4-executable-expression" class="header-anchor">#</a> 1.2.4 Executable Expression</h4> <p>To make the query execution more comprehensible, we give the concept of executable expression. An executable expression is a particular kinds of IExpression. The IExpression customized by system user can be transformed to an executable expression by some algorithm, which will be introduced in the following sections. An executable expression is an IExpression satisfying one of the following constraints:</p> <ol><li>The IExpression is a single GlobalTimeExpression</li> <li>The IExpression is a single SingleSeriesExpression</li> <li>The IExpression is an AndExpression, whose leaf nodes are SingleSeriesExpressions</li> <li>The IExpression is an OrExpression, whose leaf nodes are SingleSeriesExpressions</li></ol> <p>The formalized definition of an executable expression is shown below:</p> <div class="language- extra-class"><pre><code>executable expression := SingleSeriesExpression| GlobalTimeExpression | AndExpression | OrExpression
AndExpression := &lt; ExpressionUNIT &gt; &amp;&amp; &lt; ExpressionUNIT &gt;
OrExpression := &lt; ExpressionUNIT &gt; || &lt; ExpressionUNIT &gt;
ExpressionUNIT := SingleSeriesExpression | AndExpression | OrExpression
</code></pre></div><p>Some examples of executable expression and non-executable expression are show below:</p> <p>Example 1:</p> <div class="language- extra-class"><pre><code>IExpression(SingleSeriesExpression(&quot;d1.s1&quot;, value &gt; 100 &amp;&amp; value &lt; 200))
</code></pre></div><p>Is an executable expression? Yes</p> <p><strong>Hint</strong>: The IExpression is a single SingleSeriesExpression, satisfying constraint 1</p> <hr> <p>Example 2:</p> <div class="language- extra-class"><pre><code>IExpression(GlobalTimeExpression (time &gt; 14152176545 &amp;&amp; time &lt; 14152176645))
</code></pre></div><p>Is an executable expression? Yes</p> <p><strong>Hint</strong>: The IExpression is a single GlobalTimeExpression, satisfying constraint 2</p> <hr> <p>Example 3:</p> <div class="language- extra-class"><pre><code>IExpression(
    AndExpression
        GlobalTimeExpression (time &gt; 14152176545)
        GlobalTimeExpression (time &lt; 14152176645)
)
</code></pre></div><p>Is an executable expression? No</p> <p><strong>Hint</strong>: The IExpression is an AndExpression, but it contains GlobalTimeExpressions, which is against constraint 3</p> <hr> <p>Example 4:</p> <div class="language- extra-class"><pre><code>IExpression(
    OrExpression
        AndExpression
            SingleSeriesExpression(&quot;d1.s1&quot;, (value &gt; 100 &amp;&amp; value &lt; 200) || time &gt; 14152176645)
            SingleSeriesExpression(&quot;d1.s2&quot;, value &gt; 0.5 &amp;&amp; value &lt; 1.5)
    SingleSeriesExpression(&quot;d1.s3&quot;, value &gt; &quot;test&quot; &amp;&amp; value &lt; &quot;test100&quot;)
)
</code></pre></div><p>Is an executable expression? Yes</p> <p><strong>Hint</strong>: The IExpression is an OrExpression, whose leaf nodes are all SingleSeriesExpressions, which satisfies constraints 4.</p> <hr> <p>Example 5:</p> <div class="language- extra-class"><pre><code>IExpression(
    AndExpression        
        AndExpression
            SingleSeriesExpression(&quot;d1.s1&quot;, (value &gt; 100 &amp;&amp; value &lt; 200) || time &gt; 14152176645)
            SingleSeriesExpression(&quot;d1.s2&quot;, value &gt; 0.5 &amp;&amp; value &lt; 1.5)
        GlobalTimeExpression(time &gt; 14152176545 &amp;&amp; time &lt; 14152176645)
)
</code></pre></div><p>Is an executable expression? No</p> <p><strong>Hint</strong>: The IExpression is an AndExpression, but one of the leaf nodes is a GlobalTimeExpression, which is against constraint 3.</p> <h4 id="_1-2-5-the-algorithm-transforming-iexpression-to-an-executable-expression"><a href="#_1-2-5-the-algorithm-transforming-iexpression-to-an-executable-expression" class="header-anchor">#</a> 1.2.5 The Algorithm Transforming IExpression to an Executable Expression</h4> <p>In this section, we introduce how to transform an IExpression to be executable.</p> <p>If an IExpression is not executable, it is either an AndExpression, or an OrExpression. Moreover, it contains both GlobalTimeExpressions and SingleSeriesExpressions. According to the definition in the preceding sections, an AndExpression or OrExpression is composed of two IExpressions, that</p> <div class="language- extra-class"><pre><code>AndExpression := &lt;IExpression&gt; AND &lt;IExpression&gt;
OrExpression := &lt;IExpression&gt; OR &lt;IExpression&gt;
</code></pre></div><p>We denote the left child and right child as LeftIExpression and RightIExpression, so that</p> <div class="language- extra-class"><pre><code>AndExpression := &lt;LeftIExpression&gt; AND &lt;RightIExpression&gt;
OrExpression := &lt;LeftIExpression&gt; OR &lt;RightIExpression&gt;
</code></pre></div><p>The declaration of the method is shown below.</p> <div class="language- extra-class"><pre><code>IExpression optimize (IExpression expression, List&lt;Path&gt; selectedSeries)

Input: The IExpression to be transformed, and the projected time series
Output: The transformed IExpression, which is executable
</code></pre></div><p>Before the introducing the optimize() method in detail, we first show how to combine two expressions or filters, which is very useful in the optimize() method.</p> <ul><li><p>combineTwoGlobalTimeExpression combines two GlobalTimeExpressions to be a single GlobalTimeExpression。</p> <p>This method receives three inputs. The declaration of the method is:</p> <div class="language- extra-class"><pre><code>  GlobalTimeExpression combineTwoGlobalTimeExpression(
      GlobalTimeExpression leftGlobalTimeExpression,
      GlobalTimeExpression rightGlobalTimeExpression,
      ExpressionType type)

  Input 1: leftGlobalTimeExpression
  Input 2: rightGlobalTimeExpression
  Input 3: type, the relation of the two expressions, which is either &quot;AND&quot; or &quot;OR&quot;

  Output: GlobalTimeExpression, which is the merged expression
</code></pre></div><p>The method contains two steps:</p> <ol><li>Denote the Filter in leftGlobalTimeExpression as filter1, in rightGlobalTimeExpression as filter2. It first merges filter1 and filter2 to be a new Filter, denoted as filter3. The method of merging two filters is shown in MergeFilter in the following section.</li> <li>Generate a new GlobalTimeExpression, and assign filter3 to be its Filter. This new GlobalTimeExpression is the result.</li></ol> <p>An example of combining two GlobalTimeExpressions is shown below.</p> <p>The three inputs are:</p> <div class="language- extra-class"><pre><code>  leftGlobalTimeExpression: GlobalTimeExpression(Filter: time &gt; 100 &amp;&amp; time &lt; 200)
  rightGlobalTimeExpression: GlobalTimeExpression(Filter: time &gt; 300 &amp;&amp; time &lt; 400)
  type: OR
</code></pre></div><p>than, the merged expression is</p> <div class="language- extra-class"><pre><code>  GlobalTimeExpression(Filter: (time &gt; 100 &amp;&amp; time &lt; 200) || (time &gt; 300 &amp;&amp; time &lt; 400))
</code></pre></div></li> <li><p>MergeFilter merges two Filters. This method receives three inputs:</p> <div class="language- extra-class"><pre><code>  Filter1: The first Filter to merge
  Filter2: The second Filter to merge
  Relation: The relation between the two Filters (either AND or OR)
</code></pre></div><p>than, the execution strategy of this method is</p> <div class="language- extra-class"><pre><code>  if relation == AND:
      return AndFilter(Filter1, Filter2)
  else if relation == OR:
      return OrFilter(Filter1, Filter2)
</code></pre></div><p>This method is implemented in <code>AndFilter and(Filter left, Filter right)</code> and <code>OrFilter or(Filter left, Filter right)</code> in class FilterFactory.</p></li> <li><p>handleOneGlobalExpression merges a GlobalTimeExpression and an IExpression to be one executable expression. The result of the method only contains SingleSeriesExpressions. The declaration of the function is shown below:</p> <div class="language- extra-class"><pre><code>  IExpression handleOneGlobalTimeExpression(
      GlobalTimeExpression globalTimeExpression,
      IExpression expression,
      List&lt;Path&gt; selectedSeries, 
      ExpressionType relation)

  Input 1: GlobalTimeExpression
  Input 2: IExpression
  Input 3: time series to project
  Input 4: the relation between the two expressions (either AND or OR)

  Output: an IExpression which is executable
</code></pre></div><p>This method first calls optimize() to transform the second input IExpression to be executable, which is recursive in view of optimize(), and then combine them in two ways.</p> <p><em>Case 1</em>: The relation between GlobalTimeExpression and the optimized IExpression is AND. In this case, denote the Filter in GlobalTimeExpression as Filter. We just need to merge the tFilter to the Filters of each SingleSeriesExpression in the IExpression。This method is implemented in <code>void addTimeFilterToQueryFilter(Filter timeFilter, IExpression expression)</code>. Here is an example:</p> <p>To combine the following GlobaLTimeFilter and IExpression where</p> <div class="language- extra-class"><pre><code>  1. GlobaLTimeFilter(tFilter)
  2. IExpression
          AndExpression
              OrExpression
                  SingleSeriesExpression(&quot;path1&quot;, filter1)
                  SingleSeriesExpression(&quot;path2&quot;, filter2)
              SingleSeriesExpression(&quot;path3&quot;, filter3)
</code></pre></div><p>The result is</p> <div class="language- extra-class"><pre><code>  IExpression
      AndExpression
          OrExpression
              SingleSeriesExpression(&quot;path1&quot;, AndFilter(filter1, tFilter))
              SingleSeriesExpression(&quot;path2&quot;, AndFilter(filter2, tFilter))
          SingleSeriesExpression(&quot;path3&quot;, AndFilter(filter3, tFilter))
</code></pre></div><p><em>Case 2</em>: The relation between GlobalTimeExpression and IExpression is OR. In this case, the merge steps include:</p> <ol><li>Analyse the projected time series, which is a set of Path. To take a query with 3 projected time series as an example, denote that projected time series as a set, PathList{path1, path2, path3}。</li> <li>Denote the Filter in GlobalTimeExpression to be tFilter. The method calls pushGlobalTimeFilterToAllSeries() to generate a corresponding SingleSeriesExpression for each Path. Set the Filters of SingleSeriesExpressions to be tFilter. Join the generated SingleSeriesExpression with OR operator to get an OrExpression, which is denoted as orExpression.</li> <li>Call mergeSecondTreeToFirstTree method to combine the nodes in IExpression with the nodes in the orExpression, which is generated from step 2. The combined structure is the result expression.</li></ol> <p>For example, to combine the following GlobalTimeFilter and IExpression using OR relation, denote the projected time series as PathList{path1, path2, path3}</p> <div class="language- extra-class"><pre><code>  1. GlobalTimeFilter(tFilter)
  2. IExpression
          AndExpression
              SingleSeriesExpression(&quot;path1&quot;, filter1)
              SingleSeriesExpression(&quot;path2&quot;, filter2)
</code></pre></div><p>the result is</p> <div class="language- extra-class"><pre><code>  IExpression
      OrExpression
          AndExpression
              SingleSeriesExpression(&quot;path1&quot;, filter1)
              SingleSeriesExpression(&quot;path2&quot;, filter2)
          OrExpression
              OrExpression
                  SingleSeriesExpression(&quot;path1&quot;, tFilter)
                  SingleSeriesExpression(&quot;path2&quot;, tFilter)
              SingleSeriesExpression(&quot;path3&quot;, tFilter)
</code></pre></div></li> <li><p>MergeIExpression combines two IExpressions to be one executable expression. This method receives three inputs, respectively</p> <div class="language- extra-class"><pre><code>  IExpression1: the first IExpression to merge
  IExpression2: the second IExpression to merge
  relation: the relation between the two IExpressions (AND or OR)
</code></pre></div><p>The strategy of the method is:</p> <div class="language- extra-class"><pre><code>  if relation == AND:
      return AndExpression(IExpression1, IExpression2)
  else if relation == OR:
      return OrExpression(IExpression1, IExpression2)
</code></pre></div></li></ul> <p>Using the above four combination methods, the steps of optimize() include:</p> <ol><li><p>If the IExpression is a UnaryExpression, (a single SingleSeriesExpression or GlobalTimeExpression), return the IExpression without any operations. Otherwise, go to step 2.</p></li> <li><p>When it reaches this step, it means that the IExpression is an AndExpression or OrExpression.</p> <p>a. If the LeftIExpression and RightIExpression both are GlobalTimeExpression, use combineTwoGlobalTimeExpression method, and output the result.</p> <p>b. If LeftIExpression is a GlobalTimeExpression, and RightIExpression is not a GlobalTimeExpression, call handleOneGlobalExpression() to combine them。</p> <p>c. If LeftIExpression is not a GlobalTimeExpression, while RightIExpression is, call handleOneGlobalExpression() to combine them.</p> <p>d. If neither LeftIExpression nor RightIExpression is a GlobalTimeExpression, recursively call optimize() method on both LeftIExpression  and RightIExpression to get the left executable expression and the right executable expression. Then use mergeIExpression method to generate a final IExpression which is executable.</p></li></ol> <h2 id="_2-query-execution-of-tsfile"><a href="#_2-query-execution-of-tsfile" class="header-anchor">#</a> 2 Query Execution of TsFile</h2> <h3 id="_2-1-design"><a href="#_2-1-design" class="header-anchor">#</a> 2.1 Design</h3> <p>The interface of TsFile on file level is intended only for queries on original data. According to the existence of value filter, the query can be divided into two groups: those without filters or only with a time filter, and those containing value filters.</p> <p>To execute the two kinds of queries, we design two query execution methods:</p> <ul><li><p>merge query</p> <p>It generates multiple readers, aligns the result in time, and returns the result set.</p></li> <li><p>join query</p> <p>According to the query conditions, it generates satisfying timestamp, which is used for generating result set.</p></li></ul> <h3 id="_2-2-three-components"><a href="#_2-2-three-components" class="header-anchor">#</a> 2.2 Three Components</h3> <h4 id="_2-2-1-fileseriesreader"><a href="#_2-2-1-fileseriesreader" class="header-anchor">#</a> 2.2.1 FileSeriesReader</h4> <p>org.apache.iotdb.tsfile.read.reader.series.FileSeriesReader</p> <p><strong>Functions</strong>: FileSeriesReader queries the data points of a time series in a file, which satisfies the filter conditions. It outputs the data points of the given time series in the given file in timestamp ascending order. There can be no filters at all.</p> <p><strong>Implementation</strong>: FileSeriesReader retrieves the Chunk information of the given time series according to the Path, it then traverses each Chunk in timestamp ascending order, and outputs the satisfying data points.</p> <h4 id="_2-2-2-fileseriesreaderbytimestamp"><a href="#_2-2-2-fileseriesreaderbytimestamp" class="header-anchor">#</a> 2.2.2 FileSeriesReaderByTimestamp</h4> <p>org.apache.iotdb.tsfile.read.reader.series.FileSeriesReaderByTimestamp</p> <p><strong>Functions</strong>: FileSeriesReaderByTimestamp queries the data points of a time series in a file, whose timestamp satisfies the timestamp constraints.</p> <p><strong>Implementation</strong>: This component provides an interface, getValueInTimestamp(long timestamp), which receives increasing timestamp value,  and outputs the data points on the time series whose timestamp is identical. If there's no such data point, the result is null.</p> <h4 id="_2-2-3-tsfiletimegenerator"><a href="#_2-2-3-tsfiletimegenerator" class="header-anchor">#</a> 2.2.3 TsFileTimeGenerator</h4> <p>org.apache.iotdb.tsfile.read.query.timegenerator.TsFileTimeGenerator</p> <p><strong>Functions</strong>: According to the filter condition, TimeGeneratorImpl generates the satisfying timestamp. It first transforms the filter conditions to be a binary tree, and recursively generate the satisfying timestamp. This component is used in executing join query.</p> <p>An executable expression contains one or nultiple SingleSeriesExpressions. The relation between two SingleSeriesExpressions is either AND or OR. Therefore, the filter in an executable expression can be transformed to a binary tree, where the leaf nodes are FileSeriesReader, and the non-leaf nodes are AndNode or OrNode. Particularly, when the expression only contains a single SingleSeriesExpression, the binary tree only has one node. The satisfying timestamp can be generated using the binary tree.</p> <p>This component provides two basic functions:</p> <ol><li><p>check if there exists a next satisfying timestamp</p></li> <li><p>get the next satisfying timestamp</p></li></ol> <h3 id="_2-3-merge-query"><a href="#_2-3-merge-query" class="header-anchor">#</a> 2.3 Merge Query</h3> <p>org.apache.iotdb.tsfile.read.query.dataset.DataSetWithoutTimeGenerator</p> <p>Suppose there are n time series. For each one of them, a FileSeriesReader will be generated. If there's a GlobalTimeExpression, the filter in it will be input to the FileSeriesReaders.</p> <p>A DataSetWithoutTimeGenerator will be generated using these FileSeriesReaders. Since each FileSeriesReader outputs data points in time stamp ascending order, we can use the idea of k-way merge to align the result data points.</p> <p>The steps include:</p> <p>(1) Create a min-heap, which stores timestamps. The min-heap is organized according to the value of the timestamp.</p> <p>(2) Initialize the min-heap. Access each FileSeriesReader once. If there's a next data point in the FileSeriesReader, add its timestamp to the min-heap. Till now, the heap contains at most one timestamp of each time series, which is the minimum in its corresponding time series.</p> <p>(3) If the size of the heap is greater than 0, take the timestamp on the top of the heap, denote it as t, and remove it from the heap, then go to step (4). If the number of the heap is 0, go to step (5).</p> <p>(4) Create a new RowRecord. In turns access each time series. When dealing with a time series, first check if there's a next data point, if it fails, set the result data point to be null. Otherwise, check if minimum timestamp in the time series is identical to t. If it is not, set the result data point to be null. Otherwise, get the data point and set it to be the result data point. If there exists a next data point after that. If it has, then set timestamp of the next data point in the time series to be its minimum timestamp. After accessing all time series, combine the result data points to form a RowRecord. Finally, go to step (3).</p> <p>(5) Terminate the process.</p> <h3 id="_2-4-join-query"><a href="#_2-4-join-query" class="header-anchor">#</a> 2.4 Join Query</h3> <p>org.apache.iotdb.tsfile.read.query.executor.ExecutorWithTimeGenerator</p> <p>Join query execution generates timestamp according to the filter conditions, and retrieves the data point on the projected time series to form a RowRecord. Main steps include;</p> <p>(1) According to QueryExpression, initialize the timestamp generation module, TimeGeneratorImpl</p> <p>(2) Generate FileSeriesReaderByTimestamp for each projected time series.</p> <p>(3) If there exists a next timestamp in the &quot;timestamp generation module&quot;, denote the timestamp t, go to step (4).Otherwise, terminate the query execution.</p> <p>(4) According to t, utilize FileSeriesReaderByTimestamp on each time series to retrieve the data point whose corresponding timestamp is t. If there's no such data point, use null to represent it.</p> <p>(5) Combine the data points in step (4) to form a RowRecord, then go to step (3) to generate another row of records.</p> <h3 id="_2-5-query-of-tsfile"><a href="#_2-5-query-of-tsfile" class="header-anchor">#</a> 2.5 Query of TsFile</h3> <p>org.apache.iotdb.tsfile.read.query.executor.TsFileExecutor</p> <p>TsFileExecutor receives a QueryExpression, execute the query and outputs the QueryDataSet。The work flow includes the following steps:</p> <p>(1) Receive a QueryExpression.</p> <p>(2) If the QueryExpression contains no filter conditions, execute merge query. If it contains any Filters, use ExpressionOptimizer to optimize the IExpression in QueryExpression. If the optimized IExpression is a GlobalTimeExpression, execute merge query. If it contains value filters, it sends a message to ExecutorWithTimeGenerator to execute join query.</p> <p>(3) Generate the QueryDataSet. It iteratively generates RowRecord and returns the results.</p> <h3 id="_2-6-related-concepts"><a href="#_2-6-related-concepts" class="header-anchor">#</a> 2.6 Related Concepts</h3> <ul><li><p>Chunk: Chunk is the storage structure of a chunk of time series. IChunkReader is for reading the content。</p></li> <li><p>ChunkMetaData: ChunkMetaData records the offset, data type and encoding info of the Chunk in the File.</p></li> <li><p>IMetadataQuerier: IMetadataQuerier is a querier for TsFile metadata. It queries the metadata of a file, and the ChunkMetaData of a time series.</p></li> <li><p>IChunkLoader:  IChunkLoader is the loader for Chunk, whose main function is getting the corresponding Chunk of the given the ChunkMetaData.</p></li> <li><p>IChunkReader: IChunkReader reads the data in a Chunk. It receives a Chunk and parse it according to the info in the ChunkHeader. It provides two interface:</p> <ul><li>hasNextSatisfiedPage &amp; nextPageData: iteratively returns a Page</li> <li>getPageReaderList: return all PageReader</li></ul></li> <li><p>IPageReader: IPageReader reads the data in a Page. It provides two interface:</p> <ul><li>getAllSatisfiedPageData(): return all satisfying values</li> <li>getStatistics(): return the statistic information of the Page</li></ul></li> <li><p>QueryExpression</p> <p>QueryExpression is the query expression, which contains the time series to project, and filter constraints.</p></li> <li><p>QueryDataSet</p> <p>The result of a query. It contains one or multiple RowRecord, which combines data points having identical time stamp together. QueryDataSet provides two interface:</p> <ul><li>check if there's a next RowRecord.</li> <li>return the next RowRecord.</li></ul></li></ul></div> <div class="page-nav"><p class="inner"><span class="prev">
        ←
        <a href="/SystemDesign/TsFile/Write.html" class="prev">
          Write
        </a></span> <span class="next"><a href="/SystemDesign/QueryEngine/QueryEngine.html">
          QueryEngine
        </a>
        →
      </span></p></div> <p style="text-align: center;">Copyright © 2021 The Apache Software Foundation.<br>
     Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p> <p style="text-align: center; margin-top: 10px; color: #444">
    Contact us: Join QQ Group 659990460 | Add friend <i>tietouqiao</i> and be invited to Wechat Group<br>
    see <a href="https://github.com/apache/iotdb/issues/1995">Join the community</a> for more</p></main></div><div class="global-ui"></div></div>
    <script src="/assets/js/app.fe44b663.js" defer></script><script src="/assets/js/3.5626571b.js" defer></script><script src="/assets/js/8.68d2fe5c.js" defer></script>
  </body>
</html>