blob: 3b41e4199b0edbeed2bf411969e66301c6192b26 [file] [log] [blame]
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title> </title>
<meta name="generator" content="VuePress 1.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/423.7c5da32e.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/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/8.68d2fe5c.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="/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.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</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="/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="/zh/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/zh/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="/UserGuide/V0.11.x/Client/Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.11.x/Client/Programming - TsFile API.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">文档</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.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</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="/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="/zh/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/zh/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="/UserGuide/V0.11.x/Client/Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.11.x/Client/Programming - TsFile API.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>IoTDB用户手册 (V0.11.x)</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"><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/UserGuide/V0.11.x/Client/Command Line Interface.html" class="sidebar-link">命令行接口(CLI)</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Programming - Native API.html" class="sidebar-link">原生接口</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Programming - JDBC.html" class="sidebar-link">JDBC</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Programming - Other Languages.html" class="sidebar-link">其他语言</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Programming - TsFile API.html" class="active sidebar-link">TsFile API</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Programming - MQTT.html" class="sidebar-link">MQTT</a></li><li><a href="/zh/UserGuide/V0.11.x/Client/Status Codes.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><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="tsfile-api"><a href="#tsfile-api" class="header-anchor">#</a> TsFile API</h1> <p>TsFile 是在 IoTDB 中使用的时间序列的文件格式。在这个章节中,我们将介绍这种文件格式的用法。</p> <h2 id="安装-tsfile-libaray"><a href="#安装-tsfile-libaray" class="header-anchor">#</a> 安装 TsFile libaray</h2> <p>在您自己的项目中有两种方法使用 TsFile .</p> <ul><li><p>使用 jar 包:</p> <ul><li><p>编译源码生成 jar 包</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/iotdb.git
cd tsfile/
mvn clean package -Dmaven.test.skip=true
</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></div></div><p>命令执行完成之后,所有的 jar 包都可以从 <code>target/</code> 目录下找到。之后您可以在自己的工程中倒入 <code>target/tsfile-0.11.1-jar-with-dependencies.jar</code>.</p></li></ul></li> <li><p>使用 Maven 依赖:</p> <p>编译源码并且部署到您的本地仓库中需要 3 步:</p> <ul><li><p>下载源码</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/iotdb.git
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>编译源码和部署到本地仓库</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>cd tsfile/
mvn clean install -Dmaven.test.skip=true
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li> <li><p>在您自己的工程中增加依赖:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> &lt;dependency&gt;
&lt;groupId&gt;org.apache.iotdb&lt;/groupId&gt;
&lt;artifactId&gt;tsfile&lt;/artifactId&gt;
&lt;version&gt;0.11.1&lt;/version&gt;
&lt;/dependency&gt;
</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></li></ul> <p>或者,您可以直接使用官方的 Maven 仓库:</p> <ul><li><p>首先,在<code>${username}\.m2\settings.xml</code>目录下的<code>settings.xml</code>文件中<code>&lt;profiles&gt;</code>
节中增加<code>&lt;profile&gt;</code>,内容如下:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> &lt;profile&gt;
&lt;id&gt;allow-snapshots&lt;/id&gt;
&lt;activation&gt;&lt;activeByDefault&gt;true&lt;/activeByDefault&gt;&lt;/activation&gt;
&lt;repositories&gt;
&lt;repository&gt;
&lt;id&gt;apache.snapshots&lt;/id&gt;
&lt;name&gt;Apache Development Snapshot Repository&lt;/name&gt;
&lt;url&gt;https://repository.apache.org/content/repositories/snapshots/&lt;/url&gt;
&lt;releases&gt;
&lt;enabled&gt;false&lt;/enabled&gt;
&lt;/releases&gt;
&lt;snapshots&gt;
&lt;enabled&gt;true&lt;/enabled&gt;
&lt;/snapshots&gt;
&lt;/repository&gt;
&lt;/repositories&gt;
&lt;/profile&gt;
</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></div></div></li> <li><p>之后您可以在您的工程中增加如下依赖:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> &lt;dependency&gt;
&lt;groupId&gt;org.apache.iotdb&lt;/groupId&gt;
&lt;artifactId&gt;tsfile&lt;/artifactId&gt;
&lt;version&gt;0.11.1&lt;/version&gt;
&lt;/dependency&gt;
</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></li></ul></li></ul> <h2 id="tsfile-的使用"><a href="#tsfile-的使用" class="header-anchor">#</a> TSFile 的使用</h2> <p>本章节演示TsFile的详细用法。</p> <h3 id="时序数据-time-series-data"><a href="#时序数据-time-series-data" class="header-anchor">#</a> 时序数据(Time-series Data)</h3> <p>一个时序是由4个序列组成,分别是 device, measurement, time, value。</p> <ul><li><p><strong>measurement</strong>: 时间序列描述的是一个物理或者形式的测量(measurement),比如:城市的温度,一些商品的销售数量或者是火车在不同时间的速度。
传统的传感器(如温度计)也采用单次测量(measurement)并产生时间序列,我们将在下面交替使用测量(measurement)和传感器。</p></li> <li><p><strong>device</strong>: 一个设备指的是一个正在进行多次测量(产生多个时间序列)的实体,例如,
​ ​ ​ 一列正在运行的火车监控它的速度、油表、它已经运行的英里数,当前的乘客每个都被传送到一个时间序列。</p></li></ul> <p>表1描述了一组时间序列数据。下表中显示的集合包含一个名为 &quot;device_1&quot; 的设备,它有三个测量值(measurement)分别是
&quot;sensor_1&quot;, &quot;sensor_2&quot; 和 &quot;sensor_3&quot;.</p> <center><table style="text-align:center;"><tr><th colspan="6">device_1</th></tr> <tr><th colspan="2">sensor_1</th><th colspan="2">sensor_2</th><th colspan="2">sensor_3</th></tr> <tr><th>time</th><th>value</th><th>time</th><th>value</th><th>time</th><th>value</th></tr> <tr><td>1</td><td>1.2</td><td>1</td><td>20</td><td>2</td><td>50</td></tr> <tr><td>3</td><td>1.4</td><td>2</td><td>20</td><td>4</td><td>51</td></tr> <tr><td>5</td><td>1.1</td><td>3</td><td>21</td><td>6</td><td>52</td></tr> <tr><td>7</td><td>1.8</td><td>4</td><td>20</td><td>8</td><td>53</td></tr></table> <span>一组时间序列数据</span></center> <p><strong>单行数据</strong>: 在许多工业应用程序中,一个设备通常包含多个传感器,这些传感器可能同时具有多个值,这称为一行数据。</p> <p>在形式上,一行数据包含一个<code>device_id</code>,它是一个时间戳,表示从 1970年1月1日 00:00:00 开始的毫秒数,
以及由<code>measurement_id</code>和相应的<code>value</code>组成的几个数据对。一行中的所有数据对都属于这个<code>device_id</code>,并且具有相同的时间戳。
如果其中一个度量值<code>measurements</code>在某个时间戳<code>timestamp</code>没有值<code>value</code>,将使用一个空格表示(实际上 TsFile 并不存储 null 值)。
其格式如下:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_id, timestamp, &lt;measurement_id, value&gt;...
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>示例数据如下所示。在本例中,两个度量值(measurement)的数据类型分别是<code>INT32</code><code>FLOAT</code></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_1, 1490860659000, m1, 10, m2, 12.12
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><h3 id="写入-tsfile"><a href="#写入-tsfile" class="header-anchor">#</a> 写入 TsFile</h3> <h4 id="生成一个-tsfile-文件"><a href="#生成一个-tsfile-文件" class="header-anchor">#</a> 生成一个 TsFile 文件</h4> <p>TsFile可以通过以下三个步骤生成,完整的代码参见&quot;写入 TsFile 示例&quot;章节。</p> <ul><li><p>首先,构造一个<code>TsFileWriter</code>实例。</p> <p>以下是可用的构造函数:</p> <ul><li>没有预定义 schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li>预定义 schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file, Schema schema) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>这个是用于使用 HDFS 文件系统的。<code>TsFileOutput</code>可以是<code>HDFSOutput</code>类的一个实例。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(TsFileOutput output, Schema schema) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>如果你想自己设置一些 TSFile 的配置,你可以使用<code>config</code>参数。比如:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig conf = new TSFileConfig();
conf.setTSFileStorageFs(&quot;HDFS&quot;);
TsFileWriter tsFileWriter = new TsFileWriter(file, schema, conf);
</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></div></div><p>在上面的例子中,数据文件将存储在 HDFS 中,而不是本地文件系统中。如果你想在本地文件系统中存储数据文件,你可以使用<code>conf.setTSFileStorageFs(&quot;LOCAL&quot;)</code>,这也是默认的配置。</p> <p>您还可以通过<code>config.setHdfsIp(...)</code><code>config.setHdfsPort(...)</code>来配置 HDFS 的 IP 和端口。默认的 IP是<code>localhost</code>,默认的<code>RPC</code>端口是<code>9000</code>.</p> <p><strong>参数:</strong></p> <ul><li><p>file : 写入 TsFile 数据的文件</p></li> <li><p>schema : 文件的 schemas,将在下章进行介绍</p></li> <li><p>config : TsFile 的一些配置项</p></li></ul></li> <li><p>第二步,添加测量值(measurement)</p> <p>你也可以先创建一个<code>Schema</code>类的实例然后把它传递给<code>TsFileWriter</code>类的构造函数</p> <p><code>Schema</code>类保存的是一个映射关系,key 是一个 measurement 的名字,value 是 measurement schema.</p> <p>下面是一系列接口:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// Create an empty Schema or from an existing map
public Schema()
public Schema(Map&lt;String, MeasurementSchema&gt; measurements)
// Use this two interfaces to add measurements
public void registerMeasurement(MeasurementSchema descriptor)
public void registerMeasurements(Map&lt;String, MeasurementSchema&gt; measurements)
// Some useful getter and checker
public TSDataType getMeasurementDataType(String measurementId)
public MeasurementSchema getMeasurementSchema(String measurementId)
public Map&lt;String, MeasurementSchema&gt; getAllMeasurementSchema()
public boolean hasMeasurement(String measurementId)
</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></div></div><p>你可以在<code>TsFileWriter</code>类中使用以下接口来添加额外的测量(measurement):
</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void addMeasurement(MeasurementSchema measurementSchema) throws WriteProcessException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><code>MeasurementSchema</code>类保存了一个测量(measurement)的信息,有几个构造函数:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding)
public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType)
public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType,
Map&lt;String, String&gt; props)
</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></div></div><p><strong>参数:</strong>
</p> <ul><li><p>measurementID: 测量的名称,通常是传感器的名称。</p></li> <li><p>type: 数据类型,现在支持六种类型: <code>BOOLEAN</code>, <code>INT32</code>, <code>INT64</code>, <code>FLOAT</code>, <code>DOUBLE</code>, <code>TEXT</code>;</p></li> <li><p>encoding: 编码类型. 参见 <a href="/zh/UserGuide/V0.11.x/Concept/Encoding.html">Chapter 2-3</a>.</p></li> <li><p>compression: 压缩方式. 现在支持 <code>UNCOMPRESSED</code><code>SNAPPY</code>.</p></li> <li><p>props: 特殊数据类型的属性。比如说<code>FLOAT</code><code>DOUBLE</code>可以设置<code>max_point_number</code><code>TEXT</code>可以设置<code>max_string_length</code>
可以使用Map来保存键值对,比如(&quot;max_point_number&quot;, &quot;3&quot;)。</p></li></ul> <blockquote><p><strong>注意:</strong> 虽然一个测量(measurement)的名字可以被用在多个deltaObjects中, 但是它的参数是不允许被修改的。比如:
不允许多次为同一个测量(measurement)名添加不同类型的编码。下面是一个错误示例:</p></blockquote> <div class="language- extra-class"><pre><code> // The measurement &quot;sensor_1&quot; is float type
addMeasurement(new MeasurementSchema(&quot;sensor_1&quot;, TSDataType.FLOAT, TSEncoding.RLE));
// This call will throw a WriteProcessException exception
addMeasurement(new MeasurementSchema(&quot;sensor_1&quot;, TSDataType.INT32, TSEncoding.RLE));
</code></pre></div></li> <li><p>第三,插入和写入数据。</p> <p>使用这个接口创建一个新的<code>TSRecord</code>(时间戳和设备对)。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TSRecord(long timestamp, String deviceId)
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>然后创建一个<code>DataPoint</code>(度量(measurement)和值的对应),并使用 addTuple 方法将数据 DataPoint 添加正确的值到 TsRecord。</p> <p>用下面这种方法写</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void write(TSRecord record) throws IOException, WriteProcessException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>最后,调用<code>close</code>方法来完成写入过程。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void close() throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li></ul> <p>我们也支持将数据写入已关闭的 TsFile 文件中。</p> <ul><li>使用<code>ForceAppendTsFileWriter</code>打开已经关闭的文件。</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public ForceAppendTsFileWriter(File file) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li><p>调用 <code>doTruncate</code> 去掉文件的Metadata部分</p></li> <li><p>然后使用 <code>ForceAppendTsFileWriter</code> 构造另一个<code>TsFileWriter</code></p></li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(TsFileIOWriter fileWriter) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>请注意 此时需要重新添加测量值(measurement) 再进行上述写入操作。</p> <h4 id="写入-tsfile-示例"><a href="#写入-tsfile-示例" class="header-anchor">#</a> 写入 TsFile 示例</h4> <p>您需要安装 TsFile 到本地的 Maven 仓库中。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>mvn clean install -pl tsfile -am -DskipTests
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>如果存在<strong>非对齐</strong>的时序数据(比如:不是所有的传感器都有值),您可以通过构造<strong>TSRecord</strong>来写入。</p> <p>更详细的例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithTSRecord.java</code>中查看</p> <p>如果所有时序数据都是<strong>对齐</strong>的,您可以通过构造<strong>Tablet</strong>来写入数据。</p> <p>更详细的例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithTablet.java</code>中查看</p> <p>在已关闭的TsFile 文件中写入新数据的详细例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileForceAppendWrite.java</code>中查看</p> <h3 id="读取-tsfile-接口"><a href="#读取-tsfile-接口" class="header-anchor">#</a> 读取 TsFile 接口</h3> <h4 id="开始之前"><a href="#开始之前" class="header-anchor">#</a> 开始之前</h4> <p>&quot;时序数据&quot;章节中的数据集在本章节做具体的介绍。下表中显示的集合包含一个名为&quot;device_1&quot;的 deltaObject,包含了 3 个名为&quot;sensor_1&quot;,&quot;sensor_2&quot;和&quot;sensor_3&quot;的测量(measurement)。
测量值被简化成一个简单的例子,每条数据只包含 4 条时间和值的对应数据。</p> <center><table style="text-align:center;"><tr><th colspan="6">device_1</th></tr> <tr><th colspan="2">sensor_1</th><th colspan="2">sensor_2</th><th colspan="2">sensor_3</th></tr> <tr><th>time</th><th>value</th><th>time</th><th>value</th><th>time</th><th>value</th></tr> <tr><td>1</td><td>1.2</td><td>1</td><td>20</td><td>2</td><td>50</td></tr> <tr><td>3</td><td>1.4</td><td>2</td><td>20</td><td>4</td><td>51</td></tr> <tr><td>5</td><td>1.1</td><td>3</td><td>21</td><td>6</td><td>52</td></tr> <tr><td>7</td><td>1.8</td><td>4</td><td>20</td><td>8</td><td>53</td></tr></table> <span>一组时间序列数据</span></center> <h4 id="路径的定义"><a href="#路径的定义" class="header-anchor">#</a> 路径的定义</h4> <p>路径是一个点(.)分隔的字符串,它唯一地标识 TsFile 中的时间序列,例如:&quot;root.area_1.device_1.sensor_1&quot;。
最后一部分&quot;sensor_1&quot;称为&quot;measurementId&quot;,其余部分&quot;root.area_1.device_1&quot;称为deviceId。
正如之前提到的,不同设备中的相同测量(measurement)具有相同的数据类型和编码,设备也是唯一的。</p> <p>在read接口中,参数<code>paths</code>表示要选择的测量值(measurement)。
Path实例可以很容易地通过类<code>Path</code>来构造。例如:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>Path p = new Path(&quot;device_1.sensor_1&quot;);
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>我们可以为查询传递一个 ArrayList 路径,以支持多个路径查询。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>List&lt;Path&gt; paths = new ArrayList&lt;Path&gt;();
paths.add(new Path(&quot;device_1.sensor_1&quot;));
paths.add(new Path(&quot;device_1.sensor_3&quot;));
</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></div></div><blockquote><p><strong>注意:</strong> 在构造路径时,参数的格式应该是一个点(.)分隔的字符串,最后一部分是measurement,其余部分确认为deviceId。</p></blockquote> <h4 id="定义-filter"><a href="#定义-filter" class="header-anchor">#</a> 定义 Filter</h4> <h5 id="使用条件过滤"><a href="#使用条件过滤" class="header-anchor">#</a> 使用条件过滤</h5> <p>在 TsFile 读取过程中使用 Filter 来选择满足一个或多个给定条件的数据。</p> <h4 id="iexpression"><a href="#iexpression" class="header-anchor">#</a> IExpression</h4> <p><code>IExpression</code>是一个过滤器表达式接口,它将被传递给系统查询时调用。
我们创建一个或多个筛选器表达式,并且可以使用<code>Binary Filter Operators</code>将它们连接形成最终表达式。</p> <ul><li><p><strong>创建一个Filter表达式</strong></p> <p>有两种类型的过滤器。</p> <ul><li><p>TimeFilter: 使用时序数据中的<code>time</code>过滤。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter);
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>使用以下关系获得一个<code>TimeFilter</code>对象(值是一个 long 型变量)。
<center><table style="text-align:center;"><tr><th>Relationship</th><th>Description</th></tr> <tr><td>TimeFilter.eq(value)</td><td>选择时间等于值的数据</td></tr> <tr><td>TimeFilter.lt(value)</td><td>选择时间小于值的数据</td></tr> <tr><td>TimeFilter.gt(value)</td><td>选择时间大于值的数据</td></tr> <tr><td>TimeFilter.ltEq(value)</td><td>选择时间小于等于值的数据</td></tr> <tr><td>TimeFilter.gtEq(value)</td><td>选择时间大于等于值的数据</td></tr> <tr><td>TimeFilter.notEq(value)</td><td>选择时间不等于值的数据</td></tr> <tr><td>TimeFilter.not(TimeFilter)</td><td>选择时间不满足另一个时间过滤器的数据</td></tr></table></center></p></li> <li><p>ValueFilter: 使用时序数据中的<code>value</code>过滤。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression valueFilterExpr = new SingleSeriesExpression(Path, ValueFilter);
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><code>ValueFilter</code>的用法与<code>TimeFilter</code>相同,只是需要确保值的类型等于measurement(在路径中定义)的类型。</p></li></ul></li> <li><p><strong>Binary Filter Operators</strong></p> <p>Binary filter operators 可以用来连接两个单独的表达式。</p> <ul><li>BinaryExpression.and(Expression, Expression): 选择同时满足两个表达式的数据。</li> <li>BinaryExpression.or(Expression, Expression): 选择满足任意一个表达式值的数据。</li></ul></li></ul> <h5 id="filter-expression-示例"><a href="#filter-expression-示例" class="header-anchor">#</a> Filter Expression 示例</h5> <ul><li><p><strong>TimeFilterExpression 示例</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.eq(15)); // series time = 15
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.ltEq(15)); // series time &lt;= 15
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.lt(15)); // series time &lt; 15
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.gtEq(15)); // series time &gt;= 15
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.notEq(15)); // series time != 15
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = BinaryExpression.and(new GlobalTimeExpression(TimeFilter.gtEq(15L)),
new GlobalTimeExpression(TimeFilter.lt(25L))); // 15 &lt;= series time &lt; 25
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = BinaryExpression.or(new GlobalTimeExpression(TimeFilter.gtEq(15L)),
new GlobalTimeExpression(TimeFilter.lt(25L))); // series time &gt;= 15 or series time &lt; 25
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li></ul> <h4 id="读取接口"><a href="#读取接口" class="header-anchor">#</a> 读取接口</h4> <p>首先,我们打开 TsFile 并从文件路径<code>path</code>中获取一个<code>ReadOnlyTsFile</code>实例。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TsFileSequenceReader reader = new TsFileSequenceReader(path);
ReadOnlyTsFile readTsFile = new ReadOnlyTsFile(reader);
</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></div></div><p>接下来,我们准备路径数组和查询表达式,然后通过这个接口得到最终的<code>QueryExpression</code>对象:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>QueryExpression queryExpression = QueryExpression.create(paths, statement);
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>ReadOnlyTsFile类有两个<code>query</code>方法来执行查询。</p> <ul><li><p><strong>Method 1</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p><strong>Method 2</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression, long partitionStartOffset, long partitionEndOffset) throws IOException
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>此方法是为高级应用(如 TsFile-Spark 连接器)设计的。</p> <ul><li><strong>参数</strong> : 对于 method 2,添加了两个额外的参数来支持部分查询(Partial Query):
<ul><li><code>partitionStartOffset</code>: TsFile 的开始偏移量</li> <li><code>partitionEndOffset</code>: TsFile 的结束偏移量
</li></ul> <blockquote><p><strong>什么是部分查询?</strong></p> <p>在一些分布式文件系统中(比如:HDFS), 文件被分成几个部分,这些部分被称为&quot;Blocks&quot;并存储在不同的节点中。在涉及的每个节点上并行执行查询可以提高效率。因此需要部分查询(Partial Query)。部分查询(Partial Query)仅支持查询 TsFile 中被<code>QueryConstant.PARTITION_START_OFFSET</code><code>QueryConstant.PARTITION_END_OFFSET</code>分割的部分。</p></blockquote></li></ul></li></ul> <h3 id="querydataset-接口"><a href="#querydataset-接口" class="header-anchor">#</a> QueryDataset 接口</h3> <p>上面执行的查询将返回一个<code>QueryDataset</code>对象。</p> <p>下面是一些用户常用的接口:</p> <ul><li><p><code>bool hasNext();</code></p> <p>如果该数据集仍然有数据,则返回true。</p></li> <li><p><code>List&lt;Path&gt; getPaths()</code></p> <p>获取这个数据集中的路径。</p></li> <li><p><code>List&lt;TSDataType&gt; getDataTypes();</code></p> <p>获取数据类型。TSDataType 是一个 enum 类,其值如下:</p> <div class="language- extra-class"><pre><code> BOOLEAN,
INT32,
INT64,
FLOAT,
DOUBLE,
TEXT;
</code></pre></div></li> <li><p><code>RowRecord next() throws IOException;</code></p> <p>获取下一条记录。</p> <p><code>RowRecord</code>类包含一个<code>long</code>类型的时间戳和一个<code>List&lt;Field&gt;</code>,用于不同传感器中的数据,我们可以使用两个getter方法来获取它们。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>long getTimestamp();
List&lt;Field&gt; getFields();
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><p>要从一个字段获取数据,请使用以下方法:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSDataType getDataType();
Object getObjectValue();
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li></ul> <h4 id="读取现有-tsfile-示例"><a href="#读取现有-tsfile-示例" class="header-anchor">#</a> 读取现有 TsFile 示例</h4> <p>您需要安装 TsFile 到本地的 Maven 仓库中。</p> <p>有关查询语句的更详细示例,请参见
<code>/tsfile/example/src/main/java/org/apache/iotdb/tsfile/TsFileRead.java</code></p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">package</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>io<span class="token punctuation">.</span></span><span class="token class-name">IOException</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>util<span class="token punctuation">.</span></span><span class="token class-name">ArrayList</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>common<span class="token punctuation">.</span></span><span class="token class-name">Path</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">IExpression</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">QueryExpression</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">BinaryExpression</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">GlobalTimeExpression</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">SingleSeriesExpression</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">TimeFilter</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">ValueFilter</span><span class="token punctuation">;</span>
<span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>query<span class="token punctuation">.</span>dataset<span class="token punctuation">.</span></span><span class="token class-name">QueryDataSet</span><span class="token punctuation">;</span>
<span class="token comment">/**
* The class is to show how to read TsFile file named &quot;test.tsfile&quot;.
* The TsFile file &quot;test.tsfile&quot; is generated from class TsFileWrite.
* Run TsFileWrite to generate the test.tsfile first
*/</span>
<span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileRead</span> <span class="token punctuation">{</span>
<span class="token keyword">private</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">queryAndPrint</span><span class="token punctuation">(</span><span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation">&lt;</span><span class="token class-name">Path</span><span class="token punctuation">&gt;</span></span> paths<span class="token punctuation">,</span> <span class="token class-name">ReadOnlyTsFile</span> readTsFile<span class="token punctuation">,</span> <span class="token class-name">IExpression</span> statement<span class="token punctuation">)</span>
<span class="token keyword">throws</span> <span class="token class-name">IOException</span> <span class="token punctuation">{</span>
<span class="token class-name">QueryExpression</span> queryExpression <span class="token operator">=</span> <span class="token class-name">QueryExpression</span><span class="token punctuation">.</span><span class="token function">create</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> statement<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token class-name">QueryDataSet</span> queryDataSet <span class="token operator">=</span> readTsFile<span class="token punctuation">.</span><span class="token function">query</span><span class="token punctuation">(</span>queryExpression<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">while</span> <span class="token punctuation">(</span>queryDataSet<span class="token punctuation">.</span><span class="token function">hasNext</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token class-name">System</span><span class="token punctuation">.</span>out<span class="token punctuation">.</span><span class="token function">println</span><span class="token punctuation">(</span>queryDataSet<span class="token punctuation">.</span><span class="token function">next</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token class-name">System</span><span class="token punctuation">.</span>out<span class="token punctuation">.</span><span class="token function">println</span><span class="token punctuation">(</span><span class="token string">&quot;------------&quot;</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">main</span><span class="token punctuation">(</span><span class="token class-name">String</span><span class="token punctuation">[</span><span class="token punctuation">]</span> args<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> <span class="token punctuation">{</span>
<span class="token comment">// file path</span>
<span class="token class-name">String</span> path <span class="token operator">=</span> <span class="token string">&quot;test.tsfile&quot;</span><span class="token punctuation">;</span>
<span class="token comment">// create reader and get the readTsFile interface</span>
<span class="token class-name">TsFileSequenceReader</span> reader <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token class-name">ReadOnlyTsFile</span> readTsFile <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">(</span>reader<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// use these paths(all sensors) for all the queries</span>
<span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation">&lt;</span><span class="token class-name">Path</span><span class="token punctuation">&gt;</span></span> paths <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation">&lt;</span><span class="token punctuation">&gt;</span></span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">&quot;device_1.sensor_1&quot;</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">&quot;device_1.sensor_2&quot;</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">&quot;device_1.sensor_3&quot;</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// no query statement</span>
<span class="token function">queryAndPrint</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> readTsFile<span class="token punctuation">,</span> <span class="token keyword">null</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">//close the reader when you left</span>
reader<span class="token punctuation">.</span><span class="token function">close</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token punctuation">}</span>
</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><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br></div></div><h2 id="修改-tsfile-配置项"><a href="#修改-tsfile-配置项" class="header-anchor">#</a> 修改 TsFile 配置项</h2> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig config = TSFileDescriptor.getInstance().getConfig();
config.setXXX();
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></div> <div class="page-nav"><p class="inner"><span class="prev">
<a href="/zh/UserGuide/V0.11.x/Client/Programming - Other Languages.html" class="prev">
其他语言
</a></span> <span class="next"><a href="/zh/UserGuide/V0.11.x/Client/Programming - MQTT.html">
MQTT
</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/423.7c5da32e.js" defer></script>
</body>
</html>