blob: d8e650bdbfdaa8bf37ab38ce32b101ad3d0e5394 [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.0">
<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.ee74b34d.css" as="style"><link rel="preload" href="/assets/js/app.d9cc7506.js" as="script"><link rel="preload" href="/assets/js/3.80bccc99.js" as="script"><link rel="preload" href="/assets/js/505.161aba34.js" as="script"><link rel="prefetch" href="/assets/js/10.80a35593.js"><link rel="prefetch" href="/assets/js/100.29307610.js"><link rel="prefetch" href="/assets/js/101.84b87686.js"><link rel="prefetch" href="/assets/js/102.37515932.js"><link rel="prefetch" href="/assets/js/103.011a72fd.js"><link rel="prefetch" href="/assets/js/104.09eb9775.js"><link rel="prefetch" href="/assets/js/105.ccd8f6e3.js"><link rel="prefetch" href="/assets/js/106.db6f9772.js"><link rel="prefetch" href="/assets/js/107.f12bae08.js"><link rel="prefetch" href="/assets/js/108.36eaa3ca.js"><link rel="prefetch" href="/assets/js/109.9392d338.js"><link rel="prefetch" href="/assets/js/11.b40295cb.js"><link rel="prefetch" href="/assets/js/110.746fc2dd.js"><link rel="prefetch" href="/assets/js/111.30347dd7.js"><link rel="prefetch" href="/assets/js/112.e57be679.js"><link rel="prefetch" href="/assets/js/113.78ce2512.js"><link rel="prefetch" href="/assets/js/114.5e6b6117.js"><link rel="prefetch" href="/assets/js/115.c6f8ac11.js"><link rel="prefetch" href="/assets/js/116.4a979791.js"><link rel="prefetch" href="/assets/js/117.f87a5f70.js"><link rel="prefetch" href="/assets/js/118.87fffc4a.js"><link rel="prefetch" href="/assets/js/119.094fc5e5.js"><link rel="prefetch" href="/assets/js/12.5cf6d2f2.js"><link rel="prefetch" href="/assets/js/120.5c90ad93.js"><link rel="prefetch" href="/assets/js/121.f46b9754.js"><link rel="prefetch" href="/assets/js/122.9e66dff8.js"><link rel="prefetch" href="/assets/js/123.aab808d5.js"><link rel="prefetch" href="/assets/js/124.0fa0a704.js"><link rel="prefetch" href="/assets/js/125.cd188835.js"><link rel="prefetch" href="/assets/js/126.6781edbb.js"><link rel="prefetch" href="/assets/js/127.8a5dacf9.js"><link rel="prefetch" href="/assets/js/128.250af776.js"><link rel="prefetch" href="/assets/js/129.5fa09bd7.js"><link rel="prefetch" href="/assets/js/13.b084c298.js"><link rel="prefetch" href="/assets/js/130.dff7c833.js"><link rel="prefetch" href="/assets/js/131.dbed4491.js"><link rel="prefetch" href="/assets/js/132.94aebf3f.js"><link rel="prefetch" href="/assets/js/133.60096d96.js"><link rel="prefetch" href="/assets/js/134.2cb0fd64.js"><link rel="prefetch" href="/assets/js/135.3843f719.js"><link rel="prefetch" href="/assets/js/136.e000899f.js"><link rel="prefetch" href="/assets/js/137.e02bf420.js"><link rel="prefetch" href="/assets/js/138.00096705.js"><link rel="prefetch" href="/assets/js/139.6dfb90c2.js"><link rel="prefetch" href="/assets/js/14.680b51a0.js"><link rel="prefetch" href="/assets/js/140.4b841561.js"><link rel="prefetch" href="/assets/js/141.17959db2.js"><link rel="prefetch" href="/assets/js/142.75dca561.js"><link rel="prefetch" href="/assets/js/143.860a29ab.js"><link rel="prefetch" href="/assets/js/144.9232bb52.js"><link rel="prefetch" href="/assets/js/145.938707c6.js"><link rel="prefetch" href="/assets/js/146.14f25b0d.js"><link rel="prefetch" href="/assets/js/147.b39169b9.js"><link rel="prefetch" href="/assets/js/148.da8b154a.js"><link rel="prefetch" href="/assets/js/149.ae294204.js"><link rel="prefetch" href="/assets/js/15.0fca6080.js"><link rel="prefetch" href="/assets/js/150.d9b60101.js"><link rel="prefetch" href="/assets/js/151.8d95f72e.js"><link rel="prefetch" href="/assets/js/152.c88d8c4a.js"><link rel="prefetch" href="/assets/js/153.12ef5281.js"><link rel="prefetch" href="/assets/js/154.0e2c7525.js"><link rel="prefetch" href="/assets/js/155.5f28d43a.js"><link rel="prefetch" href="/assets/js/156.c4e3c8ae.js"><link rel="prefetch" href="/assets/js/157.c8b11122.js"><link rel="prefetch" href="/assets/js/158.ad5a2f6c.js"><link rel="prefetch" href="/assets/js/159.bfb4ef4b.js"><link rel="prefetch" href="/assets/js/16.6088831f.js"><link rel="prefetch" href="/assets/js/160.74bb1bcf.js"><link rel="prefetch" href="/assets/js/161.bda36937.js"><link rel="prefetch" href="/assets/js/162.ab1a4693.js"><link rel="prefetch" href="/assets/js/163.6c460d63.js"><link rel="prefetch" href="/assets/js/164.96fc6e66.js"><link rel="prefetch" href="/assets/js/165.9a0966f4.js"><link rel="prefetch" href="/assets/js/166.773e1acb.js"><link rel="prefetch" href="/assets/js/167.2bd1f0cb.js"><link rel="prefetch" href="/assets/js/168.7ee9f8be.js"><link rel="prefetch" href="/assets/js/169.54b0f8d6.js"><link rel="prefetch" href="/assets/js/17.5b70367e.js"><link rel="prefetch" href="/assets/js/170.414b10d4.js"><link rel="prefetch" href="/assets/js/171.0a9d8a72.js"><link rel="prefetch" href="/assets/js/172.8c216fc8.js"><link rel="prefetch" href="/assets/js/173.b9f9473b.js"><link rel="prefetch" href="/assets/js/174.7ffef574.js"><link rel="prefetch" href="/assets/js/175.a3d7792a.js"><link rel="prefetch" href="/assets/js/176.bb8a8976.js"><link rel="prefetch" href="/assets/js/177.9a4de069.js"><link rel="prefetch" href="/assets/js/178.2f71b1da.js"><link rel="prefetch" href="/assets/js/179.191120ea.js"><link rel="prefetch" href="/assets/js/18.39a8fcd1.js"><link rel="prefetch" href="/assets/js/180.cda00622.js"><link rel="prefetch" href="/assets/js/181.085c1615.js"><link rel="prefetch" href="/assets/js/182.23c62aee.js"><link rel="prefetch" href="/assets/js/183.ea978fdc.js"><link rel="prefetch" href="/assets/js/184.5472c48d.js"><link rel="prefetch" href="/assets/js/185.e75fb32f.js"><link rel="prefetch" href="/assets/js/186.a2d96522.js"><link rel="prefetch" href="/assets/js/187.0a5d6141.js"><link rel="prefetch" href="/assets/js/188.0e3fd7e5.js"><link rel="prefetch" href="/assets/js/189.3d4d4d99.js"><link rel="prefetch" href="/assets/js/19.95e7ac77.js"><link rel="prefetch" href="/assets/js/190.48851103.js"><link rel="prefetch" href="/assets/js/191.3b731f2d.js"><link rel="prefetch" href="/assets/js/192.268a49ec.js"><link rel="prefetch" href="/assets/js/193.464e27ed.js"><link rel="prefetch" href="/assets/js/194.f3f3e0c2.js"><link rel="prefetch" href="/assets/js/195.3e4bb7bd.js"><link rel="prefetch" href="/assets/js/196.ecd02482.js"><link rel="prefetch" href="/assets/js/197.1377932a.js"><link rel="prefetch" href="/assets/js/198.7154f4c1.js"><link rel="prefetch" href="/assets/js/199.26d62d4b.js"><link rel="prefetch" href="/assets/js/20.c3c8808d.js"><link rel="prefetch" href="/assets/js/200.8687a88a.js"><link rel="prefetch" href="/assets/js/201.e54d5766.js"><link rel="prefetch" href="/assets/js/202.4472228b.js"><link rel="prefetch" href="/assets/js/203.d505eb7e.js"><link rel="prefetch" href="/assets/js/204.3d563a59.js"><link rel="prefetch" href="/assets/js/205.b4f4e689.js"><link rel="prefetch" href="/assets/js/206.e36c8ffc.js"><link rel="prefetch" href="/assets/js/207.2519b61f.js"><link rel="prefetch" href="/assets/js/208.15f562db.js"><link rel="prefetch" href="/assets/js/209.29a6a227.js"><link rel="prefetch" href="/assets/js/21.5b501017.js"><link rel="prefetch" href="/assets/js/210.bafb594c.js"><link rel="prefetch" href="/assets/js/211.a94f7694.js"><link rel="prefetch" href="/assets/js/212.1e9c044f.js"><link rel="prefetch" href="/assets/js/213.e67866a3.js"><link rel="prefetch" href="/assets/js/214.9b2a7c16.js"><link rel="prefetch" href="/assets/js/215.7cbb5cb1.js"><link rel="prefetch" href="/assets/js/216.a1b727a5.js"><link rel="prefetch" href="/assets/js/217.fa5676c4.js"><link rel="prefetch" href="/assets/js/218.55f116ca.js"><link rel="prefetch" href="/assets/js/219.4365ec9c.js"><link rel="prefetch" href="/assets/js/22.cec2c78d.js"><link rel="prefetch" href="/assets/js/220.682d5822.js"><link rel="prefetch" href="/assets/js/221.1f025987.js"><link rel="prefetch" href="/assets/js/222.dd9493f5.js"><link rel="prefetch" href="/assets/js/223.7b621666.js"><link rel="prefetch" href="/assets/js/224.8619ae80.js"><link rel="prefetch" href="/assets/js/225.35e0690e.js"><link rel="prefetch" href="/assets/js/226.797af735.js"><link rel="prefetch" href="/assets/js/227.4da2beda.js"><link rel="prefetch" href="/assets/js/228.613cf85b.js"><link rel="prefetch" href="/assets/js/229.015afe80.js"><link rel="prefetch" href="/assets/js/23.04c35184.js"><link rel="prefetch" href="/assets/js/230.ee4a4ccc.js"><link rel="prefetch" href="/assets/js/231.4a94af31.js"><link rel="prefetch" href="/assets/js/232.0814df8e.js"><link rel="prefetch" href="/assets/js/233.461f3d80.js"><link rel="prefetch" href="/assets/js/234.e51f339c.js"><link rel="prefetch" href="/assets/js/235.823536b0.js"><link rel="prefetch" href="/assets/js/236.82fee8ce.js"><link rel="prefetch" href="/assets/js/237.fb2f9040.js"><link rel="prefetch" href="/assets/js/238.ec71fa9d.js"><link rel="prefetch" href="/assets/js/239.e2214f9c.js"><link rel="prefetch" href="/assets/js/24.a2dd602c.js"><link rel="prefetch" href="/assets/js/240.d556e0f7.js"><link rel="prefetch" href="/assets/js/241.f31e8bb6.js"><link rel="prefetch" href="/assets/js/242.d077a307.js"><link rel="prefetch" href="/assets/js/243.fb61381c.js"><link rel="prefetch" href="/assets/js/244.2b12dfe2.js"><link rel="prefetch" href="/assets/js/245.610d8945.js"><link rel="prefetch" href="/assets/js/246.72a47374.js"><link rel="prefetch" href="/assets/js/247.32483d04.js"><link rel="prefetch" href="/assets/js/248.b9475d52.js"><link rel="prefetch" href="/assets/js/249.c0d83a33.js"><link rel="prefetch" href="/assets/js/25.ffc84b8b.js"><link rel="prefetch" href="/assets/js/250.bcd7ab2d.js"><link rel="prefetch" href="/assets/js/251.2300231d.js"><link rel="prefetch" href="/assets/js/252.7af848b7.js"><link rel="prefetch" href="/assets/js/253.07764dda.js"><link rel="prefetch" href="/assets/js/254.ab83d768.js"><link rel="prefetch" href="/assets/js/255.e24b297f.js"><link rel="prefetch" href="/assets/js/256.8aabebf6.js"><link rel="prefetch" href="/assets/js/257.02ec1397.js"><link rel="prefetch" href="/assets/js/258.5c791441.js"><link rel="prefetch" href="/assets/js/259.e0d45a83.js"><link rel="prefetch" href="/assets/js/26.bd99cb2f.js"><link rel="prefetch" href="/assets/js/260.f0433ae0.js"><link rel="prefetch" href="/assets/js/261.a15382ed.js"><link rel="prefetch" href="/assets/js/262.ecfa17a0.js"><link rel="prefetch" href="/assets/js/263.348604b8.js"><link rel="prefetch" href="/assets/js/264.9f12f8a7.js"><link rel="prefetch" href="/assets/js/265.c28d73bc.js"><link rel="prefetch" href="/assets/js/266.76f172c6.js"><link rel="prefetch" href="/assets/js/267.7db005e7.js"><link rel="prefetch" href="/assets/js/268.6cdc4ef3.js"><link rel="prefetch" href="/assets/js/269.d083cb4a.js"><link rel="prefetch" href="/assets/js/27.35c06c5f.js"><link rel="prefetch" href="/assets/js/270.8ea29a77.js"><link rel="prefetch" href="/assets/js/271.9e49eaab.js"><link rel="prefetch" href="/assets/js/272.e80a9ae1.js"><link rel="prefetch" href="/assets/js/273.9d2a702e.js"><link rel="prefetch" href="/assets/js/274.6191344b.js"><link rel="prefetch" href="/assets/js/275.12b58866.js"><link rel="prefetch" href="/assets/js/276.9fad3dfc.js"><link rel="prefetch" href="/assets/js/277.13d2e020.js"><link rel="prefetch" href="/assets/js/278.394d3d54.js"><link rel="prefetch" href="/assets/js/279.79f09838.js"><link rel="prefetch" href="/assets/js/28.7574ef02.js"><link rel="prefetch" href="/assets/js/280.656a6ef0.js"><link rel="prefetch" href="/assets/js/281.eb62dae4.js"><link rel="prefetch" href="/assets/js/282.04611e50.js"><link rel="prefetch" href="/assets/js/283.f42fe888.js"><link rel="prefetch" href="/assets/js/284.0fad2c05.js"><link rel="prefetch" href="/assets/js/285.1f676ba9.js"><link rel="prefetch" href="/assets/js/286.0cc6f7bb.js"><link rel="prefetch" href="/assets/js/287.224e3bf6.js"><link rel="prefetch" href="/assets/js/288.1f960f70.js"><link rel="prefetch" href="/assets/js/289.9d717a63.js"><link rel="prefetch" href="/assets/js/29.069cf689.js"><link rel="prefetch" href="/assets/js/290.20bd76d8.js"><link rel="prefetch" href="/assets/js/291.7d6cb2ea.js"><link rel="prefetch" href="/assets/js/292.6f4dd608.js"><link rel="prefetch" href="/assets/js/293.e1c6922e.js"><link rel="prefetch" href="/assets/js/294.b02e5e9a.js"><link rel="prefetch" href="/assets/js/295.20f2357a.js"><link rel="prefetch" href="/assets/js/296.5f2858cb.js"><link rel="prefetch" href="/assets/js/297.af73719b.js"><link rel="prefetch" href="/assets/js/298.52665684.js"><link rel="prefetch" href="/assets/js/299.88cf9bfa.js"><link rel="prefetch" href="/assets/js/30.d9ae5fd3.js"><link rel="prefetch" href="/assets/js/300.487dad4d.js"><link rel="prefetch" href="/assets/js/301.50bd366c.js"><link rel="prefetch" href="/assets/js/302.7b6d2802.js"><link rel="prefetch" href="/assets/js/303.be946d30.js"><link rel="prefetch" href="/assets/js/304.042b56b8.js"><link rel="prefetch" href="/assets/js/305.aa067d8b.js"><link rel="prefetch" href="/assets/js/306.feefcae4.js"><link rel="prefetch" href="/assets/js/307.75944907.js"><link rel="prefetch" href="/assets/js/308.202cd94c.js"><link rel="prefetch" href="/assets/js/309.288abe02.js"><link rel="prefetch" href="/assets/js/31.bcb345d3.js"><link rel="prefetch" href="/assets/js/310.79c19387.js"><link rel="prefetch" href="/assets/js/311.06cc4ee5.js"><link rel="prefetch" href="/assets/js/312.ea271688.js"><link rel="prefetch" href="/assets/js/313.2db3a3bc.js"><link rel="prefetch" href="/assets/js/314.c8206fa8.js"><link rel="prefetch" href="/assets/js/315.e2b4aefd.js"><link rel="prefetch" href="/assets/js/316.253a9866.js"><link rel="prefetch" href="/assets/js/317.6040b899.js"><link rel="prefetch" href="/assets/js/318.1b3d6691.js"><link rel="prefetch" href="/assets/js/319.e4b23765.js"><link rel="prefetch" href="/assets/js/32.a9547003.js"><link rel="prefetch" href="/assets/js/320.8ffd22d0.js"><link rel="prefetch" href="/assets/js/321.6cf78e9e.js"><link rel="prefetch" href="/assets/js/322.7a725b7b.js"><link rel="prefetch" href="/assets/js/323.d665fbcc.js"><link rel="prefetch" href="/assets/js/324.9b7d417a.js"><link rel="prefetch" href="/assets/js/325.f8ac8f80.js"><link rel="prefetch" href="/assets/js/326.09a08f9c.js"><link rel="prefetch" href="/assets/js/327.533646ac.js"><link rel="prefetch" href="/assets/js/328.f60eb257.js"><link rel="prefetch" href="/assets/js/329.d981dc86.js"><link rel="prefetch" href="/assets/js/33.bae1f6aa.js"><link rel="prefetch" href="/assets/js/330.ffa39ccc.js"><link rel="prefetch" href="/assets/js/331.b4d1850e.js"><link rel="prefetch" href="/assets/js/332.d02fbc7d.js"><link rel="prefetch" href="/assets/js/333.b77a5dc0.js"><link rel="prefetch" href="/assets/js/334.849a301f.js"><link rel="prefetch" href="/assets/js/335.364e1c87.js"><link rel="prefetch" href="/assets/js/336.ff75bb11.js"><link rel="prefetch" href="/assets/js/337.e3e68525.js"><link rel="prefetch" href="/assets/js/338.f1ddd2b2.js"><link rel="prefetch" href="/assets/js/339.7fb72e9f.js"><link rel="prefetch" href="/assets/js/34.47446ffe.js"><link rel="prefetch" href="/assets/js/340.09bb357b.js"><link rel="prefetch" href="/assets/js/341.8c0b31fc.js"><link rel="prefetch" href="/assets/js/342.15ebc005.js"><link rel="prefetch" href="/assets/js/343.cd201792.js"><link rel="prefetch" href="/assets/js/344.2199c693.js"><link rel="prefetch" href="/assets/js/345.3b56368b.js"><link rel="prefetch" href="/assets/js/346.6b72639c.js"><link rel="prefetch" href="/assets/js/347.2ab3653f.js"><link rel="prefetch" href="/assets/js/348.f29e01bf.js"><link rel="prefetch" href="/assets/js/349.5bfac238.js"><link rel="prefetch" href="/assets/js/35.9f00de6a.js"><link rel="prefetch" href="/assets/js/350.0879a3b5.js"><link rel="prefetch" href="/assets/js/351.8c3228bc.js"><link rel="prefetch" href="/assets/js/352.43ddbd8b.js"><link rel="prefetch" href="/assets/js/353.59f38cac.js"><link rel="prefetch" href="/assets/js/354.ff3bbb85.js"><link rel="prefetch" href="/assets/js/355.6bb84121.js"><link rel="prefetch" href="/assets/js/356.05644260.js"><link rel="prefetch" href="/assets/js/357.b257840b.js"><link rel="prefetch" href="/assets/js/358.055bcd7c.js"><link rel="prefetch" href="/assets/js/359.c67cd8ed.js"><link rel="prefetch" href="/assets/js/36.acba8a95.js"><link rel="prefetch" href="/assets/js/360.1107d171.js"><link rel="prefetch" href="/assets/js/361.ef50624a.js"><link rel="prefetch" href="/assets/js/362.64fa2dd8.js"><link rel="prefetch" href="/assets/js/363.6d929781.js"><link rel="prefetch" href="/assets/js/364.48b922ef.js"><link rel="prefetch" href="/assets/js/365.065b6888.js"><link rel="prefetch" href="/assets/js/366.6a3771ff.js"><link rel="prefetch" href="/assets/js/367.2cc8f934.js"><link rel="prefetch" href="/assets/js/368.b1c7f369.js"><link rel="prefetch" href="/assets/js/369.5ca92c4f.js"><link rel="prefetch" href="/assets/js/37.2ee17004.js"><link rel="prefetch" href="/assets/js/370.7f8e7cae.js"><link rel="prefetch" href="/assets/js/371.cdc80fbe.js"><link rel="prefetch" href="/assets/js/372.ee0c49b8.js"><link rel="prefetch" href="/assets/js/373.e0eddc9e.js"><link rel="prefetch" href="/assets/js/374.00c287d2.js"><link rel="prefetch" href="/assets/js/375.cafae782.js"><link rel="prefetch" href="/assets/js/376.920a5253.js"><link rel="prefetch" href="/assets/js/377.dec17054.js"><link rel="prefetch" href="/assets/js/378.328acce3.js"><link rel="prefetch" href="/assets/js/379.0b7d4a09.js"><link rel="prefetch" href="/assets/js/38.12b918f7.js"><link rel="prefetch" href="/assets/js/380.e5e0ff26.js"><link rel="prefetch" href="/assets/js/381.4be43bef.js"><link rel="prefetch" href="/assets/js/382.9e38bed5.js"><link rel="prefetch" href="/assets/js/383.ce2714c4.js"><link rel="prefetch" href="/assets/js/384.ed10c711.js"><link rel="prefetch" href="/assets/js/385.d8b4589c.js"><link rel="prefetch" href="/assets/js/386.31cc556d.js"><link rel="prefetch" href="/assets/js/387.ee1ace1f.js"><link rel="prefetch" href="/assets/js/388.bd0a1963.js"><link rel="prefetch" href="/assets/js/389.f449e4ea.js"><link rel="prefetch" href="/assets/js/39.4c7ca432.js"><link rel="prefetch" href="/assets/js/390.17e398a8.js"><link rel="prefetch" href="/assets/js/391.64b59027.js"><link rel="prefetch" href="/assets/js/392.f0829add.js"><link rel="prefetch" href="/assets/js/393.dd0a2774.js"><link rel="prefetch" href="/assets/js/394.02e90324.js"><link rel="prefetch" href="/assets/js/395.749a04e4.js"><link rel="prefetch" href="/assets/js/396.808e0cd2.js"><link rel="prefetch" href="/assets/js/397.0638a8ed.js"><link rel="prefetch" href="/assets/js/398.b46bdc7c.js"><link rel="prefetch" href="/assets/js/399.7748e120.js"><link rel="prefetch" href="/assets/js/4.99e5432f.js"><link rel="prefetch" href="/assets/js/40.63c9e171.js"><link rel="prefetch" href="/assets/js/400.eb62853a.js"><link rel="prefetch" href="/assets/js/401.8e7be19d.js"><link rel="prefetch" href="/assets/js/402.03eb8971.js"><link rel="prefetch" href="/assets/js/403.0461a1a2.js"><link rel="prefetch" href="/assets/js/404.b716ebba.js"><link rel="prefetch" href="/assets/js/405.3b159dd7.js"><link rel="prefetch" href="/assets/js/406.b77cd48b.js"><link rel="prefetch" href="/assets/js/407.16c4942b.js"><link rel="prefetch" href="/assets/js/408.51522d4c.js"><link rel="prefetch" href="/assets/js/409.b512c665.js"><link rel="prefetch" href="/assets/js/41.e9874039.js"><link rel="prefetch" href="/assets/js/410.ca2fb3cc.js"><link rel="prefetch" href="/assets/js/411.ed856a5a.js"><link rel="prefetch" href="/assets/js/412.5dbcebd8.js"><link rel="prefetch" href="/assets/js/413.08da4158.js"><link rel="prefetch" href="/assets/js/414.a3696d87.js"><link rel="prefetch" href="/assets/js/415.14f60f61.js"><link rel="prefetch" href="/assets/js/416.53c3dae7.js"><link rel="prefetch" href="/assets/js/417.48df988f.js"><link rel="prefetch" href="/assets/js/418.7de45153.js"><link rel="prefetch" href="/assets/js/419.d4619992.js"><link rel="prefetch" href="/assets/js/42.9a545fc9.js"><link rel="prefetch" href="/assets/js/420.203347ef.js"><link rel="prefetch" href="/assets/js/421.d253df0c.js"><link rel="prefetch" href="/assets/js/422.b12ea703.js"><link rel="prefetch" href="/assets/js/423.451473d9.js"><link rel="prefetch" href="/assets/js/424.31723163.js"><link rel="prefetch" href="/assets/js/425.13ce1c07.js"><link rel="prefetch" href="/assets/js/426.b42801fb.js"><link rel="prefetch" href="/assets/js/427.0031c522.js"><link rel="prefetch" href="/assets/js/428.c42e0ae9.js"><link rel="prefetch" href="/assets/js/429.31aa3c27.js"><link rel="prefetch" href="/assets/js/43.46ad2155.js"><link rel="prefetch" href="/assets/js/430.47686810.js"><link rel="prefetch" href="/assets/js/431.b5cda25a.js"><link rel="prefetch" href="/assets/js/432.5a532c26.js"><link rel="prefetch" href="/assets/js/433.f8440fc3.js"><link rel="prefetch" href="/assets/js/434.eacd54ec.js"><link rel="prefetch" href="/assets/js/435.2ceed179.js"><link rel="prefetch" href="/assets/js/436.1d2ed591.js"><link rel="prefetch" href="/assets/js/437.9ad286ea.js"><link rel="prefetch" href="/assets/js/438.41ae21a2.js"><link rel="prefetch" href="/assets/js/439.eb70778f.js"><link rel="prefetch" href="/assets/js/44.53b5549f.js"><link rel="prefetch" href="/assets/js/440.81a856cc.js"><link rel="prefetch" href="/assets/js/441.d989e382.js"><link rel="prefetch" href="/assets/js/442.2e8a7273.js"><link rel="prefetch" href="/assets/js/443.185bf82d.js"><link rel="prefetch" href="/assets/js/444.fac786fa.js"><link rel="prefetch" href="/assets/js/445.0a0fef1d.js"><link rel="prefetch" href="/assets/js/446.f9bb500c.js"><link rel="prefetch" href="/assets/js/447.6a3d060d.js"><link rel="prefetch" href="/assets/js/448.aeb59378.js"><link rel="prefetch" href="/assets/js/449.ef532e16.js"><link rel="prefetch" href="/assets/js/45.0d3e1654.js"><link rel="prefetch" href="/assets/js/450.361cf280.js"><link rel="prefetch" href="/assets/js/451.912eea61.js"><link rel="prefetch" href="/assets/js/452.f6bd7fc6.js"><link rel="prefetch" href="/assets/js/453.e8ddcd33.js"><link rel="prefetch" href="/assets/js/454.0722597b.js"><link rel="prefetch" href="/assets/js/455.5e5f9203.js"><link rel="prefetch" href="/assets/js/456.6987768d.js"><link rel="prefetch" href="/assets/js/457.de904b4d.js"><link rel="prefetch" href="/assets/js/458.061d7995.js"><link rel="prefetch" href="/assets/js/459.71f9f5be.js"><link rel="prefetch" href="/assets/js/46.5f327038.js"><link rel="prefetch" href="/assets/js/460.37399353.js"><link rel="prefetch" href="/assets/js/461.314203cd.js"><link rel="prefetch" href="/assets/js/462.de3ff733.js"><link rel="prefetch" href="/assets/js/463.e6947ad7.js"><link rel="prefetch" href="/assets/js/464.239479b6.js"><link rel="prefetch" href="/assets/js/465.d58f6ac8.js"><link rel="prefetch" href="/assets/js/466.0392e229.js"><link rel="prefetch" href="/assets/js/467.833308dd.js"><link rel="prefetch" href="/assets/js/468.f90b764e.js"><link rel="prefetch" href="/assets/js/469.8e8efeec.js"><link rel="prefetch" href="/assets/js/47.e3eeebae.js"><link rel="prefetch" href="/assets/js/470.cfc2c0a3.js"><link rel="prefetch" href="/assets/js/471.5aae9196.js"><link rel="prefetch" href="/assets/js/472.be600189.js"><link rel="prefetch" href="/assets/js/473.e95ea5b1.js"><link rel="prefetch" href="/assets/js/474.0764b048.js"><link rel="prefetch" href="/assets/js/475.ff6b45bd.js"><link rel="prefetch" href="/assets/js/476.88a062a4.js"><link rel="prefetch" href="/assets/js/477.1440bf29.js"><link rel="prefetch" href="/assets/js/478.64fef5ed.js"><link rel="prefetch" href="/assets/js/479.26d87606.js"><link rel="prefetch" href="/assets/js/48.b224e9a5.js"><link rel="prefetch" href="/assets/js/480.623a5aa9.js"><link rel="prefetch" href="/assets/js/481.567e307e.js"><link rel="prefetch" href="/assets/js/482.fc2823de.js"><link rel="prefetch" href="/assets/js/483.f7586a14.js"><link rel="prefetch" href="/assets/js/484.b62bd3a3.js"><link rel="prefetch" href="/assets/js/485.ce480c6e.js"><link rel="prefetch" href="/assets/js/486.f5300e9d.js"><link rel="prefetch" href="/assets/js/487.fb67d1f1.js"><link rel="prefetch" href="/assets/js/488.c6a8b133.js"><link rel="prefetch" href="/assets/js/489.ea60c6a2.js"><link rel="prefetch" href="/assets/js/49.614055cf.js"><link rel="prefetch" href="/assets/js/490.643cf701.js"><link rel="prefetch" href="/assets/js/491.4703ac9f.js"><link rel="prefetch" href="/assets/js/492.5412fea1.js"><link rel="prefetch" href="/assets/js/493.53371fff.js"><link rel="prefetch" href="/assets/js/494.ae7f6120.js"><link rel="prefetch" href="/assets/js/495.f2ce4477.js"><link rel="prefetch" href="/assets/js/496.74ae2f01.js"><link rel="prefetch" href="/assets/js/497.5eece959.js"><link rel="prefetch" href="/assets/js/498.5630f714.js"><link rel="prefetch" href="/assets/js/499.05b78c9a.js"><link rel="prefetch" href="/assets/js/5.2c66b9cb.js"><link rel="prefetch" href="/assets/js/50.71931b96.js"><link rel="prefetch" href="/assets/js/500.f4896346.js"><link rel="prefetch" href="/assets/js/501.e92c2e1e.js"><link rel="prefetch" href="/assets/js/502.ccab5039.js"><link rel="prefetch" href="/assets/js/503.c64c42d2.js"><link rel="prefetch" href="/assets/js/504.0c461c77.js"><link rel="prefetch" href="/assets/js/506.81492cac.js"><link rel="prefetch" href="/assets/js/507.6720e12b.js"><link rel="prefetch" href="/assets/js/508.9428cb66.js"><link rel="prefetch" href="/assets/js/509.38049f9a.js"><link rel="prefetch" href="/assets/js/51.7bee7688.js"><link rel="prefetch" href="/assets/js/510.bdef8f0c.js"><link rel="prefetch" href="/assets/js/511.ce3248a7.js"><link rel="prefetch" href="/assets/js/512.818491a9.js"><link rel="prefetch" href="/assets/js/513.fdf09d6f.js"><link rel="prefetch" href="/assets/js/514.1d0e8962.js"><link rel="prefetch" href="/assets/js/515.69c2a1c8.js"><link rel="prefetch" href="/assets/js/516.ad130bff.js"><link rel="prefetch" href="/assets/js/517.5db347c6.js"><link rel="prefetch" href="/assets/js/518.197f7a79.js"><link rel="prefetch" href="/assets/js/519.93a30ede.js"><link rel="prefetch" href="/assets/js/52.6d51118b.js"><link rel="prefetch" href="/assets/js/520.906c211f.js"><link rel="prefetch" href="/assets/js/521.d08cfdb7.js"><link rel="prefetch" href="/assets/js/522.fa76570a.js"><link rel="prefetch" href="/assets/js/523.ceb69f99.js"><link rel="prefetch" href="/assets/js/524.8f770bb8.js"><link rel="prefetch" href="/assets/js/525.ae5041ab.js"><link rel="prefetch" href="/assets/js/53.6d9f67be.js"><link rel="prefetch" href="/assets/js/54.60c66419.js"><link rel="prefetch" href="/assets/js/55.2cd45a63.js"><link rel="prefetch" href="/assets/js/56.0a266783.js"><link rel="prefetch" href="/assets/js/57.24c6c793.js"><link rel="prefetch" href="/assets/js/58.f27e4861.js"><link rel="prefetch" href="/assets/js/59.558bfbc3.js"><link rel="prefetch" href="/assets/js/6.f712344a.js"><link rel="prefetch" href="/assets/js/60.f205092a.js"><link rel="prefetch" href="/assets/js/61.32b5d473.js"><link rel="prefetch" href="/assets/js/62.1d584c66.js"><link rel="prefetch" href="/assets/js/63.7104bfe2.js"><link rel="prefetch" href="/assets/js/64.e30d770e.js"><link rel="prefetch" href="/assets/js/65.0b5cbeae.js"><link rel="prefetch" href="/assets/js/66.1e2ae6a1.js"><link rel="prefetch" href="/assets/js/67.050c32a8.js"><link rel="prefetch" href="/assets/js/68.662ebf9b.js"><link rel="prefetch" href="/assets/js/69.87c036f8.js"><link rel="prefetch" href="/assets/js/7.566c0fa0.js"><link rel="prefetch" href="/assets/js/70.306ff05b.js"><link rel="prefetch" href="/assets/js/71.8aa2aa35.js"><link rel="prefetch" href="/assets/js/72.15351386.js"><link rel="prefetch" href="/assets/js/73.4694f012.js"><link rel="prefetch" href="/assets/js/74.3ad5edc9.js"><link rel="prefetch" href="/assets/js/75.ecf1869e.js"><link rel="prefetch" href="/assets/js/76.e3d9c26d.js"><link rel="prefetch" href="/assets/js/77.e0a84e93.js"><link rel="prefetch" href="/assets/js/78.793171cd.js"><link rel="prefetch" href="/assets/js/79.4e9ea73f.js"><link rel="prefetch" href="/assets/js/8.6ce9fd25.js"><link rel="prefetch" href="/assets/js/80.8907fbd0.js"><link rel="prefetch" href="/assets/js/81.5a4044e6.js"><link rel="prefetch" href="/assets/js/82.a1a40237.js"><link rel="prefetch" href="/assets/js/83.8a83b3b6.js"><link rel="prefetch" href="/assets/js/84.8d99cbe3.js"><link rel="prefetch" href="/assets/js/85.2b7aaa4f.js"><link rel="prefetch" href="/assets/js/86.2497b2e7.js"><link rel="prefetch" href="/assets/js/87.1f9b18fb.js"><link rel="prefetch" href="/assets/js/88.d403b9b3.js"><link rel="prefetch" href="/assets/js/89.530d5cf7.js"><link rel="prefetch" href="/assets/js/9.c502c264.js"><link rel="prefetch" href="/assets/js/90.a455ea3e.js"><link rel="prefetch" href="/assets/js/91.745c8157.js"><link rel="prefetch" href="/assets/js/92.23cc9975.js"><link rel="prefetch" href="/assets/js/93.392ece00.js"><link rel="prefetch" href="/assets/js/94.fcb1b0c1.js"><link rel="prefetch" href="/assets/js/95.f98b1b84.js"><link rel="prefetch" href="/assets/js/96.d8573a41.js"><link rel="prefetch" href="/assets/js/97.66b48d4c.js"><link rel="prefetch" href="/assets/js/98.30a2af54.js"><link rel="prefetch" href="/assets/js/99.c9a3faa5.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.ac6383e3.js">
<link rel="stylesheet" href="/assets/css/0.styles.ee74b34d.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="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/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.9.x/4-Client/5-Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/4-Client/5-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="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/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.9.x/4-Client/5-Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/4-Client/5-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.9.x)</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>0-开始</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>1-概览</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>2-概念</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>3-服务器端</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>4-客户端</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/zh/UserGuide/V0.9.x/4-Client/1-Command Line Interface.html" class="sidebar-link">命令行接口 (CLI)</a></li><li><a href="/zh/UserGuide/V0.9.x/4-Client/2-Programming - JDBC.html" class="sidebar-link">JDBC</a></li><li><a href="/zh/UserGuide/V0.9.x/4-Client/3-Programming - Session.html" class="sidebar-link">Session</a></li><li><a href="/zh/UserGuide/V0.9.x/4-Client/4-Programming - Other Languages.html" class="sidebar-link">其他语言</a></li><li><a href="/zh/UserGuide/V0.9.x/4-Client/5-Programming - TsFile API.html" class="active sidebar-link">TsFile API</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>5-操作指南</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>6-系统工具</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>7-生态集成</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>8-系统设计</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="ts文件库安装"><a href="#ts文件库安装" class="header-anchor">#</a> Ts文件库安装</h2> <p>在您自己的项目中有两种使用TsFile的方法。</p> <ul><li><p>用作jars:</p> <ul><li><p>编译源代码并构建为jars</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/incubator-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都可以放在名为“ target /”的文件夹中。 将<code>target / tsfile-0.9.3-jar-with-dependencies.jar</code>导入您的项目。</p></li></ul></li> <li><p>用作Maven依赖项:</p> <p>编译源代码并通过三个步骤将其部署到本地存储库:</p> <ul><li><p>获取源代码</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/incubator-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.9.3&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>第一, 在路径上找到您的Maven<code>settings.xml</code>: <code>${username}\.m2\settings.xml</code>
, 将 <code>&lt;profile&gt;</code> 加入到 <code>&lt;profiles&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.9.3&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="时间序列数据"><a href="#时间序列数据" class="header-anchor">#</a> 时间序列数据</h3> <p>时间序列被视为四倍序列。 四元组定义为(设备,测量,时间,值)。</p> <ul><li><p><strong>测量</strong>: 时间序列进行的物理或形式测量,例如城市温度,某些商品的销售数量或火车在不同时间的速度。 由于传统的传感器(例如温度计)也需要进行一次测量并生成一个时间序列,因此我们将在下面互换使用测量和传感器。</p></li> <li><p><strong>设备</strong>: 设备是指正在执行多个测量(产生多个时间序列)的实体,例如,运行中的火车监视其速度,油表,行驶里程,当前乘客均被传送到一个时间序列。</p></li></ul> <p>表1说明了一组时间序列数据。 下表中显示的集合包含一个名为“ device \ _1”的设备以及三个名为“ sensor \ _1”,“ sensor \ _2”和“ sensor \ _3”的测量值。</p> <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> <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不存储空值)。 其格式如下所示:</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>一个示例如下所示。 在此示例中,两个测量的数据类型分别为“ INT32”和“ FLOAT”。</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,完整的代码将在“编写TsFile的示例”部分中给出。</p> <ul><li><p>一,构造一个<code>TsFileWriter</code>实例。</p> <p>以下是可用的构造函数:</p> <ul><li>没有预定义的架构</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>使用预定义的架构</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配置,则可以使用param<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(“ LOCAL”)</code>,这也是默认配置。</p> <p>您也可以通过<code>config.setHdfsIp(...)</code><code>config.setHdfsPort(...)</code>配置HDFS的IP和端口。 默认ip为<code>localhost</code>,默认端口为<code>9000</code></p> <p><strong>Parameters:</strong></p> <ul><li><p>file:要写入的TsFile</p></li> <li><p>schema:文件模式将在下一部分中介绍。</p></li> <li><p>config:TsFile的配置。</p></li></ul></li> <li><p>二,添加测量</p> <p>或者,您可以先创建<code>Schema</code>类的实例,然后将其传递给<code>TsFileWriter</code>类的构造函数。<code>Schema</code>类包含一个映射,该映射的键是一个度量模式的名称,而值是该模式本身。</p> <p>这里是接口:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 创建一个空的架构或从现有的映射
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)
// 一些有用的吸气剂和检查剂
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>类中使用以下接口来添加其他度量:</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>类包含一种度量的信息,有几种构造函数:</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>类型:数据类型,现在支持六种类型:<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="/document/V0.9.x/UserGuide/2-Concept/3-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>。 用作字符串对,例如(“ max_point_number”,“ 3”)。</p></li></ul> <blockquote><p>**注意:**尽管一个度量名称可以在多个deltaObject中使用,但是不能更改属性。 即 不允许多次使用不同的类型或编码添加一个测量名称。
​ 这是一个不好的例子:</p></blockquote> <div class="language- extra-class"><pre><code> // 测量值“ sensor_1”为浮点型
addMeasurement(new MeasurementSchema(&quot;sensor_1&quot;, TSDataType.FLOAT, TSEncoding.RLE));
// 此调用将引发WriteProcessException异常
addMeasurement(new MeasurementSchema(&quot;sensor_1&quot;, TSDataType.INT32, TSEncoding.RLE));
</code></pre></div></li> <li><p>第三,连续插入和写入数据。
​ 使用此接口可以创建新的<code>TSRecord</code>(时间戳和设备对)。</p></li> <li><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>(一个测量值和一个值对),并使用addTuple方法将DataPoint添加到正确的TsRecord。
​ 用这种方法写</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> <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>(例如,并非所有传感器都包含值)的时间序列数据,则可以通过构造**TSRecord **来编写TsFile。</p> <p>可以在以下位置找到更详尽的示例<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithTSRecord.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">File</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>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums<span class="token punctuation">.</span></span><span class="token class-name">TSDataType</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>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums<span class="token punctuation">.</span></span><span class="token class-name">TSEncoding</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>write<span class="token punctuation">.</span></span><span class="token class-name">TsFileWriter</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>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span></span><span class="token class-name">TSRecord</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>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint<span class="token punctuation">.</span></span><span class="token class-name">DataPoint</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>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint<span class="token punctuation">.</span></span><span class="token class-name">FloatDataPoint</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>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint<span class="token punctuation">.</span></span><span class="token class-name">IntDataPoint</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>write<span class="token punctuation">.</span>schema<span class="token punctuation">.</span></span><span class="token class-name">MeasurementSchema</span><span class="token punctuation">;</span>
<span class="token comment">/**
* An example of writing data to TsFile
* It uses the interface:
* public void addMeasurement(MeasurementSchema MeasurementSchema) throws WriteProcessException
*/</span>
<span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileWriteWithTSRecord</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> args<span class="token punctuation">[</span><span class="token punctuation">]</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token keyword">try</span> <span class="token punctuation">{</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 class-name">File</span> f <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">if</span> <span class="token punctuation">(</span>f<span class="token punctuation">.</span><span class="token function">exists</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
f<span class="token punctuation">.</span><span class="token function">delete</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">TsFileWriter</span> tsFileWriter <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span>f<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// add measurements into file schema</span>
tsFileWriter
<span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_1&quot;</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
tsFileWriter
<span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_2&quot;</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
tsFileWriter
<span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_3&quot;</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// construct TSRecord</span>
<span class="token class-name">TSRecord</span> tsRecord <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TSRecord</span><span class="token punctuation">(</span><span class="token number">1</span><span class="token punctuation">,</span> <span class="token string">&quot;device_1&quot;</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token class-name">DataPoint</span> dPoint1 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_1&quot;</span><span class="token punctuation">,</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token class-name">DataPoint</span> dPoint2 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_2&quot;</span><span class="token punctuation">,</span> <span class="token number">2</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token class-name">DataPoint</span> dPoint3 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_3&quot;</span><span class="token punctuation">,</span> <span class="token number">3</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint1<span class="token punctuation">)</span><span class="token punctuation">;</span>
tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint2<span class="token punctuation">)</span><span class="token punctuation">;</span>
tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint3<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// write TSRecord</span>
tsFileWriter<span class="token punctuation">.</span><span class="token function">write</span><span class="token punctuation">(</span>tsRecord<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// close TsFile</span>
tsFileWriter<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 keyword">catch</span> <span class="token punctuation">(</span><span class="token class-name">Throwable</span> e<span class="token punctuation">)</span> <span class="token punctuation">{</span>
e<span class="token punctuation">.</span><span class="token function">printStackTrace</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>e<span class="token punctuation">.</span><span class="token function">getMessage</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 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><span class="line-number">54</span><br><span class="line-number">55</span><br><span class="line-number">56</span><br></div></div><p>如果您具有<strong>对齐的</strong>时间序列数据,则可以通过构造**RowBatch **来编写TsFile。
​ 可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithRowBatch.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">File</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>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums<span class="token punctuation">.</span></span><span class="token class-name">TSDataType</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>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums<span class="token punctuation">.</span></span><span class="token class-name">TSEncoding</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>write<span class="token punctuation">.</span></span><span class="token class-name">TsFileWriter</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>write<span class="token punctuation">.</span>schema<span class="token punctuation">.</span></span><span class="token class-name">Schema</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>write<span class="token punctuation">.</span>schema<span class="token punctuation">.</span></span><span class="token class-name">MeasurementSchema</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>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span></span><span class="token class-name">RowBatch</span><span class="token punctuation">;</span>
<span class="token comment">/**
* An example of writing data with RowBatch to TsFile
*/</span>
<span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileWriteWithRowBatch</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 punctuation">{</span>
<span class="token keyword">try</span> <span class="token punctuation">{</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 class-name">File</span> f <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">if</span> <span class="token punctuation">(</span>f<span class="token punctuation">.</span><span class="token function">exists</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
f<span class="token punctuation">.</span><span class="token function">delete</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">Schema</span> schema <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">Schema</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// the number of rows to include in the row batch</span>
<span class="token keyword">int</span> rowNum <span class="token operator">=</span> <span class="token number">1000000</span><span class="token punctuation">;</span>
<span class="token comment">// the number of values to include in the row batch</span>
<span class="token keyword">int</span> sensorNum <span class="token operator">=</span> <span class="token number">10</span><span class="token punctuation">;</span>
<span class="token comment">// add measurements into file schema (all with INT64 data type)</span>
<span class="token keyword">for</span> <span class="token punctuation">(</span><span class="token keyword">int</span> i <span class="token operator">=</span> <span class="token number">0</span><span class="token punctuation">;</span> i <span class="token operator">&lt;</span> sensorNum<span class="token punctuation">;</span> i<span class="token operator">++</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
schema<span class="token punctuation">.</span><span class="token function">registerMeasurement</span><span class="token punctuation">(</span>
<span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">&quot;sensor_&quot;</span> <span class="token operator">+</span> <span class="token punctuation">(</span>i <span class="token operator">+</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>TS_2DIFF<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token comment">// add measurements into TSFileWriter</span>
<span class="token class-name">TsFileWriter</span> tsFileWriter <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span>f<span class="token punctuation">,</span> schema<span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token comment">// construct the row batch</span>
<span class="token class-name">RowBatch</span> rowBatch <span class="token operator">=</span> schema<span class="token punctuation">.</span><span class="token function">createRowBatch</span><span class="token punctuation">(</span><span class="token string">&quot;device_1&quot;</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token keyword">long</span><span class="token punctuation">[</span><span class="token punctuation">]</span> timestamps <span class="token operator">=</span> rowBatch<span class="token punctuation">.</span>timestamps<span class="token punctuation">;</span>
<span class="token class-name">Object</span><span class="token punctuation">[</span><span class="token punctuation">]</span> values <span class="token operator">=</span> rowBatch<span class="token punctuation">.</span>values<span class="token punctuation">;</span>
<span class="token keyword">long</span> timestamp <span class="token operator">=</span> <span class="token number">1</span><span class="token punctuation">;</span>
<span class="token keyword">long</span> value <span class="token operator">=</span> <span class="token number">1000000L</span><span class="token punctuation">;</span>
<span class="token keyword">for</span> <span class="token punctuation">(</span><span class="token keyword">int</span> r <span class="token operator">=</span> <span class="token number">0</span><span class="token punctuation">;</span> r <span class="token operator">&lt;</span> rowNum<span class="token punctuation">;</span> r<span class="token operator">++</span><span class="token punctuation">,</span> value<span class="token operator">++</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token keyword">int</span> row <span class="token operator">=</span> rowBatch<span class="token punctuation">.</span>batchSize<span class="token operator">++</span><span class="token punctuation">;</span>
timestamps<span class="token punctuation">[</span>row<span class="token punctuation">]</span> <span class="token operator">=</span> timestamp<span class="token operator">++</span><span class="token punctuation">;</span>
<span class="token keyword">for</span> <span class="token punctuation">(</span><span class="token keyword">int</span> i <span class="token operator">=</span> <span class="token number">0</span><span class="token punctuation">;</span> i <span class="token operator">&lt;</span> sensorNum<span class="token punctuation">;</span> i<span class="token operator">++</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
<span class="token keyword">long</span><span class="token punctuation">[</span><span class="token punctuation">]</span> sensor <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token keyword">long</span><span class="token punctuation">[</span><span class="token punctuation">]</span><span class="token punctuation">)</span> values<span class="token punctuation">[</span>i<span class="token punctuation">]</span><span class="token punctuation">;</span>
sensor<span class="token punctuation">[</span>row<span class="token punctuation">]</span> <span class="token operator">=</span> value<span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token comment">// write RowBatch to TsFile</span>
<span class="token keyword">if</span> <span class="token punctuation">(</span>rowBatch<span class="token punctuation">.</span>batchSize <span class="token operator">==</span> rowBatch<span class="token punctuation">.</span><span class="token function">getMaxBatchSize</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
tsFileWriter<span class="token punctuation">.</span><span class="token function">write</span><span class="token punctuation">(</span>rowBatch<span class="token punctuation">)</span><span class="token punctuation">;</span>
rowBatch<span class="token punctuation">.</span><span class="token function">reset</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 comment">// write RowBatch to TsFile</span>
<span class="token keyword">if</span> <span class="token punctuation">(</span>rowBatch<span class="token punctuation">.</span>batchSize <span class="token operator">!=</span> <span class="token number">0</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
tsFileWriter<span class="token punctuation">.</span><span class="token function">write</span><span class="token punctuation">(</span>rowBatch<span class="token punctuation">)</span><span class="token punctuation">;</span>
rowBatch<span class="token punctuation">.</span><span class="token function">reset</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
<span class="token punctuation">}</span>
<span class="token comment">// close TsFile</span>
tsFileWriter<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 keyword">catch</span> <span class="token punctuation">(</span><span class="token class-name">Throwable</span> e<span class="token punctuation">)</span> <span class="token punctuation">{</span>
e<span class="token punctuation">.</span><span class="token function">printStackTrace</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>e<span class="token punctuation">.</span><span class="token function">getMessage</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 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><span class="line-number">54</span><br><span class="line-number">55</span><br><span class="line-number">56</span><br><span class="line-number">57</span><br><span class="line-number">58</span><br><span class="line-number">59</span><br><span class="line-number">60</span><br><span class="line-number">61</span><br><span class="line-number">62</span><br><span class="line-number">63</span><br><span class="line-number">64</span><br><span class="line-number">65</span><br><span class="line-number">66</span><br><span class="line-number">67</span><br><span class="line-number">68</span><br><span class="line-number">69</span><br><span class="line-number">70</span><br><span class="line-number">71</span><br><span class="line-number">72</span><br><span class="line-number">73</span><br><span class="line-number">74</span><br><span class="line-number">75</span><br></div></div><h3 id="读取tsfile的接口"><a href="#读取tsfile的接口" class="header-anchor">#</a> 读取TsFile的接口</h3> <h4 id="开始之前"><a href="#开始之前" class="header-anchor">#</a> 开始之前</h4> <p>“时间序列数据”部分中的时间序列数据集在此用于本节的具体介绍。 下表中显示的集合包含一个名为“ device \ _1”的deltaObject和三个名为“ sensor \ _1”,“ sensor \ _2”和“ sensor \ _3”的测量值。 并简化了测量以进行简单说明,每个仅包含4个时间值对。</p> <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> <h4 id="路径定义"><a href="#路径定义" class="header-anchor">#</a> 路径定义</h4> <p>路径是用点分隔的字符串,该字符串在TsFile中唯一标识时间序列,例如“ root.area_1.device_1.sensor_1”。
最后一部分“ sensor_1”称为“ measurementId”,其余部分“ root.area_1.device_1”称为deviceId。
如上所述,不同设备中的相同测量具有相同的数据类型和编码,并且设备也是唯一的。</p> <p>在读取接口中,参数路径指示要选择的测量。
通过类<code>Path</code>可以轻松构造<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>**注意:**在构造路径时,参数的格式应为点分隔的字符串,最后一部分将被识别为MeasurementId,而其余部分将被识别为deviceId。</p></blockquote> <h4 id="过滤器的定义"><a href="#过滤器的定义" class="header-anchor">#</a> 过滤器的定义</h4> <h5 id="使用场景"><a href="#使用场景" class="header-anchor">#</a> 使用场景</h5> <p>在TsFile读取过程中使用筛选器来选择满足一个或多个给定条件的数据。</p> <h4 id="iexpression"><a href="#iexpression" class="header-anchor">#</a> IExpression</h4> <p><code>IExpression</code>是一个过滤器表达式接口,它将被传递给我们的最终查询调用。
我们创建一个或多个过滤器表达式,并可以使用二进制过滤器运算符将它们链接到最终表达式。</p> <ul><li><p><strong>创建一个过滤器表达式</strong></p> <p>有两种类型的过滤器。</p> <ul><li><p>TimeFilter:时间序列数据中<code>时间</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 int变量)。
<center><table style="text-align:center;"><tr><th>Relationship</th><th>Description</th></tr> <tr><td>TimeFilter.eq(value)</td><td>Choose the time equal to the value</td></tr> <tr><td>TimeFilter.lt(value)</td><td>Choose the time less than the value</td></tr> <tr><td>TimeFilter.gt(value)</td><td>Choose the time greater than the value</td></tr> <tr><td>TimeFilter.ltEq(value)</td><td>Choose the time less than or equal to the value</td></tr> <tr><td>TimeFilter.gtEq(value)</td><td>Choose the time greater than or equal to the value</td></tr> <tr><td>TimeFilter.notEq(value)</td><td>Choose the time not equal to the value</td></tr> <tr><td>TimeFilter.not(TimeFilter)</td><td>Choose the time not satisfy another TimeFilter</td></tr></table></center></p></li> <li><p>ValueFilter:时间序列数据中值的过滤器。</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>的用法相同,只是要确保值的类型等于度量值(在路径中定义)。</p></li></ul></li> <li><p><strong>二元滤波器运算符</strong></p> <p>二进制过滤器运算符可用于链接两个单个表达式。</p> <ul><li>BinaryExpression.and(Expression,Expression):选择两个表达式都满足的值。</li> <li>BinaryExpression.or(Expression,Expression):选择至少满足一个表达式的值。</li></ul></li></ul> <h5 id="过滤器表达式示例"><a href="#过滤器表达式示例" class="header-anchor">#</a> 过滤器表达式示例</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类具有两种查询方法来执行查询。</p> <ul><li><p><strong>方法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>方法二</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><p><strong>参数</strong> : 对于方法2,添加了两个附加参数以支持部分查询:</p> <ul><li><code>partitionStartOffset</code>: TsFile的起始偏移量</li> <li><code>partitionEndOffset</code>: TsFile的结束偏移量</li></ul> <blockquote><p><strong>什么是部分查询?</strong></p> <p>在某些分布式文件系统(例如HDFS)中,文件被分成几个部分,这些部分称为“块”,并存储在不同的节点中。 在涉及的每个节点中并行执行查询可以提高效率。 因此,需要部分查询。 Paritial 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类是一个枚举类,值将是以下值之一:</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>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">/**
* 该类将显示如何读取名为“ test.ts文件”的Ts文件文件。
* TsFile文件“ test.tsfile”是从类TsFileWrite生成的。
* 运行TsFileWrite首先生成test.tsfile
*/</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">// 文件路径</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">// 创建阅读器并获取readTsFile接口</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">// 使用这些路径(所有传感器)进行所有查询</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">// 没有查询语句</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">//离开时关闭阅读器</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><h2 id="布隆过滤器"><a href="#布隆过滤器" class="header-anchor">#</a> 布隆过滤器</h2> <p>布隆过滤器在加载元数据之前检查给定的时间序列是否在ts文件中。 这样可以提高加载元数据的性能,并跳过不包含指定时间序列的tsfile。
如果要了解有关其机制的更多信息,可以参考: <a href="https://en.wikipedia.org/wiki/Bloom_filter" target="_blank" rel="noopener noreferrer">wiki page of bloom filter<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>.</p> <h4 id="配置"><a href="#配置" class="header-anchor">#</a> 配置</h4> <p>您可以通过修改 TSFileConfig 里的 bloomFilterErrorRate 参数来控制Bloom过滤器的误报率。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code># The acceptable error rate of bloom filter, should be in [0.01, 0.1], default is 0.05
bloom_filter_error_rate=0.05
</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.9.x/4-Client/4-Programming - Other Languages.html" class="prev">
其他语言
</a></span> <span class="next"><a href="/zh/UserGuide/V0.9.x/5-Operation Manual/1-DDL Data Definition Language.html">
DDL (数据定义语言)
</a>
</span></p></div> <p style="text-align: center;">Copyright © 2020 The Apache Software Foundation.<br>
Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p> <p style="text-align: 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.d9cc7506.js" defer></script><script src="/assets/js/3.80bccc99.js" defer></script><script src="/assets/js/505.161aba34.js" defer></script>
</body>
</html>