| <!DOCTYPE html> |
| <html lang="zh-CN"> |
| <head> |
| <meta charset="utf-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| <title> </title> |
| <meta name="generator" content="VuePress 1.6.0"> |
| <link rel="icon" href="/favicon.ico"> |
| <meta name="description" content=" "> |
| <meta name="Description" content="Apache IoTDB: Time Series Database for IoT"> |
| <meta name="Keywords" content="TSDB, time series, time series database, IoTDB, IoT database, IoT data management,时序数据库, 时间序列管理, IoTDB, 物联网数据库, 实时数据库, 物联网数据管理, 物联网数据"> |
| <meta name="baidu-site-verification" content="wfKETzB3OT"> |
| <meta name="google-site-verification" content="mZWAoRY0yj_HAr-s47zHCGHzx5Ju-RVm5wDbPnwQYFo"> |
| <link rel="preload" href="/assets/css/0.styles.1c0ab417.css" as="style"><link rel="preload" href="/assets/js/app.a43d7cd0.js" as="script"><link rel="preload" href="/assets/js/3.6210d98e.js" as="script"><link rel="preload" href="/assets/js/374.0e15cf2e.js" as="script"><link rel="prefetch" href="/assets/js/10.a8c2da4d.js"><link rel="prefetch" href="/assets/js/100.610c16f2.js"><link rel="prefetch" href="/assets/js/101.cb7d6071.js"><link rel="prefetch" href="/assets/js/102.ae495060.js"><link rel="prefetch" href="/assets/js/103.a8df0800.js"><link rel="prefetch" href="/assets/js/104.2245511e.js"><link rel="prefetch" href="/assets/js/105.3f6e6516.js"><link rel="prefetch" href="/assets/js/106.c29577c2.js"><link rel="prefetch" href="/assets/js/107.d1b2cd67.js"><link rel="prefetch" href="/assets/js/108.8ef3a4c5.js"><link rel="prefetch" href="/assets/js/109.dc0fb58e.js"><link rel="prefetch" href="/assets/js/11.a8f8817f.js"><link rel="prefetch" href="/assets/js/110.b714fc01.js"><link rel="prefetch" href="/assets/js/111.a5d11e38.js"><link rel="prefetch" href="/assets/js/112.6d1a395f.js"><link rel="prefetch" href="/assets/js/113.5dfad6f9.js"><link rel="prefetch" href="/assets/js/114.43308969.js"><link rel="prefetch" href="/assets/js/115.8096c93e.js"><link rel="prefetch" href="/assets/js/116.a6976ccd.js"><link rel="prefetch" href="/assets/js/117.f323e27f.js"><link rel="prefetch" href="/assets/js/118.57bb1abd.js"><link rel="prefetch" href="/assets/js/119.c73ae4f0.js"><link rel="prefetch" href="/assets/js/12.d6e39d88.js"><link rel="prefetch" href="/assets/js/120.13871423.js"><link rel="prefetch" href="/assets/js/121.9d905e19.js"><link rel="prefetch" href="/assets/js/122.668d2488.js"><link rel="prefetch" href="/assets/js/123.ce6c2002.js"><link rel="prefetch" href="/assets/js/124.66d50dad.js"><link rel="prefetch" href="/assets/js/125.9f34d14d.js"><link rel="prefetch" href="/assets/js/126.4e916938.js"><link rel="prefetch" href="/assets/js/127.de1c9600.js"><link rel="prefetch" href="/assets/js/128.18945ba9.js"><link rel="prefetch" href="/assets/js/129.e371cf05.js"><link rel="prefetch" href="/assets/js/13.19327a9c.js"><link rel="prefetch" href="/assets/js/130.6f0854cf.js"><link rel="prefetch" href="/assets/js/131.4490139b.js"><link rel="prefetch" href="/assets/js/132.d17b7727.js"><link rel="prefetch" href="/assets/js/133.5d136bd2.js"><link rel="prefetch" href="/assets/js/134.85e21f55.js"><link rel="prefetch" href="/assets/js/135.c2a5c73e.js"><link rel="prefetch" href="/assets/js/136.ea80add8.js"><link rel="prefetch" href="/assets/js/137.162ad739.js"><link rel="prefetch" href="/assets/js/138.003e92a6.js"><link rel="prefetch" href="/assets/js/139.77af0781.js"><link rel="prefetch" href="/assets/js/14.155ff9c5.js"><link rel="prefetch" href="/assets/js/140.9a3b2358.js"><link rel="prefetch" href="/assets/js/141.08896ed8.js"><link rel="prefetch" href="/assets/js/142.8f892360.js"><link rel="prefetch" href="/assets/js/143.c07eb590.js"><link rel="prefetch" href="/assets/js/144.d786614a.js"><link rel="prefetch" href="/assets/js/145.795b9025.js"><link rel="prefetch" href="/assets/js/146.b999e2b1.js"><link rel="prefetch" href="/assets/js/147.ae5efbfc.js"><link rel="prefetch" href="/assets/js/148.55918b45.js"><link rel="prefetch" href="/assets/js/149.963af3d6.js"><link rel="prefetch" href="/assets/js/15.f2dcca51.js"><link rel="prefetch" href="/assets/js/150.7ecfce29.js"><link rel="prefetch" href="/assets/js/151.2cedc233.js"><link rel="prefetch" href="/assets/js/152.5a57be5f.js"><link rel="prefetch" href="/assets/js/153.0269b0ba.js"><link rel="prefetch" href="/assets/js/154.b21f8642.js"><link rel="prefetch" href="/assets/js/155.aa88d113.js"><link rel="prefetch" href="/assets/js/156.d81dea62.js"><link rel="prefetch" href="/assets/js/157.f4c11fdc.js"><link rel="prefetch" href="/assets/js/158.f37d52c1.js"><link rel="prefetch" href="/assets/js/159.698bd399.js"><link rel="prefetch" href="/assets/js/16.68617903.js"><link rel="prefetch" href="/assets/js/160.3cbd628c.js"><link rel="prefetch" href="/assets/js/161.e509f048.js"><link rel="prefetch" href="/assets/js/162.c8a094e6.js"><link rel="prefetch" href="/assets/js/163.3a775f8c.js"><link rel="prefetch" href="/assets/js/164.d2890cfc.js"><link rel="prefetch" href="/assets/js/165.b4b5c056.js"><link rel="prefetch" href="/assets/js/166.dbe88230.js"><link rel="prefetch" href="/assets/js/167.f06c4e8e.js"><link rel="prefetch" href="/assets/js/168.4ba6d0d5.js"><link rel="prefetch" href="/assets/js/169.8db4c44f.js"><link rel="prefetch" href="/assets/js/17.f9c56825.js"><link rel="prefetch" href="/assets/js/170.e0f40101.js"><link rel="prefetch" href="/assets/js/171.02f1c9a7.js"><link rel="prefetch" href="/assets/js/172.23fa5fe7.js"><link rel="prefetch" href="/assets/js/173.3426b1ab.js"><link rel="prefetch" href="/assets/js/174.2912e5dd.js"><link rel="prefetch" href="/assets/js/175.b49e057c.js"><link rel="prefetch" href="/assets/js/176.3fecec61.js"><link rel="prefetch" href="/assets/js/177.120d4f6d.js"><link rel="prefetch" href="/assets/js/178.f31cf22e.js"><link rel="prefetch" href="/assets/js/179.8250f5b4.js"><link rel="prefetch" href="/assets/js/18.6a45243e.js"><link rel="prefetch" href="/assets/js/180.03c29a93.js"><link rel="prefetch" href="/assets/js/181.76d2e48e.js"><link rel="prefetch" href="/assets/js/182.a1289998.js"><link rel="prefetch" href="/assets/js/183.95e8b928.js"><link rel="prefetch" href="/assets/js/184.51ec376a.js"><link rel="prefetch" href="/assets/js/185.7850656d.js"><link rel="prefetch" href="/assets/js/186.46790403.js"><link rel="prefetch" href="/assets/js/187.dba668f4.js"><link rel="prefetch" href="/assets/js/188.9ef76ad8.js"><link rel="prefetch" href="/assets/js/189.e17095d5.js"><link rel="prefetch" href="/assets/js/19.db72f43f.js"><link rel="prefetch" href="/assets/js/190.b06fed0c.js"><link rel="prefetch" href="/assets/js/191.82487132.js"><link rel="prefetch" href="/assets/js/192.6f6ed4ef.js"><link rel="prefetch" href="/assets/js/193.4553db6e.js"><link rel="prefetch" href="/assets/js/194.dc7c8aed.js"><link rel="prefetch" href="/assets/js/195.18a15b0a.js"><link rel="prefetch" href="/assets/js/196.30b5b248.js"><link rel="prefetch" href="/assets/js/197.e10b8a1d.js"><link rel="prefetch" href="/assets/js/198.a5e0c58e.js"><link rel="prefetch" href="/assets/js/199.2c0baf59.js"><link rel="prefetch" href="/assets/js/20.4c74811a.js"><link rel="prefetch" href="/assets/js/200.d07091f7.js"><link rel="prefetch" href="/assets/js/201.1ebc8666.js"><link rel="prefetch" href="/assets/js/202.f5267ff1.js"><link rel="prefetch" href="/assets/js/203.acfb9c3d.js"><link rel="prefetch" href="/assets/js/204.8d928037.js"><link rel="prefetch" href="/assets/js/205.9bc72cf2.js"><link rel="prefetch" href="/assets/js/206.80d7696d.js"><link rel="prefetch" href="/assets/js/207.6298850d.js"><link rel="prefetch" href="/assets/js/208.afe92c6b.js"><link rel="prefetch" href="/assets/js/209.133841c6.js"><link rel="prefetch" href="/assets/js/21.19ce7f11.js"><link rel="prefetch" href="/assets/js/210.132b2f3d.js"><link rel="prefetch" href="/assets/js/211.02812a4d.js"><link rel="prefetch" href="/assets/js/212.4d5ea528.js"><link rel="prefetch" href="/assets/js/213.53e6d733.js"><link rel="prefetch" href="/assets/js/214.730115ce.js"><link rel="prefetch" href="/assets/js/215.37dbe437.js"><link rel="prefetch" href="/assets/js/216.a65b1897.js"><link rel="prefetch" href="/assets/js/217.a0d8d7f2.js"><link rel="prefetch" href="/assets/js/218.ad3bdbec.js"><link rel="prefetch" href="/assets/js/219.4b296837.js"><link rel="prefetch" href="/assets/js/22.9a23de49.js"><link rel="prefetch" href="/assets/js/220.e6548648.js"><link rel="prefetch" href="/assets/js/221.73cc84cf.js"><link rel="prefetch" href="/assets/js/222.6ff0f81e.js"><link rel="prefetch" href="/assets/js/223.e4b3404e.js"><link rel="prefetch" href="/assets/js/224.4e148f22.js"><link rel="prefetch" href="/assets/js/225.7ab00c65.js"><link rel="prefetch" href="/assets/js/226.6ee2800c.js"><link rel="prefetch" href="/assets/js/227.dbafe68f.js"><link rel="prefetch" href="/assets/js/228.3635bbf3.js"><link rel="prefetch" href="/assets/js/229.c8b044a3.js"><link rel="prefetch" href="/assets/js/23.eb7d2c98.js"><link rel="prefetch" href="/assets/js/230.5cd73e63.js"><link rel="prefetch" href="/assets/js/231.b5154f98.js"><link rel="prefetch" href="/assets/js/232.b394b06b.js"><link rel="prefetch" href="/assets/js/233.89870d38.js"><link rel="prefetch" href="/assets/js/234.3626182e.js"><link rel="prefetch" href="/assets/js/235.918055e1.js"><link rel="prefetch" href="/assets/js/236.c5884eb4.js"><link rel="prefetch" href="/assets/js/237.bc5f6c74.js"><link rel="prefetch" href="/assets/js/238.462914c3.js"><link rel="prefetch" href="/assets/js/239.45f73834.js"><link rel="prefetch" href="/assets/js/24.22e7a403.js"><link rel="prefetch" href="/assets/js/240.780a1ce0.js"><link rel="prefetch" href="/assets/js/241.6b01b690.js"><link rel="prefetch" href="/assets/js/242.0c763bc8.js"><link rel="prefetch" href="/assets/js/243.d4c09b4e.js"><link rel="prefetch" href="/assets/js/244.31b37057.js"><link rel="prefetch" href="/assets/js/245.981233f0.js"><link rel="prefetch" href="/assets/js/246.e4c1428a.js"><link rel="prefetch" href="/assets/js/247.e25f44b4.js"><link rel="prefetch" href="/assets/js/248.7bdfd8b2.js"><link rel="prefetch" href="/assets/js/249.d3a237d9.js"><link rel="prefetch" href="/assets/js/25.6410dcd3.js"><link rel="prefetch" href="/assets/js/250.10034fc7.js"><link rel="prefetch" href="/assets/js/251.168761c0.js"><link rel="prefetch" href="/assets/js/252.6f0f4214.js"><link rel="prefetch" href="/assets/js/253.4b794839.js"><link rel="prefetch" href="/assets/js/254.b563d2fa.js"><link rel="prefetch" href="/assets/js/255.7cfd9f1f.js"><link rel="prefetch" href="/assets/js/256.86cbb101.js"><link rel="prefetch" href="/assets/js/257.f150714a.js"><link rel="prefetch" href="/assets/js/258.1cf5cfe1.js"><link rel="prefetch" href="/assets/js/259.4e2f6cde.js"><link rel="prefetch" href="/assets/js/26.3bad1fe4.js"><link rel="prefetch" href="/assets/js/260.43d2bf2c.js"><link rel="prefetch" href="/assets/js/261.de64501f.js"><link rel="prefetch" href="/assets/js/262.3fffbe47.js"><link rel="prefetch" href="/assets/js/263.431cfbc4.js"><link rel="prefetch" href="/assets/js/264.3ac3da15.js"><link rel="prefetch" href="/assets/js/265.f6808bd4.js"><link rel="prefetch" href="/assets/js/266.4ca922e8.js"><link rel="prefetch" href="/assets/js/267.43a0858e.js"><link rel="prefetch" href="/assets/js/268.cdfdd162.js"><link rel="prefetch" href="/assets/js/269.bfa60072.js"><link rel="prefetch" href="/assets/js/27.e0436567.js"><link rel="prefetch" href="/assets/js/270.10b63901.js"><link rel="prefetch" href="/assets/js/271.c08237ce.js"><link rel="prefetch" href="/assets/js/272.eb663d76.js"><link rel="prefetch" href="/assets/js/273.286cd5e4.js"><link rel="prefetch" href="/assets/js/274.1e503eb5.js"><link rel="prefetch" href="/assets/js/275.3534c62b.js"><link rel="prefetch" href="/assets/js/276.82fbecb1.js"><link rel="prefetch" href="/assets/js/277.0f5d5705.js"><link rel="prefetch" href="/assets/js/278.6f43457f.js"><link rel="prefetch" href="/assets/js/279.98bcf600.js"><link rel="prefetch" href="/assets/js/28.87ee303f.js"><link rel="prefetch" href="/assets/js/280.b98abe82.js"><link rel="prefetch" href="/assets/js/281.be2dc320.js"><link rel="prefetch" href="/assets/js/282.3f6ca7fc.js"><link rel="prefetch" href="/assets/js/283.2f170354.js"><link rel="prefetch" href="/assets/js/284.6513faa5.js"><link rel="prefetch" href="/assets/js/285.aaf2cbc6.js"><link rel="prefetch" href="/assets/js/286.4fc383e8.js"><link rel="prefetch" href="/assets/js/287.d9029cf5.js"><link rel="prefetch" href="/assets/js/288.135ff5c4.js"><link rel="prefetch" href="/assets/js/289.d33c4d85.js"><link rel="prefetch" href="/assets/js/29.d3d6e6b3.js"><link rel="prefetch" href="/assets/js/290.8c5fb962.js"><link rel="prefetch" href="/assets/js/291.0b9c7751.js"><link rel="prefetch" href="/assets/js/292.54c34e79.js"><link rel="prefetch" href="/assets/js/293.86e62273.js"><link rel="prefetch" href="/assets/js/294.df4b0bc9.js"><link rel="prefetch" href="/assets/js/295.e50b7cd9.js"><link rel="prefetch" href="/assets/js/296.91f8770b.js"><link rel="prefetch" href="/assets/js/297.5e8c5bfa.js"><link rel="prefetch" href="/assets/js/298.b6bbf7c5.js"><link rel="prefetch" href="/assets/js/299.04718448.js"><link rel="prefetch" href="/assets/js/30.3650586b.js"><link rel="prefetch" href="/assets/js/300.bec6a12b.js"><link rel="prefetch" href="/assets/js/301.d50543c3.js"><link rel="prefetch" href="/assets/js/302.8c809032.js"><link rel="prefetch" href="/assets/js/303.4a1071b2.js"><link rel="prefetch" href="/assets/js/304.aafbe597.js"><link rel="prefetch" href="/assets/js/305.66139de5.js"><link rel="prefetch" href="/assets/js/306.6310a4f5.js"><link rel="prefetch" href="/assets/js/307.8a392989.js"><link rel="prefetch" href="/assets/js/308.18595d18.js"><link rel="prefetch" href="/assets/js/309.e67b8dbe.js"><link rel="prefetch" href="/assets/js/31.b94d0bbe.js"><link rel="prefetch" href="/assets/js/310.b1dbbf1c.js"><link rel="prefetch" href="/assets/js/311.f9f34ef3.js"><link rel="prefetch" href="/assets/js/312.98309630.js"><link rel="prefetch" href="/assets/js/313.44844612.js"><link rel="prefetch" href="/assets/js/314.a3b20b70.js"><link rel="prefetch" href="/assets/js/315.b4af0dbe.js"><link rel="prefetch" href="/assets/js/316.11be37cf.js"><link rel="prefetch" href="/assets/js/317.8bfdda93.js"><link rel="prefetch" href="/assets/js/318.663ffbcc.js"><link rel="prefetch" href="/assets/js/319.59af0d55.js"><link rel="prefetch" href="/assets/js/32.ff896413.js"><link rel="prefetch" href="/assets/js/320.9ed2a82c.js"><link rel="prefetch" href="/assets/js/321.fac3ebc4.js"><link rel="prefetch" href="/assets/js/322.96d349d2.js"><link rel="prefetch" href="/assets/js/323.2fcdfd96.js"><link rel="prefetch" href="/assets/js/324.a19966ff.js"><link rel="prefetch" href="/assets/js/325.987eaec4.js"><link rel="prefetch" href="/assets/js/326.18894f23.js"><link rel="prefetch" href="/assets/js/327.2014e08f.js"><link rel="prefetch" href="/assets/js/328.86e52e6b.js"><link rel="prefetch" href="/assets/js/329.0424d7d5.js"><link rel="prefetch" href="/assets/js/33.95a3ac05.js"><link rel="prefetch" href="/assets/js/330.40f26bb0.js"><link rel="prefetch" href="/assets/js/331.65ee89c2.js"><link rel="prefetch" href="/assets/js/332.31da3cb2.js"><link rel="prefetch" href="/assets/js/333.793650ee.js"><link rel="prefetch" href="/assets/js/334.63832503.js"><link rel="prefetch" href="/assets/js/335.62c60028.js"><link rel="prefetch" href="/assets/js/336.a520628c.js"><link rel="prefetch" href="/assets/js/337.236ce253.js"><link rel="prefetch" href="/assets/js/338.88377897.js"><link rel="prefetch" href="/assets/js/339.88b3d8a2.js"><link rel="prefetch" href="/assets/js/34.e93e2e55.js"><link rel="prefetch" href="/assets/js/340.5b139ee6.js"><link rel="prefetch" href="/assets/js/341.9fc8c6ed.js"><link rel="prefetch" href="/assets/js/342.3ad73777.js"><link rel="prefetch" href="/assets/js/343.2c8ba853.js"><link rel="prefetch" href="/assets/js/344.d9f7d184.js"><link rel="prefetch" href="/assets/js/345.59284c96.js"><link rel="prefetch" href="/assets/js/346.bb62fee3.js"><link rel="prefetch" href="/assets/js/347.a504768f.js"><link rel="prefetch" href="/assets/js/348.f7fc33f2.js"><link rel="prefetch" href="/assets/js/349.a0969f85.js"><link rel="prefetch" href="/assets/js/35.2eaa786a.js"><link rel="prefetch" href="/assets/js/350.8be88652.js"><link rel="prefetch" href="/assets/js/351.a0134bc5.js"><link rel="prefetch" href="/assets/js/352.7c6b05f5.js"><link rel="prefetch" href="/assets/js/353.13f82a67.js"><link rel="prefetch" href="/assets/js/354.7a15a639.js"><link rel="prefetch" href="/assets/js/355.ce87b8a8.js"><link rel="prefetch" href="/assets/js/356.7f271afc.js"><link rel="prefetch" href="/assets/js/357.cd4e6ad5.js"><link rel="prefetch" href="/assets/js/358.231646f5.js"><link rel="prefetch" href="/assets/js/359.951751b8.js"><link rel="prefetch" href="/assets/js/36.0eb14751.js"><link rel="prefetch" href="/assets/js/360.d10a92ff.js"><link rel="prefetch" href="/assets/js/361.30a528c6.js"><link rel="prefetch" href="/assets/js/362.605a4856.js"><link rel="prefetch" href="/assets/js/363.4b0724ed.js"><link rel="prefetch" href="/assets/js/364.09e0ac23.js"><link rel="prefetch" href="/assets/js/365.6cbdb6bb.js"><link rel="prefetch" href="/assets/js/366.f3df5cb3.js"><link rel="prefetch" href="/assets/js/367.5dc304a0.js"><link rel="prefetch" href="/assets/js/368.cfe55d3a.js"><link rel="prefetch" href="/assets/js/369.122e17a6.js"><link rel="prefetch" href="/assets/js/37.373de478.js"><link rel="prefetch" href="/assets/js/370.57e7ca05.js"><link rel="prefetch" href="/assets/js/371.aed8699f.js"><link rel="prefetch" href="/assets/js/372.1c47c97c.js"><link rel="prefetch" href="/assets/js/373.9d2cee25.js"><link rel="prefetch" href="/assets/js/375.d505f167.js"><link rel="prefetch" href="/assets/js/376.5c7a7c26.js"><link rel="prefetch" href="/assets/js/377.a4a94146.js"><link rel="prefetch" href="/assets/js/378.4147bf94.js"><link rel="prefetch" href="/assets/js/379.d4ee40ad.js"><link rel="prefetch" href="/assets/js/38.ab334ffd.js"><link rel="prefetch" href="/assets/js/380.6fa857a5.js"><link rel="prefetch" href="/assets/js/381.2aeee47a.js"><link rel="prefetch" href="/assets/js/382.630fed60.js"><link rel="prefetch" href="/assets/js/383.e6921012.js"><link rel="prefetch" href="/assets/js/384.57717d76.js"><link rel="prefetch" href="/assets/js/385.b4355c7e.js"><link rel="prefetch" href="/assets/js/386.5e7b9753.js"><link rel="prefetch" href="/assets/js/387.c752e45f.js"><link rel="prefetch" href="/assets/js/388.05e04b1c.js"><link rel="prefetch" href="/assets/js/389.a8ad271f.js"><link rel="prefetch" href="/assets/js/39.409d903d.js"><link rel="prefetch" href="/assets/js/390.560fbe59.js"><link rel="prefetch" href="/assets/js/391.4fc3f261.js"><link rel="prefetch" href="/assets/js/392.b409a196.js"><link rel="prefetch" href="/assets/js/393.043b9fb3.js"><link rel="prefetch" href="/assets/js/394.07d26f84.js"><link rel="prefetch" href="/assets/js/395.ac86423f.js"><link rel="prefetch" href="/assets/js/396.096b1b5d.js"><link rel="prefetch" href="/assets/js/397.c36e4f7d.js"><link rel="prefetch" href="/assets/js/398.62aed540.js"><link rel="prefetch" href="/assets/js/399.081d7ba5.js"><link rel="prefetch" href="/assets/js/4.e53d8224.js"><link rel="prefetch" href="/assets/js/40.8d1d6eb3.js"><link rel="prefetch" href="/assets/js/400.baebd974.js"><link rel="prefetch" href="/assets/js/401.297d2159.js"><link rel="prefetch" href="/assets/js/402.37a81f3c.js"><link rel="prefetch" href="/assets/js/403.9ddf70fc.js"><link rel="prefetch" href="/assets/js/404.bb1cf823.js"><link rel="prefetch" href="/assets/js/405.c1f982a3.js"><link rel="prefetch" href="/assets/js/406.cef2382f.js"><link rel="prefetch" href="/assets/js/407.8ce0ef14.js"><link rel="prefetch" href="/assets/js/408.70093677.js"><link rel="prefetch" href="/assets/js/409.8470a10f.js"><link rel="prefetch" href="/assets/js/41.a0b11040.js"><link rel="prefetch" href="/assets/js/410.7fcfbb14.js"><link rel="prefetch" href="/assets/js/411.12656519.js"><link rel="prefetch" href="/assets/js/412.4ed961de.js"><link rel="prefetch" href="/assets/js/413.fb18f466.js"><link rel="prefetch" href="/assets/js/414.52ae334e.js"><link rel="prefetch" href="/assets/js/415.bf1d3eef.js"><link rel="prefetch" href="/assets/js/416.bfb61bc5.js"><link rel="prefetch" href="/assets/js/417.693a17bd.js"><link rel="prefetch" href="/assets/js/418.2a62e26f.js"><link rel="prefetch" href="/assets/js/419.af18f800.js"><link rel="prefetch" href="/assets/js/42.d7b5cb69.js"><link rel="prefetch" href="/assets/js/420.96bf44c3.js"><link rel="prefetch" href="/assets/js/421.d40d2a5b.js"><link rel="prefetch" href="/assets/js/422.d4aa9626.js"><link rel="prefetch" href="/assets/js/423.2c29f7aa.js"><link rel="prefetch" href="/assets/js/424.30db9de9.js"><link rel="prefetch" href="/assets/js/425.9c8b4212.js"><link rel="prefetch" href="/assets/js/426.d258d015.js"><link rel="prefetch" href="/assets/js/427.e5c806f7.js"><link rel="prefetch" href="/assets/js/428.35490fd4.js"><link rel="prefetch" href="/assets/js/429.71b82b78.js"><link rel="prefetch" href="/assets/js/43.070ce713.js"><link rel="prefetch" href="/assets/js/430.cedb78bd.js"><link rel="prefetch" href="/assets/js/431.37ca9c54.js"><link rel="prefetch" href="/assets/js/432.828817f0.js"><link rel="prefetch" href="/assets/js/433.645623f7.js"><link rel="prefetch" href="/assets/js/434.7bb50d9b.js"><link rel="prefetch" href="/assets/js/435.f39a1847.js"><link rel="prefetch" href="/assets/js/436.63593e43.js"><link rel="prefetch" href="/assets/js/437.c596b089.js"><link rel="prefetch" href="/assets/js/438.240d8e15.js"><link rel="prefetch" href="/assets/js/439.feaf2e3b.js"><link rel="prefetch" href="/assets/js/44.127fc92f.js"><link rel="prefetch" href="/assets/js/440.9580ce02.js"><link rel="prefetch" href="/assets/js/441.b9d60f11.js"><link rel="prefetch" href="/assets/js/442.5ee1e745.js"><link rel="prefetch" href="/assets/js/443.b130f757.js"><link rel="prefetch" href="/assets/js/444.8e1416de.js"><link rel="prefetch" href="/assets/js/445.db2ad3e4.js"><link rel="prefetch" href="/assets/js/446.908a7437.js"><link rel="prefetch" href="/assets/js/447.569f186b.js"><link rel="prefetch" href="/assets/js/448.cfa84110.js"><link rel="prefetch" href="/assets/js/449.8a975324.js"><link rel="prefetch" href="/assets/js/45.aa6f26c9.js"><link rel="prefetch" href="/assets/js/450.db91d3af.js"><link rel="prefetch" href="/assets/js/451.8c67130b.js"><link rel="prefetch" href="/assets/js/46.d987e0bb.js"><link rel="prefetch" href="/assets/js/47.b175ddf4.js"><link rel="prefetch" href="/assets/js/48.1c23dfdd.js"><link rel="prefetch" href="/assets/js/49.5be54faf.js"><link rel="prefetch" href="/assets/js/5.e17246d6.js"><link rel="prefetch" href="/assets/js/50.b1da13e4.js"><link rel="prefetch" href="/assets/js/51.a89ccc8f.js"><link rel="prefetch" href="/assets/js/52.7549ee24.js"><link rel="prefetch" href="/assets/js/53.a5101355.js"><link rel="prefetch" href="/assets/js/54.ca16bf1e.js"><link rel="prefetch" href="/assets/js/55.088c245a.js"><link rel="prefetch" href="/assets/js/56.b04f7476.js"><link rel="prefetch" href="/assets/js/57.52759a0c.js"><link rel="prefetch" href="/assets/js/58.11d3f0dd.js"><link rel="prefetch" href="/assets/js/59.c0d44170.js"><link rel="prefetch" href="/assets/js/6.b497f2de.js"><link rel="prefetch" href="/assets/js/60.f4a5b3ce.js"><link rel="prefetch" href="/assets/js/61.69a0f8ec.js"><link rel="prefetch" href="/assets/js/62.f2884dc3.js"><link rel="prefetch" href="/assets/js/63.2200cd75.js"><link rel="prefetch" href="/assets/js/64.d1e195f6.js"><link rel="prefetch" href="/assets/js/65.f0196f55.js"><link rel="prefetch" href="/assets/js/66.a1d8a358.js"><link rel="prefetch" href="/assets/js/67.eb3af313.js"><link rel="prefetch" href="/assets/js/68.fc37b146.js"><link rel="prefetch" href="/assets/js/69.8a3039c1.js"><link rel="prefetch" href="/assets/js/7.050bd105.js"><link rel="prefetch" href="/assets/js/70.18f2ac49.js"><link rel="prefetch" href="/assets/js/71.f9c04e4e.js"><link rel="prefetch" href="/assets/js/72.72bb4f92.js"><link rel="prefetch" href="/assets/js/73.93a0e56f.js"><link rel="prefetch" href="/assets/js/74.94b0e415.js"><link rel="prefetch" href="/assets/js/75.0efe5bd8.js"><link rel="prefetch" href="/assets/js/76.411a149b.js"><link rel="prefetch" href="/assets/js/77.93f3a85b.js"><link rel="prefetch" href="/assets/js/78.e721ad23.js"><link rel="prefetch" href="/assets/js/79.52b8d1bb.js"><link rel="prefetch" href="/assets/js/8.ca5874dd.js"><link rel="prefetch" href="/assets/js/80.f7ff9764.js"><link rel="prefetch" href="/assets/js/81.b3fb800e.js"><link rel="prefetch" href="/assets/js/82.cda965c9.js"><link rel="prefetch" href="/assets/js/83.67402967.js"><link rel="prefetch" href="/assets/js/84.7111aac5.js"><link rel="prefetch" href="/assets/js/85.98a2cf19.js"><link rel="prefetch" href="/assets/js/86.08ccbd30.js"><link rel="prefetch" href="/assets/js/87.1d9976a5.js"><link rel="prefetch" href="/assets/js/88.4c2af5cc.js"><link rel="prefetch" href="/assets/js/89.be23dd95.js"><link rel="prefetch" href="/assets/js/9.448d01b4.js"><link rel="prefetch" href="/assets/js/90.bfe2cd95.js"><link rel="prefetch" href="/assets/js/91.c3c25fa1.js"><link rel="prefetch" href="/assets/js/92.043be796.js"><link rel="prefetch" href="/assets/js/93.59f34557.js"><link rel="prefetch" href="/assets/js/94.52822aff.js"><link rel="prefetch" href="/assets/js/95.a9490191.js"><link rel="prefetch" href="/assets/js/96.517f15b2.js"><link rel="prefetch" href="/assets/js/97.27be6b97.js"><link rel="prefetch" href="/assets/js/98.05e0ebd7.js"><link rel="prefetch" href="/assets/js/99.8b7ca3c5.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.3b3aacb0.js"> |
| <link rel="stylesheet" href="/assets/css/0.styles.1c0ab417.css"> |
| </head> |
| <body> |
| <div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/zh/" class="home-link router-link-active"><img src="/img/logo.png" alt=" " class="logo"></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">文档</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/zh/SystemDesign/Architecture/Architecture.html" class="nav-link">系统设计</a></div><div class="nav-item"><a href="/zh/Download/" class="nav-link">下载</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">社区</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external"> |
| Wiki |
| <!----></a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Project Committers.html" class="nav-link">开发人员</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Powered By.html" class="nav-link">技术支持</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| 基金会 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| 许可证 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| 安全 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| 赞助 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| 致谢 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| 活动 |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/V0.10.x/Client/Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/V0.10.x/Client/Programming - TsFile API.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link"> |
| gitHub |
| <svg xmlns="http://www.w3.org/2000/svg" aria-labelledby="outbound-link-title" role="img" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><title id="outbound-link-title">(opens new window)</title> <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></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">文档</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/Get Started/QuickStart.html" class="nav-link">In progress</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.10.x/Get Started/QuickStart.html" class="nav-link">V0.10.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.9.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.9.x</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.8.x/0-Get Started/1-QuickStart.html" class="nav-link">V0.8.x</a></li></ul></div></div><div class="nav-item"><a href="/zh/SystemDesign/Architecture/Architecture.html" class="nav-link">系统设计</a></div><div class="nav-item"><a href="/zh/Download/" class="nav-link">下载</a></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">社区</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://cwiki.apache.org/confluence/display/iotdb" class="nav-link external"> |
| Wiki |
| <!----></a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Project Committers.html" class="nav-link">开发人员</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Community-Powered By.html" class="nav-link">技术支持</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Materials.html" class="nav-link">活动与报告</a></li><li class="dropdown-item"><!----> <a href="/zh/Community/Feedback.html" class="nav-link">交流与反馈</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">开发</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/zh/Development/VoteRelease.html" class="nav-link">如何投票</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| 基金会 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| 许可证 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| 安全 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| 赞助 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| 致谢 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| 活动 |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/Master/V0.10.x/Client/Programming - TsFile API.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/Master/V0.10.x/Client/Programming - TsFile API.html" class="nav-link">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link"> |
| gitHub |
| <svg xmlns="http://www.w3.org/2000/svg" aria-labelledby="outbound-link-title" role="img" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><title id="outbound-link-title">(opens new window)</title> <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></a></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>IoTDB用户手册 (In progress)</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>开始</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>概述</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>概念</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>服务器端</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>客户端</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>操作指南</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>系统工具</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>生态集成</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>系统设计</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="tsfile-api"><a href="#tsfile-api" class="header-anchor">#</a> TsFile API</h1> <p>TsFile 是在 IoTDB 中使用的时间序列的文件格式。在这个章节中，我们将介绍这种文件格式的用法。</p> <h2 id="安装-tsfile-libaray"><a href="#安装-tsfile-libaray" class="header-anchor">#</a> 安装 TsFile libaray</h2> <p>在您自己的项目中有两种方法使用 TsFile .</p> <ul><li><p>使用 jar 包:</p> <ul><li><p>编译源码生成 jar 包</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/incubator-iotdb.git |
| cd tsfile/ |
| mvn clean package -Dmaven.test.skip=true |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><p>命令执行完成之后，所有的 jar 包都可以从 <code>target/</code> 目录下找到。之后您可以在自己的工程中倒入 <code>target/tsfile-0.10.1-jar-with-dependencies.jar</code>.</p></li></ul></li> <li><p>使用 Maven 依赖:</p> <p>编译源码并且部署到您的本地仓库中需要 3 步:</p> <ul><li><p>下载源码</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>git clone https://github.com/apache/incubator-iotdb.git |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>编译源码和部署到本地仓库</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>cd tsfile/ |
| mvn clean install -Dmaven.test.skip=true |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li> <li><p>在您自己的工程中增加依赖:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <dependency> |
| <groupId>org.apache.iotdb</groupId> |
| <artifactId>tsfile</artifactId> |
| <version>0.10.1</version> |
| </dependency> |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br></div></div></li></ul> <p>或者，您可以直接使用官方的 Maven 仓库:</p> <ul><li><p>首先，在<code>${username}\.m2\settings.xml</code>目录下的<code>settings.xml</code>文件中<code><profiles></code> |
| 节中增加<code><profile></code>，内容如下:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <profile> |
| <id>allow-snapshots</id> |
| <activation><activeByDefault>true</activeByDefault></activation> |
| <repositories> |
| <repository> |
| <id>apache.snapshots</id> |
| <name>Apache Development Snapshot Repository</name> |
| <url>https://repository.apache.org/content/repositories/snapshots/</url> |
| <releases> |
| <enabled>false</enabled> |
| </releases> |
| <snapshots> |
| <enabled>true</enabled> |
| </snapshots> |
| </repository> |
| </repositories> |
| </profile> |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br></div></div></li> <li><p>之后您可以在您的工程中增加如下依赖:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> <dependency> |
| <groupId>org.apache.iotdb</groupId> |
| <artifactId>tsfile</artifactId> |
| <version>0.10.1</version> |
| </dependency> |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br></div></div></li></ul></li></ul> <h2 id="tsfile-的使用"><a href="#tsfile-的使用" class="header-anchor">#</a> TSFile 的使用</h2> <p>本章节演示TsFile的详细用法。</p> <h3 id="时序数据-time-series-data"><a href="#时序数据-time-series-data" class="header-anchor">#</a> 时序数据(Time-series Data)</h3> <p>一个时序是由4个序列组成，分别是 device, measurement, time, value。</p> <ul><li><p><strong>measurement</strong>: 时间序列描述的是一个物理或者形式的测量(measurement)，比如：城市的温度，一些商品的销售数量或者是火车在不同时间的速度。 |
| 传统的传感器(如温度计)也采用单次测量(measurement)并产生时间序列，我们将在下面交替使用测量(measurement)和传感器。</p></li> <li><p><strong>device</strong>: 一个设备指的是一个正在进行多次测量(产生多个时间序列)的实体，例如， |
| 一列正在运行的火车监控它的速度、油表、它已经运行的英里数，当前的乘客每个都被传送到一个时间序列。</p></li></ul> <p>表1描述了一组时间序列数据。下表中显示的集合包含一个名为 "device_1" 的设备，它有三个测量值(measurement)分别是 |
| "sensor_1", "sensor_2" 和 "sensor_3".</p> <center><table style="text-align:center;"><tr><th colspan="6">device_1</th></tr> <tr><th colspan="2">sensor_1</th><th colspan="2">sensor_2</th><th colspan="2">sensor_3</th></tr> <tr><th>time</th><th>value</th><th>time</th><th>value</th><th>time</th><th>value</th></tr> <tr><td>1</td><td>1.2</td><td>1</td><td>20</td><td>2</td><td>50</td></tr> <tr><td>3</td><td>1.4</td><td>2</td><td>20</td><td>4</td><td>51</td></tr> <tr><td>5</td><td>1.1</td><td>3</td><td>21</td><td>6</td><td>52</td></tr> <tr><td>7</td><td>1.8</td><td>4</td><td>20</td><td>8</td><td>53</td></tr></table> <span>一组时间序列数据</span></center> <p><strong>单行数据</strong>: 在许多工业应用程序中，一个设备通常包含多个传感器，这些传感器可能同时具有多个值，这称为一行数据。</p> <p>在形式上，一行数据包含一个<code>device_id</code>，它是一个时间戳，表示从 1970年1月1日 00:00:00 开始的毫秒数, |
| 以及由<code>measurement_id</code>和相应的<code>value</code>组成的几个数据对。一行中的所有数据对都属于这个<code>device_id</code>，并且具有相同的时间戳。 |
| 如果其中一个度量值<code>measurements</code>在某个时间戳<code>timestamp</code>没有值<code>value</code>，将使用一个空格表示(实际上 TsFile 并不存储 null 值)。 |
| 其格式如下：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_id, timestamp, <measurement_id, value>... |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>示例数据如下所示。在本例中，两个度量值(measurement)的数据类型分别是<code>INT32</code>和<code>FLOAT</code>。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_1, 1490860659000, m1, 10, m2, 12.12 |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><h3 id="写入-tsfile"><a href="#写入-tsfile" class="header-anchor">#</a> 写入 TsFile</h3> <h4 id="生成一个-tsfile-文件"><a href="#生成一个-tsfile-文件" class="header-anchor">#</a> 生成一个 TsFile 文件</h4> <p>TsFile可以通过以下三个步骤生成，完整的代码参见"写入 TsFile 示例"章节。</p> <ul><li><p>首先，构造一个<code>TsFileWriter</code>实例。</p> <p>以下是可用的构造函数:</p> <ul><li>没有预定义 schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li>预定义 schema</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file, Schema schema) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>这个是用于使用 HDFS 文件系统的。<code>TsFileOutput</code>可以是<code>HDFSOutput</code>类的一个实例。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(TsFileOutput output, Schema schema) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>如果你想自己设置一些 TSFile 的配置，你可以使用<code>config</code>参数。比如:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig conf = new TSFileConfig(); |
| conf.setTSFileStorageFs("HDFS"); |
| TsFileWriter tsFileWriter = new TsFileWriter(file, schema, conf); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><p>在上面的例子中，数据文件将存储在 HDFS 中，而不是本地文件系统中。如果你想在本地文件系统中存储数据文件，你可以使用<code>conf.setTSFileStorageFs("LOCAL")</code>，这也是默认的配置。</p> <p>您还可以通过<code>config.setHdfsIp(...)</code>和<code>config.setHdfsPort(...)</code>来配置 HDFS 的 IP 和端口。默认的 IP是<code>localhost</code>，默认的端口是<code>9000</code>.</p> <p><strong>参数:</strong></p> <ul><li><p>file : 写入 TsFile 数据的文件</p></li> <li><p>schema : 文件的 schemas，将在下章进行介绍</p></li> <li><p>config : TsFile 的一些配置项</p></li></ul></li> <li><p>第二步，添加测量值(measurement)</p> <p>你也可以先创建一个<code>Schema</code>类的实例然后把它传递给<code>TsFileWriter</code>类的构造函数</p> <p><code>Schema</code>类保存的是一个映射关系，key 是一个 measurement 的名字，value 是 measurement schema.</p> <p>下面是一系列接口:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// Create an empty Schema or from an existing map |
| public Schema() |
| public Schema(Map<String, MeasurementSchema> measurements) |
| // Use this two interfaces to add measurements |
| public void registerMeasurement(MeasurementSchema descriptor) |
| public void registerMeasurements(Map<String, MeasurementSchema> measurements) |
| // Some useful getter and checker |
| public TSDataType getMeasurementDataType(String measurementId) |
| public MeasurementSchema getMeasurementSchema(String measurementId) |
| public Map<String, MeasurementSchema> getAllMeasurementSchema() |
| public boolean hasMeasurement(String measurementId) |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br></div></div><p>你可以在<code>TsFileWriter</code>类中使用以下接口来添加额外的测量(measurement): |
| </p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void addMeasurement(MeasurementSchema measurementSchema) throws WriteProcessException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><code>MeasurementSchema</code>类保存了一个测量(measurement)的信息，有几个构造函数:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding) |
| public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType) |
| public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType, |
| Map<String, String> props) |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br></div></div><p><strong>参数:</strong> |
| </p> <ul><li><p>measurementID: 测量的名称，通常是传感器的名称。</p></li> <li><p>type: 数据类型，现在支持六种类型: <code>BOOLEAN</code>, <code>INT32</code>, <code>INT64</code>, <code>FLOAT</code>, <code>DOUBLE</code>, <code>TEXT</code>;</p></li> <li><p>encoding: 编码类型. 参见 <a href="/zh/UserGuide/Master/V0.10.x/Concept/Encoding.html">Chapter 2-3</a>.</p></li> <li><p>compression: 压缩方式. 现在支持 <code>UNCOMPRESSED</code> 和 <code>SNAPPY</code>.</p></li> <li><p>props: 特殊数据类型的属性。比如说<code>FLOAT</code>和<code>DOUBLE</code>可以设置<code>max_point_number</code>，<code>TEXT</code>可以设置<code>max_string_length</code>。 |
| 可以使用Map来保存键值对，比如("max_point_number", "3")。</p></li></ul> <blockquote><p><strong>注意:</strong> 虽然一个测量(measurement)的名字可以被用在多个deltaObjects中, 但是它的参数是不允许被修改的。比如: |
| 不允许多次为同一个测量(measurement)名添加不同类型的编码。下面是一个错误示例:</p></blockquote> <div class="language- extra-class"><pre><code> // The measurement "sensor_1" is float type |
| addMeasurement(new MeasurementSchema("sensor_1", TSDataType.FLOAT, TSEncoding.RLE)); |
| |
| // This call will throw a WriteProcessException exception |
| addMeasurement(new MeasurementSchema("sensor_1", TSDataType.INT32, TSEncoding.RLE)); |
| </code></pre></div></li> <li><p>第三，插入和写入数据。</p> <p>使用这个接口创建一个新的<code>TSRecord</code>(时间戳和设备对)。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TSRecord(long timestamp, String deviceId) |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>然后创建一个<code>DataPoint</code>(度量(measurement)和值的对应)，并使用 addTuple 方法将数据 DataPoint 添加正确的值到 TsRecord。</p> <p>用下面这种方法写</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void write(TSRecord record) throws IOException, WriteProcessException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p>最后，调用<code>close</code>方法来完成写入过程。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void close() throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li></ul> <p>我们也支持将数据写入已关闭的 TsFile 文件中。</p> <ul><li>使用<code>ForceAppendTsFileWriter</code>打开已经关闭的文件。</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public ForceAppendTsFileWriter(File file) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li><p>调用 <code>doTruncate</code> 去掉文件的Metadata部分</p></li> <li><p>然后使用 <code>ForceAppendTsFileWriter</code> 构造另一个<code>TsFileWriter</code></p></li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(TsFileIOWriter fileWriter) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>请注意 此时需要重新添加测量值(measurement) 再进行上述写入操作。</p> <h4 id="写入-tsfile-示例"><a href="#写入-tsfile-示例" class="header-anchor">#</a> 写入 TsFile 示例</h4> <p>您需要安装 TsFile 到本地的 Maven 仓库中。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>mvn clean install -pl tsfile -am -DskipTests |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>如果存在<strong>非对齐</strong>的时序数据(比如：不是所有的传感器都有值)，您可以通过构造<strong>TSRecord</strong>来写入。</p> <p>更详细的例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithTSRecord.java</code>中查看</p> <p>如果所有时序数据都是<strong>对齐</strong>的，您可以通过构造<strong>Tablet</strong>来写入数据。</p> <p>更详细的例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileWriteWithTablet.java</code>中查看</p> <p>在已关闭的TsFile 文件中写入新数据的详细例子可以在<code>/example/tsfile/src/main/java/org/apache/iotdb/tsfile/TsFileForceAppendWrite.java</code>中查看</p> <h3 id="读取-tsfile-接口"><a href="#读取-tsfile-接口" class="header-anchor">#</a> 读取 TsFile 接口</h3> <h4 id="开始之前"><a href="#开始之前" class="header-anchor">#</a> 开始之前</h4> <p>"时序数据"章节中的数据集在本章节做具体的介绍。下表中显示的集合包含一个名为"device_1"的 deltaObject，包含了 3 个名为"sensor_1","sensor_2"和"sensor_3"的测量(measurement)。 |
| 测量值被简化成一个简单的例子，每条数据只包含 4 条时间和值的对应数据。</p> <center><table style="text-align:center;"><tr><th colspan="6">device_1</th></tr> <tr><th colspan="2">sensor_1</th><th colspan="2">sensor_2</th><th colspan="2">sensor_3</th></tr> <tr><th>time</th><th>value</th><th>time</th><th>value</th><th>time</th><th>value</th></tr> <tr><td>1</td><td>1.2</td><td>1</td><td>20</td><td>2</td><td>50</td></tr> <tr><td>3</td><td>1.4</td><td>2</td><td>20</td><td>4</td><td>51</td></tr> <tr><td>5</td><td>1.1</td><td>3</td><td>21</td><td>6</td><td>52</td></tr> <tr><td>7</td><td>1.8</td><td>4</td><td>20</td><td>8</td><td>53</td></tr></table> <span>一组时间序列数据</span></center> <h4 id="路径的定义"><a href="#路径的定义" class="header-anchor">#</a> 路径的定义</h4> <p>路径是一个点(.)分隔的字符串，它唯一地标识 TsFile 中的时间序列，例如："root.area_1.device_1.sensor_1"。 |
| 最后一部分"sensor_1"称为"measurementId"，其余部分"root.area_1.device_1"称为deviceId。 |
| 正如之前提到的，不同设备中的相同测量(measurement)具有相同的数据类型和编码，设备也是唯一的。</p> <p>在read接口中，参数<code>paths</code>表示要选择的测量值(measurement)。 |
| Path实例可以很容易地通过类<code>Path</code>来构造。例如:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>Path p = new Path("device_1.sensor_1"); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>我们可以为查询传递一个 ArrayList 路径，以支持多个路径查询。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>List<Path> paths = new ArrayList<Path>(); |
| paths.add(new Path("device_1.sensor_1")); |
| paths.add(new Path("device_1.sensor_3")); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><blockquote><p><strong>注意:</strong> 在构造路径时，参数的格式应该是一个点(.)分隔的字符串，最后一部分是measurement，其余部分确认为deviceId。</p></blockquote> <h4 id="定义-filter"><a href="#定义-filter" class="header-anchor">#</a> 定义 Filter</h4> <h5 id="使用条件过滤"><a href="#使用条件过滤" class="header-anchor">#</a> 使用条件过滤</h5> <p>在 TsFile 读取过程中使用 Filter 来选择满足一个或多个给定条件的数据。</p> <h4 id="iexpression"><a href="#iexpression" class="header-anchor">#</a> IExpression</h4> <p><code>IExpression</code>是一个过滤器表达式接口，它将被传递给系统查询时调用。 |
| 我们创建一个或多个筛选器表达式，并且可以使用<code>Binary Filter Operators</code>将它们连接形成最终表达式。</p> <ul><li><p><strong>创建一个Filter表达式</strong></p> <p>有两种类型的过滤器。</p> <ul><li><p>TimeFilter: 使用时序数据中的<code>time</code>过滤。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>使用以下关系获得一个<code>TimeFilter</code>对象(值是一个 long 型变量)。 |
| <center><table style="text-align:center;"><tr><th>Relationship</th><th>Description</th></tr> <tr><td>TimeFilter.eq(value)</td><td>选择时间等于值的数据</td></tr> <tr><td>TimeFilter.lt(value)</td><td>选择时间小于值的数据</td></tr> <tr><td>TimeFilter.gt(value)</td><td>选择时间大于值的数据</td></tr> <tr><td>TimeFilter.ltEq(value)</td><td>选择时间小于等于值的数据</td></tr> <tr><td>TimeFilter.gtEq(value)</td><td>选择时间大于等于值的数据</td></tr> <tr><td>TimeFilter.notEq(value)</td><td>选择时间不等于值的数据</td></tr> <tr><td>TimeFilter.not(TimeFilter)</td><td>选择时间不满足另一个时间过滤器的数据</td></tr></table></center></p></li> <li><p>ValueFilter: 使用时序数据中的<code>value</code>过滤。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression valueFilterExpr = new SingleSeriesExpression(Path, ValueFilter); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><code>ValueFilter</code>的用法与<code>TimeFilter</code>相同，只是需要确保值的类型等于measurement(在路径中定义)的类型。</p></li></ul></li> <li><p><strong>Binary Filter Operators</strong></p> <p>Binary filter operators 可以用来连接两个单独的表达式。</p> <ul><li>BinaryExpression.and(Expression, Expression): 选择同时满足两个表达式的数据。</li> <li>BinaryExpression.or(Expression, Expression): 选择满足任意一个表达式值的数据。</li></ul></li></ul> <h5 id="filter-expression-示例"><a href="#filter-expression-示例" class="header-anchor">#</a> Filter Expression 示例</h5> <ul><li><p><strong>TimeFilterExpression 示例</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.eq(15)); // series time = 15 |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.ltEq(15)); // series time <= 15 |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.lt(15)); // series time < 15 |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.gtEq(15)); // series time >= 15 |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = new GlobalTimeExpression(TimeFilter.notEq(15)); // series time != 15 |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = BinaryExpression.and(new GlobalTimeExpression(TimeFilter.gtEq(15L)), |
| new GlobalTimeExpression(TimeFilter.lt(25L))); // 15 <= series time < 25 |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><div class="language- line-numbers-mode"><pre class="language-text"><code>IExpression timeFilterExpr = BinaryExpression.or(new GlobalTimeExpression(TimeFilter.gtEq(15L)), |
| new GlobalTimeExpression(TimeFilter.lt(25L))); // series time >= 15 or series time < 25 |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li></ul> <h4 id="读取接口"><a href="#读取接口" class="header-anchor">#</a> 读取接口</h4> <p>首先，我们打开 TsFile 并从文件路径<code>path</code>中获取一个<code>ReadOnlyTsFile</code>实例。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TsFileSequenceReader reader = new TsFileSequenceReader(path); |
| |
| ReadOnlyTsFile readTsFile = new ReadOnlyTsFile(reader); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><p>接下来，我们准备路径数组和查询表达式，然后通过这个接口得到最终的<code>QueryExpression</code>对象:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>QueryExpression queryExpression = QueryExpression.create(paths, statement); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>ReadOnlyTsFile类有两个<code>query</code>方法来执行查询。</p> <ul><li><p><strong>Method 1</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p><strong>Method 2</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression, long partitionStartOffset, long partitionEndOffset) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>此方法是为高级应用(如 TsFile-Spark 连接器)设计的。</p> <ul><li><strong>参数</strong> : 对于 method 2，添加了两个额外的参数来支持部分查询(Partial Query): |
| <ul><li><code>partitionStartOffset</code>: TsFile 的开始偏移量</li> <li><code>partitionEndOffset</code>: TsFile 的结束偏移量 |
| </li></ul> <blockquote><p><strong>什么是部分查询?</strong></p> <p>在一些分布式文件系统中(比如：HDFS), 文件被分成几个部分，这些部分被称为"Blocks"并存储在不同的节点中。在涉及的每个节点上并行执行查询可以提高效率。因此需要部分查询(Partial Query)。部分查询(Partial Query)仅支持查询 TsFile 中被<code>QueryConstant.PARTITION_START_OFFSET</code>和<code>QueryConstant.PARTITION_END_OFFSET</code>分割的部分。</p></blockquote></li></ul></li></ul> <h3 id="querydataset-接口"><a href="#querydataset-接口" class="header-anchor">#</a> QueryDataset 接口</h3> <p>上面执行的查询将返回一个<code>QueryDataset</code>对象。</p> <p>下面是一些用户常用的接口：</p> <ul><li><p><code>bool hasNext();</code></p> <p>如果该数据集仍然有数据，则返回true。</p></li> <li><p><code>List<Path> getPaths()</code></p> <p>获取这个数据集中的路径。</p></li> <li><p><code>List<TSDataType> getDataTypes();</code></p> <p>获取数据类型。TSDataType 是一个 enum 类，其值如下:</p> <div class="language- extra-class"><pre><code> BOOLEAN, |
| INT32, |
| INT64, |
| FLOAT, |
| DOUBLE, |
| TEXT; |
| </code></pre></div></li> <li><p><code>RowRecord next() throws IOException;</code></p> <p>获取下一条记录。</p> <p><code>RowRecord</code>类包含一个<code>long</code>类型的时间戳和一个<code>List<Field></code>，用于不同传感器中的数据，我们可以使用两个getter方法来获取它们。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>long getTimestamp(); |
| List<Field> getFields(); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div><p>要从一个字段获取数据，请使用以下方法:</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSDataType getDataType(); |
| Object getObjectValue(); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></li></ul> <h4 id="读取现有-tsfile-示例"><a href="#读取现有-tsfile-示例" class="header-anchor">#</a> 读取现有 TsFile 示例</h4> <p>您需要安装 TsFile 到本地的 Maven 仓库中。</p> <p>有关查询语句的更详细示例，请参见 |
| <code>/tsfile/example/src/main/java/org/apache/iotdb/tsfile/TsFileRead.java</code></p> <div class="language-java line-numbers-mode"><pre class="language-java"><code><span class="token keyword">package</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>io<span class="token punctuation">.</span></span><span class="token class-name">IOException</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">java<span class="token punctuation">.</span>util<span class="token punctuation">.</span></span><span class="token class-name">ArrayList</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span></span><span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>common<span class="token punctuation">.</span></span><span class="token class-name">Path</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">IExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span></span><span class="token class-name">QueryExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">BinaryExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">GlobalTimeExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>expression<span class="token punctuation">.</span>impl<span class="token punctuation">.</span></span><span class="token class-name">SingleSeriesExpression</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">TimeFilter</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>filter<span class="token punctuation">.</span></span><span class="token class-name">ValueFilter</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>read<span class="token punctuation">.</span>query<span class="token punctuation">.</span>dataset<span class="token punctuation">.</span></span><span class="token class-name">QueryDataSet</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">/** |
| * The class is to show how to read TsFile file named "test.tsfile". |
| * The TsFile file "test.tsfile" is generated from class TsFileWrite. |
| * Run TsFileWrite to generate the test.tsfile first |
| */</span> |
| <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileRead</span> <span class="token punctuation">{</span> |
| <span class="token keyword">private</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">queryAndPrint</span><span class="token punctuation">(</span><span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">Path</span><span class="token punctuation">></span></span> paths<span class="token punctuation">,</span> <span class="token class-name">ReadOnlyTsFile</span> readTsFile<span class="token punctuation">,</span> <span class="token class-name">IExpression</span> statement<span class="token punctuation">)</span> |
| <span class="token keyword">throws</span> <span class="token class-name">IOException</span> <span class="token punctuation">{</span> |
| <span class="token class-name">QueryExpression</span> queryExpression <span class="token operator">=</span> <span class="token class-name">QueryExpression</span><span class="token punctuation">.</span><span class="token function">create</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> statement<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">QueryDataSet</span> queryDataSet <span class="token operator">=</span> readTsFile<span class="token punctuation">.</span><span class="token function">query</span><span class="token punctuation">(</span>queryExpression<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token keyword">while</span> <span class="token punctuation">(</span>queryDataSet<span class="token punctuation">.</span><span class="token function">hasNext</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> |
| <span class="token class-name">System</span><span class="token punctuation">.</span>out<span class="token punctuation">.</span><span class="token function">println</span><span class="token punctuation">(</span>queryDataSet<span class="token punctuation">.</span><span class="token function">next</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token class-name">System</span><span class="token punctuation">.</span>out<span class="token punctuation">.</span><span class="token function">println</span><span class="token punctuation">(</span><span class="token string">"------------"</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| |
| <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">main</span><span class="token punctuation">(</span><span class="token class-name">String</span><span class="token punctuation">[</span><span class="token punctuation">]</span> args<span class="token punctuation">)</span> <span class="token keyword">throws</span> <span class="token class-name">IOException</span> <span class="token punctuation">{</span> |
| |
| <span class="token comment">// file path</span> |
| <span class="token class-name">String</span> path <span class="token operator">=</span> <span class="token string">"test.tsfile"</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// create reader and get the readTsFile interface</span> |
| <span class="token class-name">TsFileSequenceReader</span> reader <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">ReadOnlyTsFile</span> readTsFile <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">(</span>reader<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token comment">// use these paths(all sensors) for all the queries</span> |
| <span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</span><span class="token class-name">Path</span><span class="token punctuation">></span></span> paths <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</span><span class="token punctuation">></span></span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">"device_1.sensor_1"</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">"device_1.sensor_2"</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| paths<span class="token punctuation">.</span><span class="token function">add</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">Path</span><span class="token punctuation">(</span><span class="token string">"device_1.sensor_3"</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// no query statement</span> |
| <span class="token function">queryAndPrint</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> readTsFile<span class="token punctuation">,</span> <span class="token keyword">null</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">//close the reader when you left</span> |
| reader<span class="token punctuation">.</span><span class="token function">close</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br></div></div><h2 id="修改-tsfile-配置项"><a href="#修改-tsfile-配置项" class="header-anchor">#</a> 修改 TsFile 配置项</h2> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig config = TSFileDescriptor.getInstance().getConfig(); |
| config.setXXX(); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br></div></div></div> <!----> <p style="text-align: center;">Copyright © 2020 The Apache Software Foundation.<br> |
| Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p></main></div><div class="global-ui"></div></div> |
| <script src="/assets/js/app.a43d7cd0.js" defer></script><script src="/assets/js/3.6210d98e.js" defer></script><script src="/assets/js/374.0e15cf2e.js" defer></script> |
| </body> |
| </html> |
