| <!DOCTYPE html> |
| <html lang="en-US"> |
| <head> |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| <title> </title> |
| <meta name="generator" content="VuePress 1.8.2"> |
| <link rel="icon" href="/favicon.ico"> |
| <meta name="description" content=" "> |
| <meta name="Description" content="Apache IoTDB: Time Series Database for IoT"> |
| <meta name="Keywords" content="TSDB, time series, time series database, IoTDB, IoT database, IoT data management,时序数据库, 时间序列管理, IoTDB, 物联网数据库, 实时数据库, 物联网数据管理, 物联网数据"> |
| <meta name="baidu-site-verification" content="wfKETzB3OT"> |
| <meta name="google-site-verification" content="mZWAoRY0yj_HAr-s47zHCGHzx5Ju-RVm5wDbPnwQYFo"> |
| |
| <link rel="preload" href="/assets/css/0.styles.c79f5191.css" as="style"><link rel="preload" href="/assets/js/app.35ba4ac3.js" as="script"><link rel="preload" href="/assets/js/3.96a076a8.js" as="script"><link rel="preload" href="/assets/js/4.a65360c5.js" as="script"><link rel="preload" href="/assets/js/311.85a79804.js" as="script"><link rel="prefetch" href="/assets/js/10.60470782.js"><link rel="prefetch" href="/assets/js/100.e2b000a0.js"><link rel="prefetch" href="/assets/js/101.e8ddf551.js"><link rel="prefetch" href="/assets/js/102.8e4c98f5.js"><link rel="prefetch" href="/assets/js/103.ca950be9.js"><link rel="prefetch" href="/assets/js/104.5105e29f.js"><link rel="prefetch" href="/assets/js/105.6dc4fd1d.js"><link rel="prefetch" href="/assets/js/106.8902c844.js"><link rel="prefetch" href="/assets/js/107.9f4a26e9.js"><link rel="prefetch" href="/assets/js/108.fa211ff9.js"><link rel="prefetch" href="/assets/js/109.26ee1ad0.js"><link rel="prefetch" href="/assets/js/11.e6c21699.js"><link rel="prefetch" href="/assets/js/110.a5668c48.js"><link rel="prefetch" href="/assets/js/111.0b78727f.js"><link rel="prefetch" href="/assets/js/112.1f92e6d5.js"><link rel="prefetch" href="/assets/js/113.76c7aecf.js"><link rel="prefetch" href="/assets/js/114.bf1fe841.js"><link rel="prefetch" href="/assets/js/115.528cda1d.js"><link rel="prefetch" href="/assets/js/116.763ead1d.js"><link rel="prefetch" href="/assets/js/117.34441361.js"><link rel="prefetch" href="/assets/js/118.c2814fb8.js"><link rel="prefetch" href="/assets/js/119.666d003a.js"><link rel="prefetch" href="/assets/js/12.26a10771.js"><link rel="prefetch" href="/assets/js/120.6689ad59.js"><link rel="prefetch" href="/assets/js/121.e260fdd5.js"><link rel="prefetch" href="/assets/js/122.f28db74f.js"><link rel="prefetch" href="/assets/js/123.5e201f75.js"><link rel="prefetch" href="/assets/js/124.806d3ac7.js"><link rel="prefetch" href="/assets/js/125.670b8f46.js"><link rel="prefetch" href="/assets/js/126.fb3144a4.js"><link rel="prefetch" href="/assets/js/127.484bbf5c.js"><link rel="prefetch" href="/assets/js/128.c8b4957e.js"><link rel="prefetch" href="/assets/js/129.7814849a.js"><link rel="prefetch" href="/assets/js/13.cd64146f.js"><link rel="prefetch" href="/assets/js/130.02825d29.js"><link rel="prefetch" href="/assets/js/131.0e736cb4.js"><link rel="prefetch" href="/assets/js/132.038f09a6.js"><link rel="prefetch" href="/assets/js/133.1c3d1d7b.js"><link rel="prefetch" href="/assets/js/134.5ed1f677.js"><link rel="prefetch" href="/assets/js/135.3f17944b.js"><link rel="prefetch" href="/assets/js/136.b509f0f5.js"><link rel="prefetch" href="/assets/js/137.5b22ea8d.js"><link rel="prefetch" href="/assets/js/138.98781e3d.js"><link rel="prefetch" href="/assets/js/139.cc2652f5.js"><link rel="prefetch" href="/assets/js/14.f8f59c2a.js"><link rel="prefetch" href="/assets/js/140.9784e496.js"><link rel="prefetch" href="/assets/js/141.2a2995df.js"><link rel="prefetch" href="/assets/js/142.e405ba9a.js"><link rel="prefetch" href="/assets/js/143.2ab64035.js"><link rel="prefetch" href="/assets/js/144.2ac58e57.js"><link rel="prefetch" href="/assets/js/145.acdd536b.js"><link rel="prefetch" href="/assets/js/146.27cf4253.js"><link rel="prefetch" href="/assets/js/147.70d32693.js"><link rel="prefetch" href="/assets/js/148.a443b591.js"><link rel="prefetch" href="/assets/js/149.1924fec7.js"><link rel="prefetch" href="/assets/js/15.0e7120ba.js"><link rel="prefetch" href="/assets/js/150.c162962f.js"><link rel="prefetch" href="/assets/js/151.82faca10.js"><link rel="prefetch" href="/assets/js/152.89c5a57f.js"><link rel="prefetch" href="/assets/js/153.8a9aeb20.js"><link rel="prefetch" href="/assets/js/154.eefdf29e.js"><link rel="prefetch" href="/assets/js/155.96e814c9.js"><link rel="prefetch" href="/assets/js/156.eaef02df.js"><link rel="prefetch" href="/assets/js/157.f13427a7.js"><link rel="prefetch" href="/assets/js/158.c2f9ec68.js"><link rel="prefetch" href="/assets/js/159.cb59b892.js"><link rel="prefetch" href="/assets/js/16.22ec18ce.js"><link rel="prefetch" href="/assets/js/160.f1bba785.js"><link rel="prefetch" href="/assets/js/161.6ba35dd2.js"><link rel="prefetch" href="/assets/js/162.64aec67d.js"><link rel="prefetch" href="/assets/js/163.ac66ae3c.js"><link rel="prefetch" href="/assets/js/164.75db10d4.js"><link rel="prefetch" href="/assets/js/165.ffed9d3c.js"><link rel="prefetch" href="/assets/js/166.292068cd.js"><link rel="prefetch" href="/assets/js/167.b8f0f092.js"><link rel="prefetch" href="/assets/js/168.a2b08bc6.js"><link rel="prefetch" href="/assets/js/169.894010e8.js"><link rel="prefetch" href="/assets/js/17.d134c9d8.js"><link rel="prefetch" href="/assets/js/170.851fd688.js"><link rel="prefetch" href="/assets/js/171.bee60f85.js"><link rel="prefetch" href="/assets/js/172.17301909.js"><link rel="prefetch" href="/assets/js/173.95e440e2.js"><link rel="prefetch" href="/assets/js/174.d1c66edd.js"><link rel="prefetch" href="/assets/js/175.e54e4061.js"><link rel="prefetch" href="/assets/js/176.b01610c1.js"><link rel="prefetch" href="/assets/js/177.6602f657.js"><link rel="prefetch" href="/assets/js/178.506e9107.js"><link rel="prefetch" href="/assets/js/179.6792a8f0.js"><link rel="prefetch" href="/assets/js/18.e640e522.js"><link rel="prefetch" href="/assets/js/180.7d058689.js"><link rel="prefetch" href="/assets/js/181.52afb246.js"><link rel="prefetch" href="/assets/js/182.af025d86.js"><link rel="prefetch" href="/assets/js/183.718514b3.js"><link rel="prefetch" href="/assets/js/184.2f135dd7.js"><link rel="prefetch" href="/assets/js/185.c750908d.js"><link rel="prefetch" href="/assets/js/186.4c87c04d.js"><link rel="prefetch" href="/assets/js/187.b3780896.js"><link rel="prefetch" href="/assets/js/188.1a21c282.js"><link rel="prefetch" href="/assets/js/189.9acf8d5c.js"><link rel="prefetch" href="/assets/js/19.554dfad4.js"><link rel="prefetch" href="/assets/js/190.cc0cd7d1.js"><link rel="prefetch" href="/assets/js/191.896a7149.js"><link rel="prefetch" href="/assets/js/192.997b6697.js"><link rel="prefetch" href="/assets/js/193.edfcc324.js"><link rel="prefetch" href="/assets/js/194.f7e5dfff.js"><link rel="prefetch" href="/assets/js/195.b31e7d30.js"><link rel="prefetch" href="/assets/js/196.86bc78cf.js"><link rel="prefetch" href="/assets/js/197.cd9b0c3a.js"><link rel="prefetch" href="/assets/js/198.ed57f725.js"><link rel="prefetch" href="/assets/js/199.9610c044.js"><link rel="prefetch" href="/assets/js/20.4b3311fd.js"><link rel="prefetch" href="/assets/js/200.6d6ccdae.js"><link rel="prefetch" href="/assets/js/201.b6446c8f.js"><link rel="prefetch" href="/assets/js/202.7491b7cb.js"><link rel="prefetch" href="/assets/js/203.f882b31f.js"><link rel="prefetch" href="/assets/js/204.a435a4df.js"><link rel="prefetch" href="/assets/js/205.11f449c5.js"><link rel="prefetch" href="/assets/js/206.52b86e55.js"><link rel="prefetch" href="/assets/js/207.365abb89.js"><link rel="prefetch" href="/assets/js/208.edd5ba13.js"><link rel="prefetch" href="/assets/js/209.7537428f.js"><link rel="prefetch" href="/assets/js/21.c90f33d7.js"><link rel="prefetch" href="/assets/js/210.36aa5018.js"><link rel="prefetch" href="/assets/js/211.a657351a.js"><link rel="prefetch" href="/assets/js/212.2a8a092d.js"><link rel="prefetch" href="/assets/js/213.4a904163.js"><link rel="prefetch" href="/assets/js/214.20fc09c1.js"><link rel="prefetch" href="/assets/js/215.dd0baa0c.js"><link rel="prefetch" href="/assets/js/216.0898f799.js"><link rel="prefetch" href="/assets/js/217.65cf1eba.js"><link rel="prefetch" href="/assets/js/218.aba2c019.js"><link rel="prefetch" href="/assets/js/219.ff1353e7.js"><link rel="prefetch" href="/assets/js/22.7a1f06fe.js"><link rel="prefetch" href="/assets/js/220.ed26afb4.js"><link rel="prefetch" href="/assets/js/221.2dbabfdd.js"><link rel="prefetch" href="/assets/js/222.307bdc05.js"><link rel="prefetch" href="/assets/js/223.e0731710.js"><link rel="prefetch" href="/assets/js/224.ac831490.js"><link rel="prefetch" href="/assets/js/225.a9797599.js"><link rel="prefetch" href="/assets/js/226.85a77987.js"><link rel="prefetch" href="/assets/js/227.6273e947.js"><link rel="prefetch" href="/assets/js/228.9cf4477d.js"><link rel="prefetch" href="/assets/js/229.ad7b2a28.js"><link rel="prefetch" href="/assets/js/23.bce95595.js"><link rel="prefetch" href="/assets/js/230.276e0251.js"><link rel="prefetch" href="/assets/js/231.3db2a0fa.js"><link rel="prefetch" href="/assets/js/232.b4bd9a55.js"><link rel="prefetch" href="/assets/js/233.53776299.js"><link rel="prefetch" href="/assets/js/234.05ad11c6.js"><link rel="prefetch" href="/assets/js/235.98e38acf.js"><link rel="prefetch" href="/assets/js/236.d975a1d2.js"><link rel="prefetch" href="/assets/js/237.de4279d3.js"><link rel="prefetch" href="/assets/js/238.f4594499.js"><link rel="prefetch" href="/assets/js/239.e8fd0643.js"><link rel="prefetch" href="/assets/js/24.887866cf.js"><link rel="prefetch" href="/assets/js/240.105e2a7c.js"><link rel="prefetch" href="/assets/js/241.4b5f2bee.js"><link rel="prefetch" href="/assets/js/242.f25a0ad8.js"><link rel="prefetch" href="/assets/js/243.0d5e5ae8.js"><link rel="prefetch" href="/assets/js/244.355a7c6d.js"><link rel="prefetch" href="/assets/js/245.e2747a0f.js"><link rel="prefetch" href="/assets/js/246.4814cde5.js"><link rel="prefetch" href="/assets/js/247.41684524.js"><link rel="prefetch" href="/assets/js/248.536526ef.js"><link rel="prefetch" href="/assets/js/249.35b26de1.js"><link rel="prefetch" href="/assets/js/25.957ff41a.js"><link rel="prefetch" href="/assets/js/250.99cdec3c.js"><link rel="prefetch" href="/assets/js/251.605292d5.js"><link rel="prefetch" href="/assets/js/252.d05db63c.js"><link rel="prefetch" href="/assets/js/253.8c041ed8.js"><link rel="prefetch" href="/assets/js/254.c03b32fe.js"><link rel="prefetch" href="/assets/js/255.0002399b.js"><link rel="prefetch" href="/assets/js/256.972cf088.js"><link rel="prefetch" href="/assets/js/257.5f5e6d0e.js"><link rel="prefetch" href="/assets/js/258.e0a5fdc0.js"><link rel="prefetch" href="/assets/js/259.9b4e9ad2.js"><link rel="prefetch" href="/assets/js/26.c8060b33.js"><link rel="prefetch" href="/assets/js/260.8fc4798b.js"><link rel="prefetch" href="/assets/js/261.b7fa504b.js"><link rel="prefetch" href="/assets/js/262.c1e05910.js"><link rel="prefetch" href="/assets/js/263.3d18dc63.js"><link rel="prefetch" href="/assets/js/264.8a2db8a2.js"><link rel="prefetch" href="/assets/js/265.94d31290.js"><link rel="prefetch" href="/assets/js/266.59db673f.js"><link rel="prefetch" href="/assets/js/267.015dfed5.js"><link rel="prefetch" href="/assets/js/268.f70f6b44.js"><link rel="prefetch" href="/assets/js/269.672a997b.js"><link rel="prefetch" href="/assets/js/27.2476b973.js"><link rel="prefetch" href="/assets/js/270.e5ee9893.js"><link rel="prefetch" href="/assets/js/271.c297d886.js"><link rel="prefetch" href="/assets/js/272.82f549fa.js"><link rel="prefetch" href="/assets/js/273.5c88635e.js"><link rel="prefetch" href="/assets/js/274.a7f437ff.js"><link rel="prefetch" href="/assets/js/275.76da86b8.js"><link rel="prefetch" href="/assets/js/276.1e3ac385.js"><link rel="prefetch" href="/assets/js/277.ca8fea07.js"><link rel="prefetch" href="/assets/js/278.a86fb436.js"><link rel="prefetch" href="/assets/js/279.d84dba71.js"><link rel="prefetch" href="/assets/js/28.112d911e.js"><link rel="prefetch" href="/assets/js/280.c56e2c2b.js"><link rel="prefetch" href="/assets/js/281.6a5183bc.js"><link rel="prefetch" href="/assets/js/282.4ee881f8.js"><link rel="prefetch" href="/assets/js/283.ed1f376b.js"><link rel="prefetch" href="/assets/js/284.7f612c82.js"><link rel="prefetch" href="/assets/js/285.9512cabe.js"><link rel="prefetch" href="/assets/js/286.25f46725.js"><link rel="prefetch" href="/assets/js/287.32ab5626.js"><link rel="prefetch" href="/assets/js/288.16a3e78c.js"><link rel="prefetch" href="/assets/js/289.3a9ad6c5.js"><link rel="prefetch" href="/assets/js/29.430f946b.js"><link rel="prefetch" href="/assets/js/290.66371c9f.js"><link rel="prefetch" href="/assets/js/291.bb1fd8ca.js"><link rel="prefetch" href="/assets/js/292.16654a32.js"><link rel="prefetch" href="/assets/js/293.bc5f2edd.js"><link rel="prefetch" href="/assets/js/294.0b4534d4.js"><link rel="prefetch" href="/assets/js/295.3fdee573.js"><link rel="prefetch" href="/assets/js/296.ba646b1b.js"><link rel="prefetch" href="/assets/js/297.4fc8c2fc.js"><link rel="prefetch" href="/assets/js/298.24de5e87.js"><link rel="prefetch" href="/assets/js/299.983179df.js"><link rel="prefetch" href="/assets/js/30.d46382c7.js"><link rel="prefetch" href="/assets/js/300.f247dc2a.js"><link rel="prefetch" href="/assets/js/301.fa3fd2b2.js"><link rel="prefetch" href="/assets/js/302.bb1de367.js"><link rel="prefetch" href="/assets/js/303.cd1328f2.js"><link rel="prefetch" href="/assets/js/304.0494314e.js"><link rel="prefetch" href="/assets/js/305.38cd6f26.js"><link rel="prefetch" href="/assets/js/306.55e7ead5.js"><link rel="prefetch" href="/assets/js/307.bd167747.js"><link rel="prefetch" href="/assets/js/308.b859ed93.js"><link rel="prefetch" href="/assets/js/309.335f24b7.js"><link rel="prefetch" href="/assets/js/31.e244252e.js"><link rel="prefetch" href="/assets/js/310.934b0a33.js"><link rel="prefetch" href="/assets/js/312.c0f6001e.js"><link rel="prefetch" href="/assets/js/313.70ba3f4b.js"><link rel="prefetch" href="/assets/js/314.534a4be1.js"><link rel="prefetch" href="/assets/js/315.ed1bc2f6.js"><link rel="prefetch" href="/assets/js/316.38c211b1.js"><link rel="prefetch" href="/assets/js/317.b03ba6d9.js"><link rel="prefetch" href="/assets/js/318.6e795d26.js"><link rel="prefetch" href="/assets/js/319.03c7f58c.js"><link rel="prefetch" href="/assets/js/32.d905c2cd.js"><link rel="prefetch" href="/assets/js/320.c5e3d1f3.js"><link rel="prefetch" href="/assets/js/321.022baf3d.js"><link rel="prefetch" href="/assets/js/322.e0c8d7ab.js"><link rel="prefetch" href="/assets/js/323.d5f6e667.js"><link rel="prefetch" href="/assets/js/324.ca18024b.js"><link rel="prefetch" href="/assets/js/325.39192cbd.js"><link rel="prefetch" href="/assets/js/326.29f462df.js"><link rel="prefetch" href="/assets/js/327.72807cb6.js"><link rel="prefetch" href="/assets/js/328.c7edebfc.js"><link rel="prefetch" href="/assets/js/329.9ca35978.js"><link rel="prefetch" href="/assets/js/33.a34a1c24.js"><link rel="prefetch" href="/assets/js/330.57eaedf7.js"><link rel="prefetch" href="/assets/js/331.059af8f9.js"><link rel="prefetch" href="/assets/js/332.6cc91623.js"><link rel="prefetch" href="/assets/js/333.0fcbafb4.js"><link rel="prefetch" href="/assets/js/334.b4dd2028.js"><link rel="prefetch" href="/assets/js/335.88104646.js"><link rel="prefetch" href="/assets/js/336.b0425564.js"><link rel="prefetch" href="/assets/js/337.6413381a.js"><link rel="prefetch" href="/assets/js/338.468a71ff.js"><link rel="prefetch" href="/assets/js/339.39c8d256.js"><link rel="prefetch" href="/assets/js/34.fec188a0.js"><link rel="prefetch" href="/assets/js/340.6c2f13d9.js"><link rel="prefetch" href="/assets/js/341.d563f7a0.js"><link rel="prefetch" href="/assets/js/342.f644a714.js"><link rel="prefetch" href="/assets/js/343.7577cdc6.js"><link rel="prefetch" href="/assets/js/344.2858b478.js"><link rel="prefetch" href="/assets/js/345.580b30c8.js"><link rel="prefetch" href="/assets/js/346.31937d51.js"><link rel="prefetch" href="/assets/js/347.0cb91c0c.js"><link rel="prefetch" href="/assets/js/348.457d2602.js"><link rel="prefetch" href="/assets/js/349.0f40477a.js"><link rel="prefetch" href="/assets/js/35.a7511c1e.js"><link rel="prefetch" href="/assets/js/350.d135cfba.js"><link rel="prefetch" href="/assets/js/351.e93ead26.js"><link rel="prefetch" href="/assets/js/352.21185cb1.js"><link rel="prefetch" href="/assets/js/353.d21f105a.js"><link rel="prefetch" href="/assets/js/354.1bcd3bd7.js"><link rel="prefetch" href="/assets/js/355.5c59a441.js"><link rel="prefetch" href="/assets/js/356.faf1af8d.js"><link rel="prefetch" href="/assets/js/357.75c04705.js"><link rel="prefetch" href="/assets/js/358.ca3a90b8.js"><link rel="prefetch" href="/assets/js/359.855fba63.js"><link rel="prefetch" href="/assets/js/36.4b2d3a4f.js"><link rel="prefetch" href="/assets/js/360.27218a17.js"><link rel="prefetch" href="/assets/js/361.effdafc4.js"><link rel="prefetch" href="/assets/js/362.ded22ed8.js"><link rel="prefetch" href="/assets/js/363.6bfd858a.js"><link rel="prefetch" href="/assets/js/364.33cb94a1.js"><link rel="prefetch" href="/assets/js/365.201d9472.js"><link rel="prefetch" href="/assets/js/366.79ed763f.js"><link rel="prefetch" href="/assets/js/367.134d2beb.js"><link rel="prefetch" href="/assets/js/368.09c105ad.js"><link rel="prefetch" href="/assets/js/369.c292fc98.js"><link rel="prefetch" href="/assets/js/37.c842407e.js"><link rel="prefetch" href="/assets/js/370.c72ef481.js"><link rel="prefetch" href="/assets/js/371.91a9253e.js"><link rel="prefetch" href="/assets/js/372.540333ee.js"><link rel="prefetch" href="/assets/js/373.e1991e99.js"><link rel="prefetch" href="/assets/js/374.643c1cea.js"><link rel="prefetch" href="/assets/js/375.7b57ff77.js"><link rel="prefetch" href="/assets/js/376.3137353e.js"><link rel="prefetch" href="/assets/js/377.1401ad75.js"><link rel="prefetch" href="/assets/js/378.4e2820a1.js"><link rel="prefetch" href="/assets/js/379.72ed9a3c.js"><link rel="prefetch" href="/assets/js/38.6059c476.js"><link rel="prefetch" href="/assets/js/380.5689ddbe.js"><link rel="prefetch" href="/assets/js/381.c0a999f0.js"><link rel="prefetch" href="/assets/js/382.94590ec0.js"><link rel="prefetch" href="/assets/js/383.fb86c446.js"><link rel="prefetch" href="/assets/js/384.36db2c6e.js"><link rel="prefetch" href="/assets/js/385.6d599fe6.js"><link rel="prefetch" href="/assets/js/386.be870130.js"><link rel="prefetch" href="/assets/js/387.bc686a46.js"><link rel="prefetch" href="/assets/js/388.90303374.js"><link rel="prefetch" href="/assets/js/389.6c75c596.js"><link rel="prefetch" href="/assets/js/39.18777c77.js"><link rel="prefetch" href="/assets/js/390.50b8fde5.js"><link rel="prefetch" href="/assets/js/391.4a8a9d82.js"><link rel="prefetch" href="/assets/js/392.4fa2b118.js"><link rel="prefetch" href="/assets/js/393.6fd5e484.js"><link rel="prefetch" href="/assets/js/394.21cd1b25.js"><link rel="prefetch" href="/assets/js/395.d48e07d5.js"><link rel="prefetch" href="/assets/js/396.5f8c78de.js"><link rel="prefetch" href="/assets/js/397.8f1f4f18.js"><link rel="prefetch" href="/assets/js/398.45f67cf6.js"><link rel="prefetch" href="/assets/js/399.58b103d5.js"><link rel="prefetch" href="/assets/js/40.c581224f.js"><link rel="prefetch" href="/assets/js/400.7fca70bc.js"><link rel="prefetch" href="/assets/js/401.457e4e30.js"><link rel="prefetch" href="/assets/js/402.13d27406.js"><link rel="prefetch" href="/assets/js/403.28b9c70f.js"><link rel="prefetch" href="/assets/js/404.982889d5.js"><link rel="prefetch" href="/assets/js/405.997965a4.js"><link rel="prefetch" href="/assets/js/406.9de4bd8f.js"><link rel="prefetch" href="/assets/js/407.22c1b709.js"><link rel="prefetch" href="/assets/js/408.7657b0ab.js"><link rel="prefetch" href="/assets/js/409.1cffd108.js"><link rel="prefetch" href="/assets/js/41.d4842a5b.js"><link rel="prefetch" href="/assets/js/410.b26e1d57.js"><link rel="prefetch" href="/assets/js/411.ddfb8b21.js"><link rel="prefetch" href="/assets/js/412.deeb5e0e.js"><link rel="prefetch" href="/assets/js/413.223b8db3.js"><link rel="prefetch" href="/assets/js/414.03f62538.js"><link rel="prefetch" href="/assets/js/415.aa7d5b53.js"><link rel="prefetch" href="/assets/js/416.cec587b0.js"><link rel="prefetch" href="/assets/js/417.c9a3968a.js"><link rel="prefetch" href="/assets/js/418.78813764.js"><link rel="prefetch" href="/assets/js/419.eb5ade66.js"><link rel="prefetch" href="/assets/js/42.c88c6cb7.js"><link rel="prefetch" href="/assets/js/420.c8463946.js"><link rel="prefetch" href="/assets/js/421.7af022b4.js"><link rel="prefetch" href="/assets/js/422.863655c3.js"><link rel="prefetch" href="/assets/js/423.bfe30a0f.js"><link rel="prefetch" href="/assets/js/424.590b4282.js"><link rel="prefetch" href="/assets/js/425.0c722a85.js"><link rel="prefetch" href="/assets/js/426.49c576ef.js"><link rel="prefetch" href="/assets/js/427.3d3d3823.js"><link rel="prefetch" href="/assets/js/428.4f78ea6c.js"><link rel="prefetch" href="/assets/js/429.5fe617b2.js"><link rel="prefetch" href="/assets/js/43.90ce3a73.js"><link rel="prefetch" href="/assets/js/430.72233f4d.js"><link rel="prefetch" href="/assets/js/431.7a404ba7.js"><link rel="prefetch" href="/assets/js/432.fbbfcb8a.js"><link rel="prefetch" href="/assets/js/433.93b25751.js"><link rel="prefetch" href="/assets/js/434.65d855ed.js"><link rel="prefetch" href="/assets/js/435.14b85953.js"><link rel="prefetch" href="/assets/js/436.c33706ff.js"><link rel="prefetch" href="/assets/js/437.1baa314f.js"><link rel="prefetch" href="/assets/js/438.069136ba.js"><link rel="prefetch" href="/assets/js/439.0b848bcd.js"><link rel="prefetch" href="/assets/js/44.64e262ab.js"><link rel="prefetch" href="/assets/js/440.51fca2af.js"><link rel="prefetch" href="/assets/js/441.8c8f8cc9.js"><link rel="prefetch" href="/assets/js/442.7504dd8e.js"><link rel="prefetch" href="/assets/js/443.3474cd36.js"><link rel="prefetch" href="/assets/js/444.5fb28a3d.js"><link rel="prefetch" href="/assets/js/445.d6af7350.js"><link rel="prefetch" href="/assets/js/446.1ac60bee.js"><link rel="prefetch" href="/assets/js/447.de416e93.js"><link rel="prefetch" href="/assets/js/448.4684720f.js"><link rel="prefetch" href="/assets/js/449.a1bb01c0.js"><link rel="prefetch" href="/assets/js/45.6231efe5.js"><link rel="prefetch" href="/assets/js/450.d175f56a.js"><link rel="prefetch" href="/assets/js/451.5d0f5b0b.js"><link rel="prefetch" href="/assets/js/452.7c97fa86.js"><link rel="prefetch" href="/assets/js/453.e8bf8887.js"><link rel="prefetch" href="/assets/js/454.e6523341.js"><link rel="prefetch" href="/assets/js/455.4a1a0c54.js"><link rel="prefetch" href="/assets/js/456.56f8b1d3.js"><link rel="prefetch" href="/assets/js/457.921cbb60.js"><link rel="prefetch" href="/assets/js/458.1d36727e.js"><link rel="prefetch" href="/assets/js/459.a99c7d50.js"><link rel="prefetch" href="/assets/js/46.9339507a.js"><link rel="prefetch" href="/assets/js/460.eca58a4f.js"><link rel="prefetch" href="/assets/js/461.4e20b7b5.js"><link rel="prefetch" href="/assets/js/462.f967c8ef.js"><link rel="prefetch" href="/assets/js/463.50f98b65.js"><link rel="prefetch" href="/assets/js/464.53a27dd7.js"><link rel="prefetch" href="/assets/js/465.f405390b.js"><link rel="prefetch" href="/assets/js/466.ff9f2146.js"><link rel="prefetch" href="/assets/js/467.721b342d.js"><link rel="prefetch" href="/assets/js/468.65af50d2.js"><link rel="prefetch" href="/assets/js/469.907b109f.js"><link rel="prefetch" href="/assets/js/47.60894af2.js"><link rel="prefetch" href="/assets/js/470.017ad3be.js"><link rel="prefetch" href="/assets/js/471.b514ba1c.js"><link rel="prefetch" href="/assets/js/472.7e20de3c.js"><link rel="prefetch" href="/assets/js/473.d061a8f4.js"><link rel="prefetch" href="/assets/js/474.35f3120e.js"><link rel="prefetch" href="/assets/js/475.b0eaaafa.js"><link rel="prefetch" href="/assets/js/476.0a93303d.js"><link rel="prefetch" href="/assets/js/477.c9ffa963.js"><link rel="prefetch" href="/assets/js/478.c58ad168.js"><link rel="prefetch" href="/assets/js/479.baa2fb5c.js"><link rel="prefetch" href="/assets/js/48.d5735fb1.js"><link rel="prefetch" href="/assets/js/480.db4b72ed.js"><link rel="prefetch" href="/assets/js/481.f9880ad1.js"><link rel="prefetch" href="/assets/js/482.f2e976df.js"><link rel="prefetch" href="/assets/js/483.398fde55.js"><link rel="prefetch" href="/assets/js/484.95f23223.js"><link rel="prefetch" href="/assets/js/485.63ffa136.js"><link rel="prefetch" href="/assets/js/486.db2e0c2b.js"><link rel="prefetch" href="/assets/js/487.ab71eadf.js"><link rel="prefetch" href="/assets/js/488.d24d37c4.js"><link rel="prefetch" href="/assets/js/489.b610403a.js"><link rel="prefetch" href="/assets/js/49.8391c2e1.js"><link rel="prefetch" href="/assets/js/490.a9ca3d3f.js"><link rel="prefetch" href="/assets/js/491.9dae374a.js"><link rel="prefetch" href="/assets/js/492.211497eb.js"><link rel="prefetch" href="/assets/js/493.b89c949c.js"><link rel="prefetch" href="/assets/js/494.38299feb.js"><link rel="prefetch" href="/assets/js/495.049b7f92.js"><link rel="prefetch" href="/assets/js/496.2a2ee823.js"><link rel="prefetch" href="/assets/js/497.03b24330.js"><link rel="prefetch" href="/assets/js/498.3299e21a.js"><link rel="prefetch" href="/assets/js/499.e426da21.js"><link rel="prefetch" href="/assets/js/5.eace4687.js"><link rel="prefetch" href="/assets/js/50.d51914be.js"><link rel="prefetch" href="/assets/js/500.a95dedcb.js"><link rel="prefetch" href="/assets/js/501.fbf7aed5.js"><link rel="prefetch" href="/assets/js/502.236f3361.js"><link rel="prefetch" href="/assets/js/503.74c89220.js"><link rel="prefetch" href="/assets/js/504.e01b0040.js"><link rel="prefetch" href="/assets/js/505.c9fb4bf0.js"><link rel="prefetch" href="/assets/js/506.27b744be.js"><link rel="prefetch" href="/assets/js/507.52ddc0c1.js"><link rel="prefetch" href="/assets/js/508.c1c03934.js"><link rel="prefetch" href="/assets/js/509.549cd70f.js"><link rel="prefetch" href="/assets/js/51.c6284764.js"><link rel="prefetch" href="/assets/js/510.3b69cf75.js"><link rel="prefetch" href="/assets/js/511.f8efe3a9.js"><link rel="prefetch" href="/assets/js/512.5884030d.js"><link rel="prefetch" href="/assets/js/513.d4d58d76.js"><link rel="prefetch" href="/assets/js/514.8d6061b7.js"><link rel="prefetch" href="/assets/js/515.d58e41bc.js"><link rel="prefetch" href="/assets/js/516.407c9790.js"><link rel="prefetch" href="/assets/js/517.ce07dd19.js"><link rel="prefetch" href="/assets/js/518.2842f37d.js"><link rel="prefetch" href="/assets/js/519.f04855de.js"><link rel="prefetch" href="/assets/js/52.0052906b.js"><link rel="prefetch" href="/assets/js/520.33769056.js"><link rel="prefetch" href="/assets/js/521.33e5b0db.js"><link rel="prefetch" href="/assets/js/522.dd724362.js"><link rel="prefetch" href="/assets/js/523.c2b2fe1b.js"><link rel="prefetch" href="/assets/js/524.d503889d.js"><link rel="prefetch" href="/assets/js/525.1791a190.js"><link rel="prefetch" href="/assets/js/526.e97fd226.js"><link rel="prefetch" href="/assets/js/527.d1b3155b.js"><link rel="prefetch" href="/assets/js/528.8b0d61e1.js"><link rel="prefetch" href="/assets/js/529.30a18745.js"><link rel="prefetch" href="/assets/js/53.355eef4b.js"><link rel="prefetch" href="/assets/js/530.3a222133.js"><link rel="prefetch" href="/assets/js/531.f0e1875e.js"><link rel="prefetch" href="/assets/js/532.edaa8a87.js"><link rel="prefetch" href="/assets/js/533.2daeb978.js"><link rel="prefetch" href="/assets/js/534.9dd61465.js"><link rel="prefetch" href="/assets/js/535.03a1f7f3.js"><link rel="prefetch" href="/assets/js/536.c8747dc3.js"><link rel="prefetch" href="/assets/js/537.c07f16f7.js"><link rel="prefetch" href="/assets/js/538.4d7a282b.js"><link rel="prefetch" href="/assets/js/539.e5d8fc44.js"><link rel="prefetch" href="/assets/js/54.ca948b5b.js"><link rel="prefetch" href="/assets/js/540.568b7bb9.js"><link rel="prefetch" href="/assets/js/541.cc3c7bf3.js"><link rel="prefetch" href="/assets/js/542.1e7d71fb.js"><link rel="prefetch" href="/assets/js/543.ce0b8bc5.js"><link rel="prefetch" href="/assets/js/544.6984f071.js"><link rel="prefetch" href="/assets/js/545.85fcefdc.js"><link rel="prefetch" href="/assets/js/546.054bdeeb.js"><link rel="prefetch" href="/assets/js/547.7d6e42f8.js"><link rel="prefetch" href="/assets/js/548.9fdd0357.js"><link rel="prefetch" href="/assets/js/549.e3c4bda8.js"><link rel="prefetch" href="/assets/js/55.9907a531.js"><link rel="prefetch" href="/assets/js/550.2723036d.js"><link rel="prefetch" href="/assets/js/551.603480e2.js"><link rel="prefetch" href="/assets/js/552.cfbb9201.js"><link rel="prefetch" href="/assets/js/553.4f157b97.js"><link rel="prefetch" href="/assets/js/554.be5b47c5.js"><link rel="prefetch" href="/assets/js/555.ced4f3d3.js"><link rel="prefetch" href="/assets/js/556.e87c33c8.js"><link rel="prefetch" href="/assets/js/557.cbb48495.js"><link rel="prefetch" href="/assets/js/558.f7482f86.js"><link rel="prefetch" href="/assets/js/559.e84a64ab.js"><link rel="prefetch" href="/assets/js/56.90d1bc94.js"><link rel="prefetch" href="/assets/js/560.5cecae0c.js"><link rel="prefetch" href="/assets/js/561.db8f05dd.js"><link rel="prefetch" href="/assets/js/562.c605ffae.js"><link rel="prefetch" href="/assets/js/563.7cb7ad86.js"><link rel="prefetch" href="/assets/js/564.4644c5a6.js"><link rel="prefetch" href="/assets/js/565.32642e9c.js"><link rel="prefetch" href="/assets/js/566.9a4311be.js"><link rel="prefetch" href="/assets/js/567.d0683527.js"><link rel="prefetch" href="/assets/js/568.81128faf.js"><link rel="prefetch" href="/assets/js/569.ce6d29a6.js"><link rel="prefetch" href="/assets/js/57.c86cddb9.js"><link rel="prefetch" href="/assets/js/570.2456b712.js"><link rel="prefetch" href="/assets/js/571.aac9ba80.js"><link rel="prefetch" href="/assets/js/572.5f9a6d45.js"><link rel="prefetch" href="/assets/js/573.2a7779ad.js"><link rel="prefetch" href="/assets/js/574.0742d701.js"><link rel="prefetch" href="/assets/js/575.b5ae9dd1.js"><link rel="prefetch" href="/assets/js/576.abe5b760.js"><link rel="prefetch" href="/assets/js/577.2e0cba12.js"><link rel="prefetch" href="/assets/js/578.98af2add.js"><link rel="prefetch" href="/assets/js/579.9aed8c04.js"><link rel="prefetch" href="/assets/js/58.19b45ba6.js"><link rel="prefetch" href="/assets/js/580.1595ea15.js"><link rel="prefetch" href="/assets/js/581.fcf612e4.js"><link rel="prefetch" href="/assets/js/582.910c54de.js"><link rel="prefetch" href="/assets/js/583.a34483d9.js"><link rel="prefetch" href="/assets/js/584.70d64527.js"><link rel="prefetch" href="/assets/js/585.5ea6b3e5.js"><link rel="prefetch" href="/assets/js/586.db13f96e.js"><link rel="prefetch" href="/assets/js/587.bf883385.js"><link rel="prefetch" href="/assets/js/588.c1466d25.js"><link rel="prefetch" href="/assets/js/589.4ec92587.js"><link rel="prefetch" href="/assets/js/59.299b0b27.js"><link rel="prefetch" href="/assets/js/590.7c155fdb.js"><link rel="prefetch" href="/assets/js/591.ebae3557.js"><link rel="prefetch" href="/assets/js/592.0956ab15.js"><link rel="prefetch" href="/assets/js/593.ea31c530.js"><link rel="prefetch" href="/assets/js/594.658fca38.js"><link rel="prefetch" href="/assets/js/595.ddbbdc10.js"><link rel="prefetch" href="/assets/js/596.c24c8026.js"><link rel="prefetch" href="/assets/js/597.88748ffe.js"><link rel="prefetch" href="/assets/js/598.cec78e4d.js"><link rel="prefetch" href="/assets/js/599.a8f7a498.js"><link rel="prefetch" href="/assets/js/6.008dd0d6.js"><link rel="prefetch" href="/assets/js/60.287cfb0d.js"><link rel="prefetch" href="/assets/js/600.979d8dda.js"><link rel="prefetch" href="/assets/js/601.445e0ae7.js"><link rel="prefetch" href="/assets/js/602.d4b357d6.js"><link rel="prefetch" href="/assets/js/603.f5555cc4.js"><link rel="prefetch" href="/assets/js/604.b97d0641.js"><link rel="prefetch" href="/assets/js/605.b1adcf8f.js"><link rel="prefetch" href="/assets/js/606.099c5cc0.js"><link rel="prefetch" href="/assets/js/607.0ccc3723.js"><link rel="prefetch" href="/assets/js/608.ceda733e.js"><link rel="prefetch" href="/assets/js/609.d644e9f4.js"><link rel="prefetch" href="/assets/js/61.101494e3.js"><link rel="prefetch" href="/assets/js/610.97edc5b7.js"><link rel="prefetch" href="/assets/js/611.6a63d033.js"><link rel="prefetch" href="/assets/js/612.77cf2e09.js"><link rel="prefetch" href="/assets/js/613.454523c0.js"><link rel="prefetch" href="/assets/js/614.586f59e3.js"><link rel="prefetch" href="/assets/js/615.512e958b.js"><link rel="prefetch" href="/assets/js/616.0a455969.js"><link rel="prefetch" href="/assets/js/617.7657723d.js"><link rel="prefetch" href="/assets/js/618.e1e77dbc.js"><link rel="prefetch" href="/assets/js/619.8b9ac557.js"><link rel="prefetch" href="/assets/js/62.3de0bc0b.js"><link rel="prefetch" href="/assets/js/620.c7d354b1.js"><link rel="prefetch" href="/assets/js/621.94f87c1f.js"><link rel="prefetch" href="/assets/js/622.7ae48b4b.js"><link rel="prefetch" href="/assets/js/623.3c371fca.js"><link rel="prefetch" href="/assets/js/624.dad907c8.js"><link rel="prefetch" href="/assets/js/625.a31335e9.js"><link rel="prefetch" href="/assets/js/626.428bab7e.js"><link rel="prefetch" href="/assets/js/627.5823614e.js"><link rel="prefetch" href="/assets/js/628.c8ae8496.js"><link rel="prefetch" href="/assets/js/629.6e383535.js"><link rel="prefetch" href="/assets/js/63.26b80690.js"><link rel="prefetch" href="/assets/js/630.444ca9ee.js"><link rel="prefetch" href="/assets/js/631.b311c084.js"><link rel="prefetch" href="/assets/js/632.74224a1c.js"><link rel="prefetch" href="/assets/js/633.e7884efd.js"><link rel="prefetch" href="/assets/js/634.e46a2f9c.js"><link rel="prefetch" href="/assets/js/635.ec46017b.js"><link rel="prefetch" href="/assets/js/636.16f35f64.js"><link rel="prefetch" href="/assets/js/637.47e17cac.js"><link rel="prefetch" href="/assets/js/638.f551e4bc.js"><link rel="prefetch" href="/assets/js/639.0a2acabd.js"><link rel="prefetch" href="/assets/js/64.f0ead63e.js"><link rel="prefetch" href="/assets/js/640.311cc5d7.js"><link rel="prefetch" href="/assets/js/641.ce05a761.js"><link rel="prefetch" href="/assets/js/642.7aaa4ac9.js"><link rel="prefetch" href="/assets/js/643.aac8e411.js"><link rel="prefetch" href="/assets/js/644.14b46f57.js"><link rel="prefetch" href="/assets/js/645.a0106e32.js"><link rel="prefetch" href="/assets/js/646.3880e83e.js"><link rel="prefetch" href="/assets/js/647.c48d4743.js"><link rel="prefetch" href="/assets/js/648.0ed73224.js"><link rel="prefetch" href="/assets/js/649.4c4e2394.js"><link rel="prefetch" href="/assets/js/65.af2d3fb6.js"><link rel="prefetch" href="/assets/js/66.6b8a0a43.js"><link rel="prefetch" href="/assets/js/67.61ea30bb.js"><link rel="prefetch" href="/assets/js/68.a38a14f8.js"><link rel="prefetch" href="/assets/js/69.7bf89bfe.js"><link rel="prefetch" href="/assets/js/7.080f75db.js"><link rel="prefetch" href="/assets/js/70.8cc7beca.js"><link rel="prefetch" href="/assets/js/71.b40ada4d.js"><link rel="prefetch" href="/assets/js/72.e2d60055.js"><link rel="prefetch" href="/assets/js/73.399ce982.js"><link rel="prefetch" href="/assets/js/74.f1282d94.js"><link rel="prefetch" href="/assets/js/75.1bb0e055.js"><link rel="prefetch" href="/assets/js/76.5985f97a.js"><link rel="prefetch" href="/assets/js/77.e6ce049c.js"><link rel="prefetch" href="/assets/js/78.46da2fca.js"><link rel="prefetch" href="/assets/js/79.3394bd3a.js"><link rel="prefetch" href="/assets/js/8.d214e90e.js"><link rel="prefetch" href="/assets/js/80.544a992f.js"><link rel="prefetch" href="/assets/js/81.4502b168.js"><link rel="prefetch" href="/assets/js/82.99c8888e.js"><link rel="prefetch" href="/assets/js/83.d2451960.js"><link rel="prefetch" href="/assets/js/84.45605d38.js"><link rel="prefetch" href="/assets/js/85.20d4a699.js"><link rel="prefetch" href="/assets/js/86.a001dd4e.js"><link rel="prefetch" href="/assets/js/87.f97143e5.js"><link rel="prefetch" href="/assets/js/88.74fc80d1.js"><link rel="prefetch" href="/assets/js/89.de6dd42f.js"><link rel="prefetch" href="/assets/js/9.15e59c54.js"><link rel="prefetch" href="/assets/js/90.449bdd39.js"><link rel="prefetch" href="/assets/js/91.e0f253e2.js"><link rel="prefetch" href="/assets/js/92.a91c44ff.js"><link rel="prefetch" href="/assets/js/93.0619a7be.js"><link rel="prefetch" href="/assets/js/94.c068c916.js"><link rel="prefetch" href="/assets/js/95.5d813553.js"><link rel="prefetch" href="/assets/js/96.1174373e.js"><link rel="prefetch" href="/assets/js/97.19f7e28d.js"><link rel="prefetch" href="/assets/js/98.cb6fd2d8.js"><link rel="prefetch" href="/assets/js/99.e9b31298.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.1288603f.js"> |
| <link rel="stylesheet" href="/assets/css/0.styles.c79f5191.css"> |
| </head> |
| <body> |
| <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/" class="home-link router-link-active"><img src="/img/logo.png" alt=" " class="logo"></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/QuickStart/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.12.x/QuickStart/QuickStart.html" class="nav-link">V0.12.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external"> |
| Wiki |
| <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| Foundation |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| License |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| Security |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| Sponsorship |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| Thanks |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| Current Events |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/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">Document</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/QuickStart/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.12.x/QuickStart/QuickStart.html" class="nav-link">V0.12.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.11.x/Get Started/QuickStart.html" class="nav-link">V0.11.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/SystemDesign/Architecture/Architecture.html" class="nav-link">System design</a></div><div class="nav-item"><a href="/Download/" class="nav-link">Download</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Community</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external"> |
| Wiki |
| <!----></a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Project Committers.html" class="nav-link">People</a></li><li class="dropdown-item"><!----> <a href="/Community/Community-Powered By.html" class="nav-link">Powered By</a></li><li class="dropdown-item"><!----> <a href="/Community/Materials.html" class="nav-link">Resources</a></li><li class="dropdown-item"><!----> <a href="/Community/Feedback.html" class="nav-link">Feedback</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Development</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Development/VoteRelease.html" class="nav-link">How to vote</a></li><li class="dropdown-item"><!----> <a href="/Development/HowToCommit.html" class="nav-link">How to Commit</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">Become a Committer</a></li><li class="dropdown-item"><!----> <a href="/Development/ContributeGuide.html" class="nav-link">ContributeGuide</a></li><li class="dropdown-item"><!----> <a href="/Development/format-changelist.html" class="nav-link">Changelist of TsFile</a></li><li class="dropdown-item"><!----> <a href="/Development/rpc-changelist.html" class="nav-link">Changelist of RPC</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Blog</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/Blog/Index.html" class="nav-link">Overview</a></li><li class="dropdown-item"><!----> <a href="/Blog/Release0_93.html" class="nav-link">Some Notes on Release 0.9.3 and upcoming 0.10.0</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| Foundation |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| License |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| Security |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| Sponsorship |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| Thanks |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| Current Events |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">Languages</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/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 User Guide (V0.9.x)</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>0-Get Started</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>1-Overview</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>2-Concept</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>3-Server</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>4-Client</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/UserGuide/V0.9.x/4-Client/1-Command Line Interface.html" class="sidebar-link">Command Line Interface</a></li><li><a href="/UserGuide/V0.9.x/4-Client/2-Programming - JDBC.html" class="sidebar-link">JDBC</a></li><li><a href="/UserGuide/V0.9.x/4-Client/3-Programming - Session.html" class="sidebar-link">Session</a></li><li><a href="/UserGuide/V0.9.x/4-Client/4-Programming - Other Languages.html" class="sidebar-link">Other Languages</a></li><li><a href="/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-Operation Manual</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>6-System Tools</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>7-Ecosystem Integration</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>8-System Design</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="programming-tsfile-api"><a href="#programming-tsfile-api" class="header-anchor">#</a> Programming - TsFile API</h1> <p>TsFile is a file format of Time Series we used in IoTDB. In this section, we would like to introduce the usage of this file format.</p> <h2 id="tsfile-libaray-installation"><a href="#tsfile-libaray-installation" class="header-anchor">#</a> TsFile libaray Installation</h2> <p>There are two ways to use TsFile in your own project.</p> <ul><li><p>Using as jars:</p> <ul><li><p>Compile the source codes and build to 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>Then, all the jars can be get in folder named <code>target/</code>. Import <code>target/tsfile-0.9.3-jar-with-dependencies.jar</code> to your project.</p></li></ul></li> <li><p>Using as a maven dependency:</p> <p>Compile source codes and deploy to your local repository in three steps:</p> <ul><li><p>Get the source codes</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>Compile the source codes and deploy</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>add dependencies into your project:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <dependency> |
| <groupId>org.apache.iotdb</groupId> |
| <artifactId>tsfile</artifactId> |
| <version>0.9.3</version> |
| </dependency> |
| </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>Or, you can download the dependencies from official Maven repository:</p> <ul><li><p>First, find your maven <code>settings.xml</code> on path: <code>${username}\.m2\settings.xml</code> |
| , add this <code><profile></code> to <code><profiles></code>:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <profile> |
| <id>allow-snapshots</id> |
| <activation><activeByDefault>true</activeByDefault></activation> |
| <repositories> |
| <repository> |
| <id>apache.snapshots</id> |
| <name>Apache Development Snapshot Repository</name> |
| <url>https://repository.apache.org/content/repositories/snapshots/</url> |
| <releases> |
| <enabled>false</enabled> |
| </releases> |
| <snapshots> |
| <enabled>true</enabled> |
| </snapshots> |
| </repository> |
| </repositories> |
| </profile> |
| </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>Then add dependencies into your project:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <dependency> |
| <groupId>org.apache.iotdb</groupId> |
| <artifactId>tsfile</artifactId> |
| <version>0.9.3</version> |
| </dependency> |
| </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-usage"><a href="#tsfile-usage" class="header-anchor">#</a> TSFile Usage</h2> <p>This section demonstrates the detailed usages of TsFile.</p> <h3 id="time-series-data"><a href="#time-series-data" class="header-anchor">#</a> Time-series Data</h3> <p>A time-series is considered as a sequence of quadruples. A quadruple is defined as (device, measurement, time, value).</p> <ul><li><p><strong>measurement</strong>: A physical or formal measurement that a time-series is taking, e.g., the temperature of a city, the |
| sales number of some goods or the speed of a train at different times. As a traditional sensor (like a thermometer) also |
| takes a single measurement and produce a time-series, we will use measurement and sensor interchangeably below.</p></li> <li><p><strong>device</strong>: A device refers to an entity that is taking several measurements (producing multiple time-series), e.g., |
| a running train monitors its speed, oil meter, miles it has run, current passengers each is conveyed to a time-series.</p></li></ul> <p>Table 1 illustrates a set of time-series data. The set showed in the following table contains one device named "device_1" |
| with three measurements named "sensor_1", "sensor_2" and "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>A set of time-series data</span> <p><strong>One Line of Data</strong>: In many industrial applications, a device normally contains more than one sensor and these sensors |
| may have values at a same timestamp, which is called one line of data.</p> <p>Formally, one line of data consists of a <code>device_id</code>, a timestamp which indicates the milliseconds since January 1, |
| 1970, 00:00:00, and several data pairs composed of <code>measurement_id</code> and corresponding <code>value</code>. All data pairs in one |
| line belong to this <code>device_id</code> and have the same timestamp. If one of the <code>measurements</code> does not have a <code>value</code> |
| in the <code>timestamp</code>, use a space instead(Actually, TsFile does not store null values). Its format is shown as follow:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_id, timestamp, <measurement_id, value>... |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>An example is illustrated as follow. In this example, the data type of two measurements are <code>INT32</code>, <code>FLOAT</code> respectively.</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="writing-tsfile"><a href="#writing-tsfile" class="header-anchor">#</a> Writing TsFile</h3> <h4 id="generate-a-tsfile-file"><a href="#generate-a-tsfile-file" class="header-anchor">#</a> Generate a TsFile File.</h4> <p>A TsFile can be generated by following three steps and the complete code will be given in the section "Example for writing TsFile".</p> <ul><li><p>First, construct a <code>TsFileWriter</code> instance.</p> <p>Here are the available constructors:</p> <ul><li>Without pre-defined schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li>With pre-defined schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file, Schema schema) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>This one is for using the HDFS file system. <code>TsFileOutput</code> can be an instance of class <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>If you want to set some TSFile configuration on your own, you could use param <code>config</code>. For example:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig conf = new TSFileConfig(); |
| conf.setTSFileStorageFs("HDFS"); |
| 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>In this example, data files will be stored in HDFS, instead of local file system. If you'd like to store data files in local file system, you can use <code>conf.setTSFileStorageFs("LOCAL")</code>, which is also the default config.</p> <p>You can also config the ip and port of your HDFS by <code>config.setHdfsIp(...)</code> and <code>config.setHdfsPort(...)</code>. The default ip is <code>localhost</code> and default port is <code>9000</code>.</p> <p><strong>Parameters:</strong></p> <ul><li><p>file : The TsFile to write</p></li> <li><p>schema : The file schemas, will be introduced in next part.</p></li> <li><p>config : The config of TsFile.</p></li></ul></li> <li><p>Second, add measurements</p> <p>Or you can make an instance of class <code>Schema</code> first and pass this to the constructor of class <code>TsFileWriter</code></p> <p>The class <code>Schema</code> contains a map whose key is the name of one measurement schema, and the value is the schema itself.</p> <p>Here are the interfaces:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// Create an empty Schema or from an existing map |
| public Schema() |
| public Schema(Map<String, MeasurementSchema> measurements) |
| // Use this two interfaces to add measurements |
| public void registerMeasurement(MeasurementSchema descriptor) |
| public void registerMeasurements(Map<String, MeasurementSchema> measurements) |
| // Some useful getter and checker |
| public TSDataType getMeasurementDataType(String measurementId) |
| public MeasurementSchema getMeasurementSchema(String measurementId) |
| public Map<String, MeasurementSchema> 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>You can always use the following interface in <code>TsFileWriter</code> class to add additional measurements: |
| </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>The class <code>MeasurementSchema</code> contains the information of one measurement, there are several constructors:</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<String, String> 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>Parameters:</strong> |
| </p> <ul><li><p>measurementID: The name of this measurement, typically the name of the sensor.</p></li> <li><p>type: The data type, now support six types: <code>BOOLEAN</code>, <code>INT32</code>, <code>INT64</code>, <code>FLOAT</code>, <code>DOUBLE</code>, <code>TEXT</code>;</p></li> <li><p>encoding: The data encoding. See <a href="/UserGuide/V0.9.x/2-Concept/3-Encoding.html">Chapter 2-3</a>.</p></li> <li><p>compression: The data compression. Now supports <code>UNCOMPRESSED</code> and <code>SNAPPY</code>.</p></li> <li><p>props: Properties for special data types.Such as <code>max_point_number</code> for <code>FLOAT</code> and <code>DOUBLE</code>, <code>max_string_length</code> for |
| <code>TEXT</code>. Use as string pairs into a map such as ("max_point_number", "3").</p></li></ul> <blockquote><p><strong>Notice:</strong> Although one measurement name can be used in multiple deltaObjects, the properties cannot be changed. I.e. |
| it's not allowed to add one measurement name for multiple times with different type or encoding. |
| Here is a bad example:</p></blockquote> <div class="language- extra-class"><pre><code> // The measurement "sensor_1" is float type |
| addMeasurement(new MeasurementSchema("sensor_1", TSDataType.FLOAT, TSEncoding.RLE)); |
| |
| // This call will throw a WriteProcessException exception |
| addMeasurement(new MeasurementSchema("sensor_1", TSDataType.INT32, TSEncoding.RLE)); |
| </code></pre></div></li> <li><p>Third, insert and write data continually.</p> <p>Use this interface to create a new <code>TSRecord</code>(a timestamp and device pair).</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TSRecord(long timestamp, String deviceId) |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>Then create a <code>DataPoint</code>(a measurement and value pair), and use the addTuple method to add the DataPoint to the correct |
| TsRecord.</p> <p>Use this method to write</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>Finally, call <code>close</code> to finish this writing process.</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="example-for-writing-a-tsfile"><a href="#example-for-writing-a-tsfile" class="header-anchor">#</a> Example for writing a TsFile</h4> <p>You should install TsFile to your local maven repository.</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>You could write a TsFile by constructing <strong>TSRecord</strong> if you have the <strong>non-aligned</strong> (e.g. not all sensors contain values) time series data.</p> <p>A more thorough example can be found at <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">"test.tsfile"</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">"sensor_1"</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">"sensor_2"</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">"sensor_3"</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">"device_1"</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">"sensor_1"</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">"sensor_2"</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">"sensor_3"</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>You could write a TsFile by constructing <strong>RowBatch</strong> if you have the <strong>aligned</strong> time series data.</p> <p>A more thorough example can be found at <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">"test.tsfile"</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"><</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">"sensor_"</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">"device_1"</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"><</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"><</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="interface-for-reading-tsfile"><a href="#interface-for-reading-tsfile" class="header-anchor">#</a> Interface for Reading TsFile</h3> <h4 id="before-the-start"><a href="#before-the-start" class="header-anchor">#</a> Before the Start</h4> <p>The set of time-series data in section "Time-series Data" is used here for a concrete introduction in this section. The set showed in the following table contains one deltaObject named "device_1" with three measurements named "sensor_1", "sensor_2" and "sensor_3". And the measurements has been simplified to do a simple illustration, which contains only 4 time-value pairs each.</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>A set of time-series data</span> <h4 id="definition-of-path"><a href="#definition-of-path" class="header-anchor">#</a> Definition of Path</h4> <p>A path is a dot-separated string which uniquely identifies a time-series in TsFile, e.g., "root.area_1.device_1.sensor_1". |
| The last section "sensor_1" is called "measurementId" while the remaining parts "root.area_1.device_1" is called deviceId. |
| As mentioned above, the same measurement in different devices has the same data type and encoding, and devices are also unique.</p> <p>In read interfaces, The parameter <code>paths</code> indicates the measurements to be selected.</p> <p>Path instance can be easily constructed through the class <code>Path</code>. For example:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>Path p = new Path("device_1.sensor_1"); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>We will pass an ArrayList of paths for final query call to support multiple paths.</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>List<Path> paths = new ArrayList<Path>(); |
| paths.add(new Path("device_1.sensor_1")); |
| paths.add(new Path("device_1.sensor_3")); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><blockquote><p><strong>Notice:</strong> When constructing a Path, the format of the parameter should be a dot-separated string, the last part will |
| be recognized as measurementId while the remaining parts will be recognized as deviceId.</p></blockquote> <h4 id="definition-of-filter"><a href="#definition-of-filter" class="header-anchor">#</a> Definition of Filter</h4> <h5 id="usage-scenario"><a href="#usage-scenario" class="header-anchor">#</a> Usage Scenario</h5> <p>Filter is used in TsFile reading process to select data satisfying one or more given condition(s).</p> <h4 id="iexpression"><a href="#iexpression" class="header-anchor">#</a> IExpression</h4> <p>The <code>IExpression</code> is a filter expression interface and it will be passed to our final query call. |
| We create one or more filter expressions and may use binary filter operators to link them to our final expression.</p> <ul><li><p><strong>Create a Filter Expression</strong></p> <p>There are two types of filters.</p> <ul><li><p>TimeFilter: A filter for <code>time</code> in time-series data.</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>Use the following relationships to get a <code>TimeFilter</code> object (value is a long int variable). |
| <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: A filter for <code>value</code> in time-series data.</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>The usage of <code>ValueFilter</code> is the same as using <code>TimeFilter</code>, just to make sure that the type of the value |
| equal to the measurement's(defined in the path).</p></li></ul></li> <li><p><strong>Binary Filter Operators</strong></p> <p>Binary filter operators can be used to link two single expressions.</p> <ul><li>BinaryExpression.and(Expression, Expression): Choose the value satisfy for both expressions.</li> <li>BinaryExpression.or(Expression, Expression): Choose the value satisfy for at least one expression.</li></ul></li></ul> <h5 id="filter-expression-examples"><a href="#filter-expression-examples" class="header-anchor">#</a> Filter Expression Examples</h5> <ul><li><p><strong>TimeFilterExpression Examples</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 <= 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 < 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 >= 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 <= series time < 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 >= 15 or series time < 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="read-interface"><a href="#read-interface" class="header-anchor">#</a> Read Interface</h4> <p>First, we open the TsFile and get a <code>ReadOnlyTsFile</code> instance from a file path string <code>path</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>Next, we prepare the path array and query expression, then get final <code>QueryExpression</code> object by this interface:</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>The ReadOnlyTsFile class has two <code>query</code> method to perform a query.</p> <ul><li><p><strong>Method 1</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p><strong>Method 2</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression, long partitionStartOffset, long partitionEndOffset) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>This method is designed for advanced applications such as the TsFile-Spark Connector.</p> <ul><li><p><strong>params</strong> : For method 2, two additional parameters are added to support partial query:</p> <ul><li><code>partitionStartOffset</code>: start offset for a TsFile</li> <li><code>partitionEndOffset</code>: end offset for a TsFile</li></ul> <blockquote><p><strong>What is Partial Query ?</strong></p> <p>In some distributed file systems(e.g. HDFS), a file is split into severval parts which are called "Blocks" and stored in different nodes. Executing a query paralleled in each nodes involved makes better efficiency. Thus Partial Query is needed. Paritial Query only selects the results stored in the part split by <code>QueryConstant.PARTITION_START_OFFSET</code> and <code>QueryConstant.PARTITION_END_OFFSET</code> for a TsFile.</p></blockquote></li></ul></li></ul> <h3 id="querydataset-interface"><a href="#querydataset-interface" class="header-anchor">#</a> QueryDataset Interface</h3> <p>The query performed above will return a <code>QueryDataset</code> object.</p> <p>Here's the useful interfaces for user.</p> <ul><li><p><code>bool hasNext();</code></p> <p>Return true if this dataset still has elements.</p></li> <li><p><code>List<Path> getPaths()</code></p> <p>Get the paths in this data set.</p></li> <li><p><code>List<TSDataType> getDataTypes();</code></p> <p>Get the data types. The class TSDataType is an enum class, the value will be one of the following:</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>Get the next record.</p> <p>The class <code>RowRecord</code> consists of a <code>long</code> timestamp and a <code>List<Field></code> for data in different sensors, |
| we can use two getter methods to get them.</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>long getTimestamp(); |
| List<Field> 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>To get data from one Field, use these methods:</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="example-for-reading-an-existing-tsfile"><a href="#example-for-reading-an-existing-tsfile" class="header-anchor">#</a> Example for reading an existing TsFile</h4> <p>You should install TsFile to your local maven repository.</p> <p>A more thorough example with query statement can be found at |
| <code>/tsfile/example/src/main/java/org/apache/iotdb/tsfile/TsFileRead.java</code></p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">package</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>io<span class="token punctuation">.</span></span><span class="token class-name">IOException</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>util<span class="token punctuation">.</span></span><span class="token class-name">ArrayList</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>common<span class="token punctuation">.</span></span><span class="token class-name">Path</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">IExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">QueryExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">BinaryExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">GlobalTimeExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">SingleSeriesExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">TimeFilter</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">ValueFilter</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>query<span class="token punctuation">.</span>dataset<span class="token punctuation">.</span></span><span class="token class-name">QueryDataSet</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">/** |
| * The class is to show how to read TsFile file named "test.tsfile". |
| * The TsFile file "test.tsfile" is generated from class TsFileWrite. |
| * Run TsFileWrite to generate the test.tsfile first |
| */</span> |
| <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileRead</span> <span class="token punctuation">{</span> |
| <span class="token keyword">private</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">queryAndPrint</span><span class="token punctuation">(</span><span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">Path</span><span class="token punctuation">></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">"------------"</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| |
| <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">main</span><span class="token punctuation">(</span><span class="token class-name">String</span><span class="token punctuation">[</span><span class="token punctuation">]</span> args<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> <span class="token punctuation">{</span> |
| |
| <span class="token comment">// file path</span> |
| <span class="token class-name">String</span> path <span class="token operator">=</span> <span class="token string">"test.tsfile"</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// create reader and get the readTsFile interface</span> |
| <span class="token class-name">TsFileSequenceReader</span> reader <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">ReadOnlyTsFile</span> readTsFile <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">(</span>reader<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token comment">// use these paths(all sensors) for all the queries</span> |
| <span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">Path</span><span class="token punctuation">></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"><</span><span class="token punctuation">></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">"device_1.sensor_1"</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">"device_1.sensor_2"</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">"device_1.sensor_3"</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// no query statement</span> |
| <span class="token function">queryAndPrint</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> readTsFile<span class="token punctuation">,</span> <span class="token keyword">null</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">//close the reader when you left</span> |
| reader<span class="token punctuation">.</span><span class="token function">close</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br></div></div><h2 id="change-tsfile-config"><a href="#change-tsfile-config" class="header-anchor">#</a> Change TsFile Config</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="bloom-filter"><a href="#bloom-filter" class="header-anchor">#</a> Bloom filter</h2> <p>Bloom filter checks whether a given time series is in the tsfile before loading metadata. This can improve the performance of loading metadata and skip the tsfile that doesn't contain specified time series. |
| If you want to learn more about its mechanism, you can refer to: <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="configuration"><a href="#configuration" class="header-anchor">#</a> configuration</h4> <p>you can control the false positive rate of bloom filter by changing the bloomFilterErrorRate in TSFileConfig</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 |
| bloomFilterErrorRate=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="/UserGuide/V0.9.x/4-Client/4-Programming - Other Languages.html" class="prev"> |
| Other Languages |
| </a></span> <span class="next"><a href="/UserGuide/V0.9.x/5-Operation Manual/1-DDL Data Definition Language.html"> |
| DDL (Data Definition Language) |
| </a> |
| → |
| </span></p></div> <p style="text-align: center;">Copyright © 2021 The Apache Software Foundation.<br> |
| Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p> <p style="text-align: center; margin-top: 10px; color: #444"> |
| Contact us: Join QQ Group 659990460 | Add friend <i>tietouqiao</i> and be invited to Wechat Group<br> |
| see <a href="https://github.com/apache/iotdb/issues/1995">Join the community</a> for more</p></main></div><div class="global-ui"></div></div> |
| <script src="/assets/js/app.35ba4ac3.js" defer></script><script src="/assets/js/3.96a076a8.js" defer></script><script src="/assets/js/4.a65360c5.js" defer></script><script src="/assets/js/311.85a79804.js" defer></script> |
| </body> |
| </html> |