| <!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.de170ea0.css" as="style"><link rel="preload" href="/assets/js/app.1ae7b898.js" as="script"><link rel="preload" href="/assets/js/3.7fccac46.js" as="script"><link rel="preload" href="/assets/js/61.0cd28e4b.js" as="script"><link rel="prefetch" href="/assets/js/10.61872ae5.js"><link rel="prefetch" href="/assets/js/100.ccd01670.js"><link rel="prefetch" href="/assets/js/101.85ee6ba2.js"><link rel="prefetch" href="/assets/js/102.d3c03386.js"><link rel="prefetch" href="/assets/js/103.4c142690.js"><link rel="prefetch" href="/assets/js/104.f049af68.js"><link rel="prefetch" href="/assets/js/105.6cce80f4.js"><link rel="prefetch" href="/assets/js/106.f0d7e48f.js"><link rel="prefetch" href="/assets/js/107.5232a7c3.js"><link rel="prefetch" href="/assets/js/108.ccb521e0.js"><link rel="prefetch" href="/assets/js/109.dbade44d.js"><link rel="prefetch" href="/assets/js/11.a080efae.js"><link rel="prefetch" href="/assets/js/110.83102fe7.js"><link rel="prefetch" href="/assets/js/111.1c6d076a.js"><link rel="prefetch" href="/assets/js/112.c946f3a1.js"><link rel="prefetch" href="/assets/js/113.4b4bb4be.js"><link rel="prefetch" href="/assets/js/114.4f30314e.js"><link rel="prefetch" href="/assets/js/115.8a95a442.js"><link rel="prefetch" href="/assets/js/116.870509a9.js"><link rel="prefetch" href="/assets/js/117.98d451fd.js"><link rel="prefetch" href="/assets/js/118.10e3f62a.js"><link rel="prefetch" href="/assets/js/119.994db15b.js"><link rel="prefetch" href="/assets/js/12.4c48405a.js"><link rel="prefetch" href="/assets/js/120.33942142.js"><link rel="prefetch" href="/assets/js/121.65594c37.js"><link rel="prefetch" href="/assets/js/122.1de5d33f.js"><link rel="prefetch" href="/assets/js/123.89b861dc.js"><link rel="prefetch" href="/assets/js/124.1bd6f579.js"><link rel="prefetch" href="/assets/js/125.a91a1451.js"><link rel="prefetch" href="/assets/js/126.3200ae0c.js"><link rel="prefetch" href="/assets/js/127.42ccf1b1.js"><link rel="prefetch" href="/assets/js/128.bf1e94f3.js"><link rel="prefetch" href="/assets/js/129.4479fadb.js"><link rel="prefetch" href="/assets/js/13.16ded47d.js"><link rel="prefetch" href="/assets/js/130.b4c26cb8.js"><link rel="prefetch" href="/assets/js/131.c200396e.js"><link rel="prefetch" href="/assets/js/132.1b447c67.js"><link rel="prefetch" href="/assets/js/133.25bc611b.js"><link rel="prefetch" href="/assets/js/134.7f44a201.js"><link rel="prefetch" href="/assets/js/135.5e1448f1.js"><link rel="prefetch" href="/assets/js/136.5cf2f188.js"><link rel="prefetch" href="/assets/js/137.a0b9469d.js"><link rel="prefetch" href="/assets/js/138.ed2b75cf.js"><link rel="prefetch" href="/assets/js/139.a4687aa3.js"><link rel="prefetch" href="/assets/js/14.0a6b9010.js"><link rel="prefetch" href="/assets/js/140.20fd3fd9.js"><link rel="prefetch" href="/assets/js/141.6400b654.js"><link rel="prefetch" href="/assets/js/142.7796ad1d.js"><link rel="prefetch" href="/assets/js/143.fbdc020f.js"><link rel="prefetch" href="/assets/js/144.dd116708.js"><link rel="prefetch" href="/assets/js/145.1fd8234c.js"><link rel="prefetch" href="/assets/js/146.423d589a.js"><link rel="prefetch" href="/assets/js/147.2f2b8911.js"><link rel="prefetch" href="/assets/js/148.6417842d.js"><link rel="prefetch" href="/assets/js/149.68309cce.js"><link rel="prefetch" href="/assets/js/15.843fe861.js"><link rel="prefetch" href="/assets/js/150.3d11dfe3.js"><link rel="prefetch" href="/assets/js/151.ecb6454a.js"><link rel="prefetch" href="/assets/js/152.f5c881dc.js"><link rel="prefetch" href="/assets/js/153.f37b789d.js"><link rel="prefetch" href="/assets/js/154.5930e226.js"><link rel="prefetch" href="/assets/js/155.d1c42f9d.js"><link rel="prefetch" href="/assets/js/156.1afe0f6d.js"><link rel="prefetch" href="/assets/js/157.d471984b.js"><link rel="prefetch" href="/assets/js/158.60eb71c5.js"><link rel="prefetch" href="/assets/js/159.5dcc300f.js"><link rel="prefetch" href="/assets/js/16.17c1f643.js"><link rel="prefetch" href="/assets/js/160.40823295.js"><link rel="prefetch" href="/assets/js/161.67bfe550.js"><link rel="prefetch" href="/assets/js/162.83d56808.js"><link rel="prefetch" href="/assets/js/163.c0657053.js"><link rel="prefetch" href="/assets/js/164.fc84bb91.js"><link rel="prefetch" href="/assets/js/165.8d2330ed.js"><link rel="prefetch" href="/assets/js/166.a5f56f78.js"><link rel="prefetch" href="/assets/js/167.d3aafbe7.js"><link rel="prefetch" href="/assets/js/168.7cdda9e9.js"><link rel="prefetch" href="/assets/js/169.7f827c0b.js"><link rel="prefetch" href="/assets/js/17.eb141f9f.js"><link rel="prefetch" href="/assets/js/170.2f0a86ff.js"><link rel="prefetch" href="/assets/js/171.ba1d2df7.js"><link rel="prefetch" href="/assets/js/172.8a7cd300.js"><link rel="prefetch" href="/assets/js/173.22cae56e.js"><link rel="prefetch" href="/assets/js/174.14ce1f9d.js"><link rel="prefetch" href="/assets/js/175.5569528b.js"><link rel="prefetch" href="/assets/js/176.58113bca.js"><link rel="prefetch" href="/assets/js/177.e3ca589e.js"><link rel="prefetch" href="/assets/js/178.f2b2a763.js"><link rel="prefetch" href="/assets/js/179.04f818ee.js"><link rel="prefetch" href="/assets/js/18.ec2f64fe.js"><link rel="prefetch" href="/assets/js/180.16830f5a.js"><link rel="prefetch" href="/assets/js/181.450bf444.js"><link rel="prefetch" href="/assets/js/182.4b20bd4d.js"><link rel="prefetch" href="/assets/js/183.3c81af68.js"><link rel="prefetch" href="/assets/js/184.d8c296fd.js"><link rel="prefetch" href="/assets/js/185.a9ab0ce1.js"><link rel="prefetch" href="/assets/js/186.0391e093.js"><link rel="prefetch" href="/assets/js/187.3c885be5.js"><link rel="prefetch" href="/assets/js/188.1d66d8b3.js"><link rel="prefetch" href="/assets/js/189.794c3125.js"><link rel="prefetch" href="/assets/js/19.e46591ce.js"><link rel="prefetch" href="/assets/js/190.51b5428b.js"><link rel="prefetch" href="/assets/js/191.4a222e9a.js"><link rel="prefetch" href="/assets/js/192.1f3b6ca8.js"><link rel="prefetch" href="/assets/js/193.54892d42.js"><link rel="prefetch" href="/assets/js/194.8cde1707.js"><link rel="prefetch" href="/assets/js/195.c90f9d72.js"><link rel="prefetch" href="/assets/js/196.e526559b.js"><link rel="prefetch" href="/assets/js/197.838c0fdf.js"><link rel="prefetch" href="/assets/js/198.c51544af.js"><link rel="prefetch" href="/assets/js/199.7f8784c9.js"><link rel="prefetch" href="/assets/js/20.335cca54.js"><link rel="prefetch" href="/assets/js/200.364844ec.js"><link rel="prefetch" href="/assets/js/201.bcb4e7b8.js"><link rel="prefetch" href="/assets/js/202.655454f0.js"><link rel="prefetch" href="/assets/js/203.50e3e42d.js"><link rel="prefetch" href="/assets/js/204.57a3d0c6.js"><link rel="prefetch" href="/assets/js/205.c82336fc.js"><link rel="prefetch" href="/assets/js/206.8ca8c539.js"><link rel="prefetch" href="/assets/js/207.e9e67105.js"><link rel="prefetch" href="/assets/js/208.36a13519.js"><link rel="prefetch" href="/assets/js/209.e8ae8786.js"><link rel="prefetch" href="/assets/js/21.4b7d96ef.js"><link rel="prefetch" href="/assets/js/210.a45cff9c.js"><link rel="prefetch" href="/assets/js/211.869f7acd.js"><link rel="prefetch" href="/assets/js/212.3ad13393.js"><link rel="prefetch" href="/assets/js/213.10692b4a.js"><link rel="prefetch" href="/assets/js/214.b4b8e38d.js"><link rel="prefetch" href="/assets/js/215.3cb9152d.js"><link rel="prefetch" href="/assets/js/216.162f4819.js"><link rel="prefetch" href="/assets/js/217.1888f605.js"><link rel="prefetch" href="/assets/js/218.34ca1da3.js"><link rel="prefetch" href="/assets/js/219.c977b0ff.js"><link rel="prefetch" href="/assets/js/22.0d791f94.js"><link rel="prefetch" href="/assets/js/220.a3799ade.js"><link rel="prefetch" href="/assets/js/221.4b59b647.js"><link rel="prefetch" href="/assets/js/222.f5be0693.js"><link rel="prefetch" href="/assets/js/223.da9dd47f.js"><link rel="prefetch" href="/assets/js/224.3248077b.js"><link rel="prefetch" href="/assets/js/225.58563fe3.js"><link rel="prefetch" href="/assets/js/226.0df1d270.js"><link rel="prefetch" href="/assets/js/227.4047aeb2.js"><link rel="prefetch" href="/assets/js/228.78ccc151.js"><link rel="prefetch" href="/assets/js/229.121e74ac.js"><link rel="prefetch" href="/assets/js/23.32010fe2.js"><link rel="prefetch" href="/assets/js/230.3ce7c6b1.js"><link rel="prefetch" href="/assets/js/231.be918e46.js"><link rel="prefetch" href="/assets/js/232.4479ef71.js"><link rel="prefetch" href="/assets/js/233.6839ffed.js"><link rel="prefetch" href="/assets/js/234.6060628d.js"><link rel="prefetch" href="/assets/js/235.0d0fdcf0.js"><link rel="prefetch" href="/assets/js/236.06b2af54.js"><link rel="prefetch" href="/assets/js/237.96bb66f5.js"><link rel="prefetch" href="/assets/js/238.c575cde5.js"><link rel="prefetch" href="/assets/js/239.8fe2b593.js"><link rel="prefetch" href="/assets/js/24.4a86b358.js"><link rel="prefetch" href="/assets/js/240.5f271572.js"><link rel="prefetch" href="/assets/js/241.6777e07d.js"><link rel="prefetch" href="/assets/js/242.6776aa6c.js"><link rel="prefetch" href="/assets/js/243.ff959449.js"><link rel="prefetch" href="/assets/js/244.56a3f5a4.js"><link rel="prefetch" href="/assets/js/245.cfb99367.js"><link rel="prefetch" href="/assets/js/246.53c27f3a.js"><link rel="prefetch" href="/assets/js/247.6d573c21.js"><link rel="prefetch" href="/assets/js/248.7f6bbe5c.js"><link rel="prefetch" href="/assets/js/249.17d88a94.js"><link rel="prefetch" href="/assets/js/25.f8281c6e.js"><link rel="prefetch" href="/assets/js/250.706296cb.js"><link rel="prefetch" href="/assets/js/251.2ea839a5.js"><link rel="prefetch" href="/assets/js/252.a0ce92f2.js"><link rel="prefetch" href="/assets/js/253.be879ea2.js"><link rel="prefetch" href="/assets/js/254.ccca2af8.js"><link rel="prefetch" href="/assets/js/255.5d3448b3.js"><link rel="prefetch" href="/assets/js/256.b8230e7a.js"><link rel="prefetch" href="/assets/js/257.6ddc345d.js"><link rel="prefetch" href="/assets/js/258.f29eaa2b.js"><link rel="prefetch" href="/assets/js/259.347e3fb8.js"><link rel="prefetch" href="/assets/js/26.bf9a8936.js"><link rel="prefetch" href="/assets/js/260.aea1f353.js"><link rel="prefetch" href="/assets/js/261.846ed73d.js"><link rel="prefetch" href="/assets/js/262.e5411f18.js"><link rel="prefetch" href="/assets/js/263.df808118.js"><link rel="prefetch" href="/assets/js/264.42e35207.js"><link rel="prefetch" href="/assets/js/265.89fb2f0f.js"><link rel="prefetch" href="/assets/js/266.6b51a254.js"><link rel="prefetch" href="/assets/js/267.2714890d.js"><link rel="prefetch" href="/assets/js/268.e868518e.js"><link rel="prefetch" href="/assets/js/269.cb13f895.js"><link rel="prefetch" href="/assets/js/27.81294b57.js"><link rel="prefetch" href="/assets/js/270.9a53dade.js"><link rel="prefetch" href="/assets/js/271.0ac6e618.js"><link rel="prefetch" href="/assets/js/272.aea7c17d.js"><link rel="prefetch" href="/assets/js/273.34ac7ad6.js"><link rel="prefetch" href="/assets/js/274.2d7aab6a.js"><link rel="prefetch" href="/assets/js/275.207fd433.js"><link rel="prefetch" href="/assets/js/276.c6cbca37.js"><link rel="prefetch" href="/assets/js/277.2ff81dcc.js"><link rel="prefetch" href="/assets/js/278.6fb7650e.js"><link rel="prefetch" href="/assets/js/279.fad09d3b.js"><link rel="prefetch" href="/assets/js/28.de5fbffd.js"><link rel="prefetch" href="/assets/js/280.84e54e25.js"><link rel="prefetch" href="/assets/js/281.72024c2c.js"><link rel="prefetch" href="/assets/js/282.f93c4ae9.js"><link rel="prefetch" href="/assets/js/283.6a0f0cef.js"><link rel="prefetch" href="/assets/js/284.fd62ae39.js"><link rel="prefetch" href="/assets/js/285.178c0c5e.js"><link rel="prefetch" href="/assets/js/286.c2407c7e.js"><link rel="prefetch" href="/assets/js/287.ae4b9233.js"><link rel="prefetch" href="/assets/js/288.e65da740.js"><link rel="prefetch" href="/assets/js/289.3f4160b1.js"><link rel="prefetch" href="/assets/js/29.35566993.js"><link rel="prefetch" href="/assets/js/290.ae453250.js"><link rel="prefetch" href="/assets/js/291.d5fd3e38.js"><link rel="prefetch" href="/assets/js/292.5bbf449e.js"><link rel="prefetch" href="/assets/js/293.fc52bd99.js"><link rel="prefetch" href="/assets/js/294.c8c56807.js"><link rel="prefetch" href="/assets/js/295.f843cd03.js"><link rel="prefetch" href="/assets/js/296.8069d1d3.js"><link rel="prefetch" href="/assets/js/297.248e4bba.js"><link rel="prefetch" href="/assets/js/298.2e1d23b2.js"><link rel="prefetch" href="/assets/js/299.1ad649bf.js"><link rel="prefetch" href="/assets/js/30.2a46f39a.js"><link rel="prefetch" href="/assets/js/300.9a352ae0.js"><link rel="prefetch" href="/assets/js/301.d20da5d9.js"><link rel="prefetch" href="/assets/js/302.1aa84294.js"><link rel="prefetch" href="/assets/js/303.3bb2b6ee.js"><link rel="prefetch" href="/assets/js/304.f9ab3b20.js"><link rel="prefetch" href="/assets/js/305.9711f701.js"><link rel="prefetch" href="/assets/js/306.4b75ab6b.js"><link rel="prefetch" href="/assets/js/307.ccef7652.js"><link rel="prefetch" href="/assets/js/308.8c77da7a.js"><link rel="prefetch" href="/assets/js/309.ef2d1bb8.js"><link rel="prefetch" href="/assets/js/31.fab44020.js"><link rel="prefetch" href="/assets/js/310.e73e8921.js"><link rel="prefetch" href="/assets/js/311.b0fc6ccf.js"><link rel="prefetch" href="/assets/js/312.b5acd9c9.js"><link rel="prefetch" href="/assets/js/313.2a4ee756.js"><link rel="prefetch" href="/assets/js/314.48f0c6f5.js"><link rel="prefetch" href="/assets/js/315.54876274.js"><link rel="prefetch" href="/assets/js/316.7a940c70.js"><link rel="prefetch" href="/assets/js/317.af86eb3d.js"><link rel="prefetch" href="/assets/js/318.0b811895.js"><link rel="prefetch" href="/assets/js/319.a0368c61.js"><link rel="prefetch" href="/assets/js/32.8f287f6a.js"><link rel="prefetch" href="/assets/js/320.6d82bde1.js"><link rel="prefetch" href="/assets/js/321.431bc658.js"><link rel="prefetch" href="/assets/js/322.6d50b481.js"><link rel="prefetch" href="/assets/js/323.f9fdcc96.js"><link rel="prefetch" href="/assets/js/324.8339e7bb.js"><link rel="prefetch" href="/assets/js/325.552ed8a3.js"><link rel="prefetch" href="/assets/js/326.41802605.js"><link rel="prefetch" href="/assets/js/327.a976d224.js"><link rel="prefetch" href="/assets/js/328.998118f5.js"><link rel="prefetch" href="/assets/js/329.6ccee7e4.js"><link rel="prefetch" href="/assets/js/33.df280333.js"><link rel="prefetch" href="/assets/js/330.32d88cbc.js"><link rel="prefetch" href="/assets/js/331.70ce74a3.js"><link rel="prefetch" href="/assets/js/332.16f1f64e.js"><link rel="prefetch" href="/assets/js/333.515c1a8b.js"><link rel="prefetch" href="/assets/js/334.8ee6a78b.js"><link rel="prefetch" href="/assets/js/335.00b411c2.js"><link rel="prefetch" href="/assets/js/336.957d7c7d.js"><link rel="prefetch" href="/assets/js/337.bba03769.js"><link rel="prefetch" href="/assets/js/338.7280c740.js"><link rel="prefetch" href="/assets/js/339.fcba26e0.js"><link rel="prefetch" href="/assets/js/34.7b065e16.js"><link rel="prefetch" href="/assets/js/340.44289972.js"><link rel="prefetch" href="/assets/js/341.c167fe5c.js"><link rel="prefetch" href="/assets/js/342.bce3a3d0.js"><link rel="prefetch" href="/assets/js/343.9e69b442.js"><link rel="prefetch" href="/assets/js/344.82ea42e1.js"><link rel="prefetch" href="/assets/js/345.24bf0bfb.js"><link rel="prefetch" href="/assets/js/346.cc941817.js"><link rel="prefetch" href="/assets/js/347.bd244972.js"><link rel="prefetch" href="/assets/js/348.82996443.js"><link rel="prefetch" href="/assets/js/349.5dd95d62.js"><link rel="prefetch" href="/assets/js/35.c44fc590.js"><link rel="prefetch" href="/assets/js/350.255ba948.js"><link rel="prefetch" href="/assets/js/351.f8c19547.js"><link rel="prefetch" href="/assets/js/352.be232203.js"><link rel="prefetch" href="/assets/js/353.984e1c68.js"><link rel="prefetch" href="/assets/js/354.e129ed15.js"><link rel="prefetch" href="/assets/js/355.1d183a89.js"><link rel="prefetch" href="/assets/js/356.db348497.js"><link rel="prefetch" href="/assets/js/357.167d933e.js"><link rel="prefetch" href="/assets/js/358.079e02fa.js"><link rel="prefetch" href="/assets/js/359.8b6ff017.js"><link rel="prefetch" href="/assets/js/36.4e36f97e.js"><link rel="prefetch" href="/assets/js/360.0279df5a.js"><link rel="prefetch" href="/assets/js/361.5e6ae0f5.js"><link rel="prefetch" href="/assets/js/362.f9461ab0.js"><link rel="prefetch" href="/assets/js/363.449b9ad3.js"><link rel="prefetch" href="/assets/js/364.b8789d67.js"><link rel="prefetch" href="/assets/js/365.f9233199.js"><link rel="prefetch" href="/assets/js/366.453f61c5.js"><link rel="prefetch" href="/assets/js/367.310ffa07.js"><link rel="prefetch" href="/assets/js/368.83a9f9db.js"><link rel="prefetch" href="/assets/js/369.5a229075.js"><link rel="prefetch" href="/assets/js/37.3e8bedc9.js"><link rel="prefetch" href="/assets/js/370.22c2d1c3.js"><link rel="prefetch" href="/assets/js/371.b3012b4e.js"><link rel="prefetch" href="/assets/js/372.8cb5149b.js"><link rel="prefetch" href="/assets/js/373.8289a9ed.js"><link rel="prefetch" href="/assets/js/374.69defbee.js"><link rel="prefetch" href="/assets/js/375.5a50cc5e.js"><link rel="prefetch" href="/assets/js/376.2e57f398.js"><link rel="prefetch" href="/assets/js/377.32a05c5c.js"><link rel="prefetch" href="/assets/js/378.ee5a1757.js"><link rel="prefetch" href="/assets/js/379.3c43aa73.js"><link rel="prefetch" href="/assets/js/38.c6f83038.js"><link rel="prefetch" href="/assets/js/380.8e010e11.js"><link rel="prefetch" href="/assets/js/381.1e6af093.js"><link rel="prefetch" href="/assets/js/382.58fb80bd.js"><link rel="prefetch" href="/assets/js/383.68371948.js"><link rel="prefetch" href="/assets/js/384.5f02a2a2.js"><link rel="prefetch" href="/assets/js/385.cd45fa05.js"><link rel="prefetch" href="/assets/js/386.c2c14022.js"><link rel="prefetch" href="/assets/js/387.f5643b34.js"><link rel="prefetch" href="/assets/js/388.5ea0f858.js"><link rel="prefetch" href="/assets/js/389.0a7d4eeb.js"><link rel="prefetch" href="/assets/js/39.41707d32.js"><link rel="prefetch" href="/assets/js/390.b69c592a.js"><link rel="prefetch" href="/assets/js/391.b39d0352.js"><link rel="prefetch" href="/assets/js/392.f5329712.js"><link rel="prefetch" href="/assets/js/393.ade90461.js"><link rel="prefetch" href="/assets/js/394.4f4c834d.js"><link rel="prefetch" href="/assets/js/395.b0d60408.js"><link rel="prefetch" href="/assets/js/396.ce440ce2.js"><link rel="prefetch" href="/assets/js/397.a85e8971.js"><link rel="prefetch" href="/assets/js/398.835b3427.js"><link rel="prefetch" href="/assets/js/399.b2928b04.js"><link rel="prefetch" href="/assets/js/4.0a087a6f.js"><link rel="prefetch" href="/assets/js/40.6f6fb483.js"><link rel="prefetch" href="/assets/js/400.158a9b14.js"><link rel="prefetch" href="/assets/js/401.fc28d0ee.js"><link rel="prefetch" href="/assets/js/402.0394f1e5.js"><link rel="prefetch" href="/assets/js/403.a47d20c7.js"><link rel="prefetch" href="/assets/js/404.2f7eab18.js"><link rel="prefetch" href="/assets/js/405.14c5e39a.js"><link rel="prefetch" href="/assets/js/406.d4783d33.js"><link rel="prefetch" href="/assets/js/407.d01f8e85.js"><link rel="prefetch" href="/assets/js/408.10ff07b8.js"><link rel="prefetch" href="/assets/js/409.72dca9ed.js"><link rel="prefetch" href="/assets/js/41.f1dd1831.js"><link rel="prefetch" href="/assets/js/410.d65b9c35.js"><link rel="prefetch" href="/assets/js/411.2fdd41ad.js"><link rel="prefetch" href="/assets/js/412.2bb8fc21.js"><link rel="prefetch" href="/assets/js/413.c5f67a0e.js"><link rel="prefetch" href="/assets/js/414.6d62668f.js"><link rel="prefetch" href="/assets/js/415.e150b725.js"><link rel="prefetch" href="/assets/js/416.cecadb25.js"><link rel="prefetch" href="/assets/js/417.eb9502e3.js"><link rel="prefetch" href="/assets/js/418.863de185.js"><link rel="prefetch" href="/assets/js/419.7ae4c0bf.js"><link rel="prefetch" href="/assets/js/42.2678c675.js"><link rel="prefetch" href="/assets/js/420.1f9970eb.js"><link rel="prefetch" href="/assets/js/421.025b9307.js"><link rel="prefetch" href="/assets/js/422.e75cb867.js"><link rel="prefetch" href="/assets/js/423.5747aace.js"><link rel="prefetch" href="/assets/js/424.424c4c10.js"><link rel="prefetch" href="/assets/js/425.e846814b.js"><link rel="prefetch" href="/assets/js/426.029cbb4f.js"><link rel="prefetch" href="/assets/js/427.4b89230c.js"><link rel="prefetch" href="/assets/js/428.c6d8dfdd.js"><link rel="prefetch" href="/assets/js/429.d4e9607f.js"><link rel="prefetch" href="/assets/js/43.2c7e46b2.js"><link rel="prefetch" href="/assets/js/430.85f87ae0.js"><link rel="prefetch" href="/assets/js/431.70c87177.js"><link rel="prefetch" href="/assets/js/432.6b686392.js"><link rel="prefetch" href="/assets/js/433.4a525adc.js"><link rel="prefetch" href="/assets/js/434.675b363c.js"><link rel="prefetch" href="/assets/js/435.35ab20f4.js"><link rel="prefetch" href="/assets/js/436.b6a1893f.js"><link rel="prefetch" href="/assets/js/437.e1454b20.js"><link rel="prefetch" href="/assets/js/438.4bd50e40.js"><link rel="prefetch" href="/assets/js/439.f511e28d.js"><link rel="prefetch" href="/assets/js/44.77553fa9.js"><link rel="prefetch" href="/assets/js/440.aed0fb98.js"><link rel="prefetch" href="/assets/js/441.ecfdc8e8.js"><link rel="prefetch" href="/assets/js/442.b174c809.js"><link rel="prefetch" href="/assets/js/443.4fd90d80.js"><link rel="prefetch" href="/assets/js/444.a19ebef0.js"><link rel="prefetch" href="/assets/js/445.e273d0bd.js"><link rel="prefetch" href="/assets/js/446.5f9c666d.js"><link rel="prefetch" href="/assets/js/447.4f4d651b.js"><link rel="prefetch" href="/assets/js/448.de26848c.js"><link rel="prefetch" href="/assets/js/449.dc9b208a.js"><link rel="prefetch" href="/assets/js/45.20484792.js"><link rel="prefetch" href="/assets/js/450.af0c9b68.js"><link rel="prefetch" href="/assets/js/451.eed1f199.js"><link rel="prefetch" href="/assets/js/452.b070d4d9.js"><link rel="prefetch" href="/assets/js/453.8d8b6f8a.js"><link rel="prefetch" href="/assets/js/454.8fd61ba7.js"><link rel="prefetch" href="/assets/js/455.2b1f9ca2.js"><link rel="prefetch" href="/assets/js/456.13c46cc3.js"><link rel="prefetch" href="/assets/js/457.8eb48814.js"><link rel="prefetch" href="/assets/js/458.ba659f09.js"><link rel="prefetch" href="/assets/js/459.a98c9b0e.js"><link rel="prefetch" href="/assets/js/46.f1030c38.js"><link rel="prefetch" href="/assets/js/460.3414f843.js"><link rel="prefetch" href="/assets/js/461.b4cbca13.js"><link rel="prefetch" href="/assets/js/462.5dc9cf99.js"><link rel="prefetch" href="/assets/js/463.bc0e209e.js"><link rel="prefetch" href="/assets/js/464.4ece9d39.js"><link rel="prefetch" href="/assets/js/465.c6c28382.js"><link rel="prefetch" href="/assets/js/466.0d5ae37d.js"><link rel="prefetch" href="/assets/js/467.98db03cd.js"><link rel="prefetch" href="/assets/js/468.aadf2b09.js"><link rel="prefetch" href="/assets/js/469.43e31b7c.js"><link rel="prefetch" href="/assets/js/47.e050b78a.js"><link rel="prefetch" href="/assets/js/470.198fcc01.js"><link rel="prefetch" href="/assets/js/471.8eae5192.js"><link rel="prefetch" href="/assets/js/472.fcf745b9.js"><link rel="prefetch" href="/assets/js/473.fc5ce13f.js"><link rel="prefetch" href="/assets/js/474.4b68cd42.js"><link rel="prefetch" href="/assets/js/475.76fdbd6f.js"><link rel="prefetch" href="/assets/js/476.55c57586.js"><link rel="prefetch" href="/assets/js/477.da351c6e.js"><link rel="prefetch" href="/assets/js/478.5a89a63c.js"><link rel="prefetch" href="/assets/js/479.9f4d8349.js"><link rel="prefetch" href="/assets/js/48.81c5dfc1.js"><link rel="prefetch" href="/assets/js/480.486e0580.js"><link rel="prefetch" href="/assets/js/481.69a27ffc.js"><link rel="prefetch" href="/assets/js/482.30b4b56f.js"><link rel="prefetch" href="/assets/js/483.79b54b49.js"><link rel="prefetch" href="/assets/js/484.5573be37.js"><link rel="prefetch" href="/assets/js/485.abfada55.js"><link rel="prefetch" href="/assets/js/486.b22be7dc.js"><link rel="prefetch" href="/assets/js/487.b10e41f3.js"><link rel="prefetch" href="/assets/js/488.eb59d368.js"><link rel="prefetch" href="/assets/js/489.e64f1948.js"><link rel="prefetch" href="/assets/js/49.4b0fe119.js"><link rel="prefetch" href="/assets/js/490.f61daaa5.js"><link rel="prefetch" href="/assets/js/491.0745c1b3.js"><link rel="prefetch" href="/assets/js/492.c4f5b197.js"><link rel="prefetch" href="/assets/js/493.481ed0f6.js"><link rel="prefetch" href="/assets/js/494.6d1e3805.js"><link rel="prefetch" href="/assets/js/495.02a2787d.js"><link rel="prefetch" href="/assets/js/496.611bbba0.js"><link rel="prefetch" href="/assets/js/497.d28281f3.js"><link rel="prefetch" href="/assets/js/498.70234a30.js"><link rel="prefetch" href="/assets/js/499.794c39ee.js"><link rel="prefetch" href="/assets/js/5.7d9ca62c.js"><link rel="prefetch" href="/assets/js/50.988ad286.js"><link rel="prefetch" href="/assets/js/500.efef9d42.js"><link rel="prefetch" href="/assets/js/501.4867e3e3.js"><link rel="prefetch" href="/assets/js/502.7f79c356.js"><link rel="prefetch" href="/assets/js/503.e916e52f.js"><link rel="prefetch" href="/assets/js/504.5286581c.js"><link rel="prefetch" href="/assets/js/505.53506bd6.js"><link rel="prefetch" href="/assets/js/506.4ac75622.js"><link rel="prefetch" href="/assets/js/507.0ca21999.js"><link rel="prefetch" href="/assets/js/508.627c6566.js"><link rel="prefetch" href="/assets/js/509.a1d8365b.js"><link rel="prefetch" href="/assets/js/51.268a7400.js"><link rel="prefetch" href="/assets/js/510.3086fa45.js"><link rel="prefetch" href="/assets/js/511.61f09ae7.js"><link rel="prefetch" href="/assets/js/512.0f98ed93.js"><link rel="prefetch" href="/assets/js/513.f538c037.js"><link rel="prefetch" href="/assets/js/514.d91bce0b.js"><link rel="prefetch" href="/assets/js/515.03671171.js"><link rel="prefetch" href="/assets/js/516.611f46a9.js"><link rel="prefetch" href="/assets/js/517.52c9fc90.js"><link rel="prefetch" href="/assets/js/518.f9eaebf7.js"><link rel="prefetch" href="/assets/js/519.aac9496e.js"><link rel="prefetch" href="/assets/js/52.8916cef3.js"><link rel="prefetch" href="/assets/js/520.db4ed534.js"><link rel="prefetch" href="/assets/js/521.9a928fc6.js"><link rel="prefetch" href="/assets/js/522.cdc152b5.js"><link rel="prefetch" href="/assets/js/523.37a0d00f.js"><link rel="prefetch" href="/assets/js/524.272712d4.js"><link rel="prefetch" href="/assets/js/525.2113562b.js"><link rel="prefetch" href="/assets/js/526.69a5cdd4.js"><link rel="prefetch" href="/assets/js/527.8c6862cf.js"><link rel="prefetch" href="/assets/js/528.ca3d6565.js"><link rel="prefetch" href="/assets/js/529.a2f65578.js"><link rel="prefetch" href="/assets/js/53.6856c4b9.js"><link rel="prefetch" href="/assets/js/530.3927a4af.js"><link rel="prefetch" href="/assets/js/531.35ccf2e6.js"><link rel="prefetch" href="/assets/js/532.49dc6abb.js"><link rel="prefetch" href="/assets/js/533.ab48a245.js"><link rel="prefetch" href="/assets/js/534.1f52e3c2.js"><link rel="prefetch" href="/assets/js/535.447efc41.js"><link rel="prefetch" href="/assets/js/536.63494a53.js"><link rel="prefetch" href="/assets/js/537.4280b437.js"><link rel="prefetch" href="/assets/js/538.87006c0e.js"><link rel="prefetch" href="/assets/js/539.a66188eb.js"><link rel="prefetch" href="/assets/js/54.28efaf2b.js"><link rel="prefetch" href="/assets/js/540.e071e3fd.js"><link rel="prefetch" href="/assets/js/541.c98e4620.js"><link rel="prefetch" href="/assets/js/542.d646e6c9.js"><link rel="prefetch" href="/assets/js/543.0f05dd0b.js"><link rel="prefetch" href="/assets/js/544.8065bccd.js"><link rel="prefetch" href="/assets/js/545.ffeda1d2.js"><link rel="prefetch" href="/assets/js/546.05e68d8b.js"><link rel="prefetch" href="/assets/js/547.4c3cf496.js"><link rel="prefetch" href="/assets/js/548.58b300c1.js"><link rel="prefetch" href="/assets/js/549.0eb11a63.js"><link rel="prefetch" href="/assets/js/55.ba5908aa.js"><link rel="prefetch" href="/assets/js/550.0a617178.js"><link rel="prefetch" href="/assets/js/551.ead5fba4.js"><link rel="prefetch" href="/assets/js/552.cc9be17b.js"><link rel="prefetch" href="/assets/js/553.87135a35.js"><link rel="prefetch" href="/assets/js/554.dd15d7f6.js"><link rel="prefetch" href="/assets/js/555.ba8610fd.js"><link rel="prefetch" href="/assets/js/556.39e37044.js"><link rel="prefetch" href="/assets/js/557.fa3d22e1.js"><link rel="prefetch" href="/assets/js/558.30ca3199.js"><link rel="prefetch" href="/assets/js/559.bd57c016.js"><link rel="prefetch" href="/assets/js/56.33f14ae9.js"><link rel="prefetch" href="/assets/js/560.168df27d.js"><link rel="prefetch" href="/assets/js/561.c4267a17.js"><link rel="prefetch" href="/assets/js/562.b125b4aa.js"><link rel="prefetch" href="/assets/js/563.23976e4a.js"><link rel="prefetch" href="/assets/js/564.4a23da95.js"><link rel="prefetch" href="/assets/js/565.9234c69b.js"><link rel="prefetch" href="/assets/js/566.22e09f16.js"><link rel="prefetch" href="/assets/js/567.e3e7e248.js"><link rel="prefetch" href="/assets/js/568.b4b28292.js"><link rel="prefetch" href="/assets/js/569.5919e729.js"><link rel="prefetch" href="/assets/js/57.aba02739.js"><link rel="prefetch" href="/assets/js/570.31acd0e3.js"><link rel="prefetch" href="/assets/js/571.eaecfff7.js"><link rel="prefetch" href="/assets/js/572.b7498720.js"><link rel="prefetch" href="/assets/js/573.99d478c2.js"><link rel="prefetch" href="/assets/js/574.fac6ada8.js"><link rel="prefetch" href="/assets/js/575.36dcc894.js"><link rel="prefetch" href="/assets/js/576.142bbcae.js"><link rel="prefetch" href="/assets/js/577.35440cdd.js"><link rel="prefetch" href="/assets/js/578.a4ec5564.js"><link rel="prefetch" href="/assets/js/579.8a962642.js"><link rel="prefetch" href="/assets/js/58.b4349589.js"><link rel="prefetch" href="/assets/js/580.eb50d76d.js"><link rel="prefetch" href="/assets/js/581.ad9de195.js"><link rel="prefetch" href="/assets/js/582.94304b9f.js"><link rel="prefetch" href="/assets/js/583.53ac612f.js"><link rel="prefetch" href="/assets/js/584.ca95803d.js"><link rel="prefetch" href="/assets/js/585.0cedfebc.js"><link rel="prefetch" href="/assets/js/586.a12a4f20.js"><link rel="prefetch" href="/assets/js/587.3bf934c5.js"><link rel="prefetch" href="/assets/js/588.00d7d48f.js"><link rel="prefetch" href="/assets/js/589.582aa3ac.js"><link rel="prefetch" href="/assets/js/59.609855d3.js"><link rel="prefetch" href="/assets/js/590.e9e1efcc.js"><link rel="prefetch" href="/assets/js/591.7b9906e0.js"><link rel="prefetch" href="/assets/js/592.bc5c6ff3.js"><link rel="prefetch" href="/assets/js/593.8ec7083f.js"><link rel="prefetch" href="/assets/js/594.0d80d9d3.js"><link rel="prefetch" href="/assets/js/595.b7c34766.js"><link rel="prefetch" href="/assets/js/596.1ec2125e.js"><link rel="prefetch" href="/assets/js/597.e3e9af8a.js"><link rel="prefetch" href="/assets/js/598.e54425ea.js"><link rel="prefetch" href="/assets/js/599.7b0fe718.js"><link rel="prefetch" href="/assets/js/6.d05ff7d1.js"><link rel="prefetch" href="/assets/js/60.6192c5e6.js"><link rel="prefetch" href="/assets/js/600.1a71d92c.js"><link rel="prefetch" href="/assets/js/601.21e70df3.js"><link rel="prefetch" href="/assets/js/602.bd762c11.js"><link rel="prefetch" href="/assets/js/603.9a84db47.js"><link rel="prefetch" href="/assets/js/604.d01a17ec.js"><link rel="prefetch" href="/assets/js/605.c5d9f53c.js"><link rel="prefetch" href="/assets/js/606.2f133fc6.js"><link rel="prefetch" href="/assets/js/607.a6f524da.js"><link rel="prefetch" href="/assets/js/608.e0dc67f2.js"><link rel="prefetch" href="/assets/js/609.894badc8.js"><link rel="prefetch" href="/assets/js/610.f662c71c.js"><link rel="prefetch" href="/assets/js/611.71522435.js"><link rel="prefetch" href="/assets/js/612.2ccdb9af.js"><link rel="prefetch" href="/assets/js/613.e0960a1f.js"><link rel="prefetch" href="/assets/js/614.4336db2e.js"><link rel="prefetch" href="/assets/js/615.fcbdc4d3.js"><link rel="prefetch" href="/assets/js/616.e153f7e9.js"><link rel="prefetch" href="/assets/js/617.a86e03e4.js"><link rel="prefetch" href="/assets/js/618.3037d424.js"><link rel="prefetch" href="/assets/js/619.ec693d5e.js"><link rel="prefetch" href="/assets/js/62.e03f9faa.js"><link rel="prefetch" href="/assets/js/620.32de661b.js"><link rel="prefetch" href="/assets/js/621.71f83ee1.js"><link rel="prefetch" href="/assets/js/622.0ba40f49.js"><link rel="prefetch" href="/assets/js/623.f7e8810a.js"><link rel="prefetch" href="/assets/js/624.fb48bc96.js"><link rel="prefetch" href="/assets/js/625.f5c81290.js"><link rel="prefetch" href="/assets/js/626.cdc053fd.js"><link rel="prefetch" href="/assets/js/627.816f1dd4.js"><link rel="prefetch" href="/assets/js/628.2154115f.js"><link rel="prefetch" href="/assets/js/629.71b5b50a.js"><link rel="prefetch" href="/assets/js/63.9c1b8a84.js"><link rel="prefetch" href="/assets/js/630.3fc1ee2c.js"><link rel="prefetch" href="/assets/js/631.55fbef58.js"><link rel="prefetch" href="/assets/js/632.1b037d0e.js"><link rel="prefetch" href="/assets/js/633.c55cc660.js"><link rel="prefetch" href="/assets/js/634.27e929d0.js"><link rel="prefetch" href="/assets/js/635.08f3630b.js"><link rel="prefetch" href="/assets/js/636.72d193e8.js"><link rel="prefetch" href="/assets/js/637.569bd6a4.js"><link rel="prefetch" href="/assets/js/638.f03e7189.js"><link rel="prefetch" href="/assets/js/639.0ca08e7d.js"><link rel="prefetch" href="/assets/js/64.fb01d06c.js"><link rel="prefetch" href="/assets/js/640.8a6efe46.js"><link rel="prefetch" href="/assets/js/641.477363f3.js"><link rel="prefetch" href="/assets/js/642.c2aabb9f.js"><link rel="prefetch" href="/assets/js/643.fd2ae68f.js"><link rel="prefetch" href="/assets/js/644.3dd321fc.js"><link rel="prefetch" href="/assets/js/65.a5f22217.js"><link rel="prefetch" href="/assets/js/66.4508197d.js"><link rel="prefetch" href="/assets/js/67.8df21fc1.js"><link rel="prefetch" href="/assets/js/68.74ca9240.js"><link rel="prefetch" href="/assets/js/69.72fda89b.js"><link rel="prefetch" href="/assets/js/7.63385f53.js"><link rel="prefetch" href="/assets/js/70.45e288a0.js"><link rel="prefetch" href="/assets/js/71.b0903874.js"><link rel="prefetch" href="/assets/js/72.b96bcdc2.js"><link rel="prefetch" href="/assets/js/73.2da45f8f.js"><link rel="prefetch" href="/assets/js/74.4c8c1379.js"><link rel="prefetch" href="/assets/js/75.5e041d2a.js"><link rel="prefetch" href="/assets/js/76.b3e2338f.js"><link rel="prefetch" href="/assets/js/77.c31105bc.js"><link rel="prefetch" href="/assets/js/78.20d5bfb0.js"><link rel="prefetch" href="/assets/js/79.d79451ba.js"><link rel="prefetch" href="/assets/js/8.bc79ed1b.js"><link rel="prefetch" href="/assets/js/80.c00c23a2.js"><link rel="prefetch" href="/assets/js/81.11b52d0d.js"><link rel="prefetch" href="/assets/js/82.98574bc2.js"><link rel="prefetch" href="/assets/js/83.9683fd81.js"><link rel="prefetch" href="/assets/js/84.bbc5db65.js"><link rel="prefetch" href="/assets/js/85.a023c38b.js"><link rel="prefetch" href="/assets/js/86.699ab456.js"><link rel="prefetch" href="/assets/js/87.ca89a544.js"><link rel="prefetch" href="/assets/js/88.54b059d6.js"><link rel="prefetch" href="/assets/js/89.3647cbb5.js"><link rel="prefetch" href="/assets/js/9.d2cdbd1d.js"><link rel="prefetch" href="/assets/js/90.f75e538c.js"><link rel="prefetch" href="/assets/js/91.976e74f9.js"><link rel="prefetch" href="/assets/js/92.6d3e9fe4.js"><link rel="prefetch" href="/assets/js/93.ff1eb126.js"><link rel="prefetch" href="/assets/js/94.db89a413.js"><link rel="prefetch" href="/assets/js/95.953de281.js"><link rel="prefetch" href="/assets/js/96.f516026c.js"><link rel="prefetch" href="/assets/js/97.2af28748.js"><link rel="prefetch" href="/assets/js/98.dc362b1a.js"><link rel="prefetch" href="/assets/js/99.d37c25b5.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.ac6383e3.js"> |
| <link rel="stylesheet" href="/assets/css/0.styles.de170ea0.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/Master/API/Programming-TsFile-API.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/API/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/Master/API/Programming-TsFile-API.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/API/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 (In progress)</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>IoTDB Introduction</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Quick Start</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Data Concept</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>CLI</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Administration Management</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>IoTDB-SQL Language</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>API</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/UserGuide/Master/API/Programming-JDBC.html" class="sidebar-link">JDBC</a></li><li><a href="/UserGuide/Master/API/Programming-Java-Native-API.html" class="sidebar-link">Java Native API</a></li><li><a href="/UserGuide/Master/API/Programming-Python-Native-API.html" class="sidebar-link">Python Native API</a></li><li><a href="/UserGuide/Master/API/Programming-Cpp-Native-API.html" class="sidebar-link">C++ Native API</a></li><li><a href="/UserGuide/Master/API/Programming-Go-Native-API.html" class="sidebar-link">Go Native API</a></li><li><a href="/UserGuide/Master/API/Programming-TsFile-API.html" aria-current="page" class="active sidebar-link">TsFile API</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Advanced Features</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Communication Service Protocol</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>System Tools</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Collaboration of Edge and Cloud</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Ecosystem Integration</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Cluster Setup</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>FAQ</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Appendix</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>Comparison with TSDBs</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h2 id="tsfile-api"><a href="#tsfile-api" class="header-anchor">#</a> TsFile API</h2> <p>TsFile is a file format of Time Series used in IoTDB. This session introduces the usage of this file format.</p> <h3 id="tsfile-library-installation"><a href="#tsfile-library-installation" class="header-anchor">#</a> TsFile library Installation</h3> <p>There are two ways to use TsFile in your own project.</p> <ul><li>Use as jars: Compile the source codes and build to jars</li></ul> <div class="language-shell line-numbers-mode"><pre class="language-shell"><code><span class="token function">git</span> clone https://github.com/apache/iotdb.git |
| <span class="token builtin class-name">cd</span> tsfile/ |
| mvn clean package -Dmaven.test.skip<span class="token operator">=</span>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 are in folder named <code>target/</code>. Import <code>target/tsfile-0.12.0-jar-with-dependencies.jar</code> to your project.</p> <ul><li><p>Use 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-shell line-numbers-mode"><pre class="language-shell"><code><span class="token function">git</span> clone https://github.com/apache/iotdb.git |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>Compile the source codes and deploy</p> <div class="language-shell line-numbers-mode"><pre class="language-shell"><code><span class="token builtin class-name">cd</span> tsfile/ |
| mvn clean <span class="token function">install</span> -Dmaven.test.skip<span class="token operator">=</span>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-xml line-numbers-mode"><pre class="language-xml"><code> <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>dependency</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>groupId</span><span class="token punctuation">></span></span>org.apache.iotdb<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>groupId</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>artifactId</span><span class="token punctuation">></span></span>tsfile<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>artifactId</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>version</span><span class="token punctuation">></span></span>0.13.0-SNAPSHOT<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>version</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>dependency</span><span class="token punctuation">></span></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></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-xml line-numbers-mode"><pre class="language-xml"><code> <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>profile</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>id</span><span class="token punctuation">></span></span>allow-snapshots<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>id</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>activation</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>activeByDefault</span><span class="token punctuation">></span></span>true<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>activeByDefault</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation"></</span>activation</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>repositories</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>repository</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>id</span><span class="token punctuation">></span></span>apache.snapshots<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>id</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>name</span><span class="token punctuation">></span></span>Apache Development Snapshot Repository<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>name</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>url</span><span class="token punctuation">></span></span>https://repository.apache.org/content/repositories/snapshots/<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>url</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>releases</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>enabled</span><span class="token punctuation">></span></span>false<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>enabled</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>releases</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>snapshots</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>enabled</span><span class="token punctuation">></span></span>true<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>enabled</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>snapshots</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>repository</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>repositories</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>profile</span><span class="token punctuation">></span></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></div></div></li> <li><p>Then add dependencies into your project:</p> <div class="language-xml line-numbers-mode"><pre class="language-xml"><code> <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>dependency</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>groupId</span><span class="token punctuation">></span></span>org.apache.iotdb<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>groupId</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>artifactId</span><span class="token punctuation">></span></span>tsfile<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>artifactId</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"><</span>version</span><span class="token punctuation">></span></span>0.13.0-SNAPSHOT<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>version</span><span class="token punctuation">></span></span> |
| <span class="token tag"><span class="token tag"><span class="token punctuation"></</span>dependency</span><span class="token punctuation">></span></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></div></div></li></ul></li></ul> <h3 id="tsfile-usage"><a href="#tsfile-usage" class="header-anchor">#</a> TsFile Usage</h3> <p>This section demonstrates the detailed usages of TsFile.</p> <p>Time-series Data |
| Time-series data 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 data takes, 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 takes 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 dataset.</p></li></ul> <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 the 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><h4 id="write-tsfile"><a href="#write-tsfile" class="header-anchor">#</a> Write TsFile</h4> <p>A TsFile is generated by the following three steps and the complete code is given in the section "Example for writing TsFile".</p> <ol><li><p>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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span><span class="token class-name">File</span> file<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span><span class="token class-name">File</span> file<span class="token punctuation">,</span> <span class="token class-name">Schema</span> schema<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span><span class="token class-name">TsFileOutput</span> output<span class="token punctuation">,</span> <span class="token class-name">Schema</span> schema<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">TSFileConfig</span> conf <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TSFileConfig</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| conf<span class="token punctuation">.</span><span class="token function">setTSFileStorageFs</span><span class="token punctuation">(</span><span class="token string">"HDFS"</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>file<span class="token punctuation">,</span> schema<span class="token punctuation">,</span> conf<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></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 rpc port of your HDFS by <code>config.setHdfsIp(...)</code> and <code>config.setHdfsPort(...)</code>. The default ip is <code>localhost</code> and default rpc 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>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-java line-numbers-mode"><pre class="language-java"><code><span class="token comment">// Create an empty Schema or from an existing map</span> |
| <span class="token keyword">public</span> <span class="token class-name">Schema</span><span class="token punctuation">(</span><span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token class-name">Schema</span><span class="token punctuation">(</span><span class="token class-name">Map</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">String</span><span class="token punctuation">,</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">></span></span> measurements<span class="token punctuation">)</span> |
| <span class="token comment">// Use this two interfaces to add measurements</span> |
| <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">registerMeasurement</span><span class="token punctuation">(</span><span class="token class-name">MeasurementSchema</span> descriptor<span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">registerMeasurements</span><span class="token punctuation">(</span><span class="token class-name">Map</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">String</span><span class="token punctuation">,</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">></span></span> measurements<span class="token punctuation">)</span> |
| <span class="token comment">// Some useful getter and checker</span> |
| <span class="token keyword">public</span> <span class="token class-name">TSDataType</span> <span class="token function">getMeasurementDataType</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token class-name">MeasurementSchema</span> <span class="token function">getMeasurementSchema</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token class-name">Map</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">String</span><span class="token punctuation">,</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">></span></span> <span class="token function">getAllMeasurementSchema</span><span class="token punctuation">(</span><span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token keyword">boolean</span> <span class="token function">hasMeasurement</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<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></div></div><p>You can always use the following interface in <code>TsFileWriter</code> class to add additional measurements:</p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token keyword">void</span> <span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token class-name">MeasurementSchema</span> measurementSchema<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">WriteProcessException</span> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<span class="token punctuation">,</span> <span class="token class-name">TSDataType</span> type<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span> encoding<span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<span class="token punctuation">,</span> <span class="token class-name">TSDataType</span> type<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span> encoding<span class="token punctuation">,</span> <span class="token class-name">CompressionType</span> compressionType<span class="token punctuation">)</span> |
| <span class="token keyword">public</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token class-name">String</span> measurementId<span class="token punctuation">,</span> <span class="token class-name">TSDataType</span> type<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span> encoding<span class="token punctuation">,</span> <span class="token class-name">CompressionType</span> compressionType<span class="token punctuation">,</span> |
| <span class="token class-name">Map</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">String</span><span class="token punctuation">,</span> <span class="token class-name">String</span><span class="token punctuation">></span></span> props<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></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.</p></li> <li><p>compression: The data compression.</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-java line-numbers-mode"><pre class="language-java"><code><span class="token comment">// The measurement "sensor_1" is float type</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>FLOAT<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">// This call will throw a WriteProcessException exception</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></div></div></li></ol> <p>addMeasurement(new MeasurementSchema("sensor_1", TSDataType.INT32, TSEncoding.RLE));</p> <div class="language- line-numbers-mode"><pre class="language-text"><code></code></pre> <div class="line-numbers-wrapper"></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code> |
| 3. insert and write data continually. |
| |
| Use this interface to create a new `TSRecord`(a timestamp and device pair). |
| |
| ```java |
| public TSRecord(long timestamp, String deviceId) |
| ``` |
| </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></div></div><div class="language- extra-class"><pre><code>Then create a `DataPoint`(a measurement and value pair), and use the addTuple method to add the DataPoint to the correct |
| TsRecord. |
| |
| Use this method to write |
| |
| ```java |
| public void write(TSRecord record) throws IOException, WriteProcessException |
| </code></pre></div><div class="language- line-numbers-mode"><pre class="language-text"><code> |
| 4. call `close` to finish this writing process. |
| |
| ```java |
| public void close() throws IOException |
| ``` |
| |
| We are also able to write data into a closed TsFile. |
| |
| 1. Use `ForceAppendTsFileWriter` to open a closed file. |
| |
| ```java |
| public ForceAppendTsFileWriter(File file) throws IOException |
| ``` |
| |
| 2. call `doTruncate` truncate the part of Metadata |
| |
| 3. Then use `ForceAppendTsFileWriter` to construct a new `TsFileWriter` |
| |
| ```java |
| public TsFileWriter(TsFileIOWriter fileWriter) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br></div></div><p>Please note, we should redo the step of adding measurements before writing new data to the TsFile.</p> <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-shell line-numbers-mode"><pre class="language-shell"><code>mvn clean <span class="token function">install</span> -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> <p>You could write a TsFile by constructing <strong>Tablet</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/TsFileWriteWithTablet.java</code></p> <p>You could write data into a closed TsFile by using <strong>ForceAppendTsFileWriter</strong>.</p> <p>A more thorough example can be found at <code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileForceAppendWrite.java</code></p> <h4 id="interface-for-reading-tsfile"><a href="#interface-for-reading-tsfile" class="header-anchor">#</a> Interface for Reading TsFile</h4> <ul><li>Definition of Path</li></ul> <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-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">Path</span> p <span class="token operator">=</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> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">List</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 class-name">Path</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_3"</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></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> <ul><li><p>Definition of Filter</p></li> <li><p>Usage Scenario |
| Filter is used in TsFile reading process to select data satisfying one or more given condition(s).</p></li> <li><p>IExpression |
| 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></li> <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).</p> <table><thead><tr><th>Relationship</th> <th>Description</th></tr></thead> <tbody><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></tbody></table></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> <p>Filter Expression Examples</p> <ul><li><p><strong>TimeFilterExpression Examples</strong></p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">IExpression</span> timeFilterExpr <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">GlobalTimeExpression</span><span class="token punctuation">(</span><span class="token class-name">TimeFilter</span><span class="token punctuation">.</span><span class="token function">eq</span><span class="token punctuation">(</span><span class="token number">15</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// series time = 15</span> |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code> ```java |
| 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-java line-numbers-mode"><pre class="language-java"><code> <span class="token class-name">IExpression</span> timeFilterExpr <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">GlobalTimeExpression</span><span class="token punctuation">(</span><span class="token class-name">TimeFilter</span><span class="token punctuation">.</span><span class="token function">lt</span><span class="token punctuation">(</span><span class="token number">15</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> <span class="token comment">// series time < 15</span> |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><div class="language- extra-class"><pre><code>```java |
| </code></pre></div><p>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.gtEq(15)); // series time >= 15 |
| <code></code>java |
| IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.notEq(15)); // series time != 15</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> ```java |
| 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><span class="line-number">3</span><br><span class="line-number">4</span><br></div></div><div class="language- extra-class"><pre><code>```java |
| IExpression timeFilterExpr = BinaryExpression.or( |
| new GlobalTimeExpression(TimeFilter.gtEq(15L)), |
| new GlobalTimeExpression(TimeFilter.lt(25L))); // series time >= 15 or series time < 25 |
| ``` |
| </code></pre></div><ul><li>Read Interface</li></ul> <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-java line-numbers-mode"><pre class="language-java"><code><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> |
| </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-java line-numbers-mode"><pre class="language-java"><code><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> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">QueryDataSet</span> <span class="token function">query</span><span class="token punctuation">(</span><span class="token class-name">QueryExpression</span> queryExpression<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> |
| </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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">public</span> <span class="token class-name">QueryDataSet</span> <span class="token function">query</span><span class="token punctuation">(</span><span class="token class-name">QueryExpression</span> queryExpression<span class="token punctuation">,</span> <span class="token keyword">long</span> partitionStartOffset<span class="token punctuation">,</span> <span class="token keyword">long</span> partitionEndOffset<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> |
| </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> <li><p>QueryDataset Interface</p></li></ul> <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></li></ul> <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><ul><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-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">long</span> <span class="token function">getTimestamp</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">List</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">Field</span><span class="token punctuation">></span></span> <span class="token function">getFields</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></div></div><p>To get data from one Field, use these methods:</p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">TSDataType</span> <span class="token function">getDataType</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">Object</span> <span class="token function">getObjectValue</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></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></div></div><h3 id="change-tsfile-configuration"><a href="#change-tsfile-configuration" class="header-anchor">#</a> Change TsFile Configuration</h3> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token class-name">TSFileConfig</span> config <span class="token operator">=</span> <span class="token class-name">TSFileDescriptor</span><span class="token punctuation">.</span><span class="token function">getInstance</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token function">getConfig</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| config<span class="token punctuation">.</span><span class="token function">setXXX</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></div></div></div> <div class="page-nav"><p class="inner"><span class="prev"> |
| ← |
| <a href="/UserGuide/Master/API/Programming-Go-Native-API.html" class="prev"> |
| Go Native API |
| </a></span> <span class="next"><a href="/UserGuide/Master/Advanced-Features/UDF-User-Defined-Function.html"> |
| UDF (User Defined Function) |
| </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.1ae7b898.js" defer></script><script src="/assets/js/3.7fccac46.js" defer></script><script src="/assets/js/61.0cd28e4b.js" defer></script> |
| </body> |
| </html> |