| <!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.5.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.47c4181e.css" as="style"><link rel="preload" href="/assets/js/app.882d9a07.js" as="script"><link rel="preload" href="/assets/js/3.1dc302ea.js" as="script"><link rel="preload" href="/assets/js/287.7b650265.js" as="script"><link rel="prefetch" href="/assets/js/10.df7ec35f.js"><link rel="prefetch" href="/assets/js/100.46f902a0.js"><link rel="prefetch" href="/assets/js/101.ba2c5257.js"><link rel="prefetch" href="/assets/js/102.8cfa62ff.js"><link rel="prefetch" href="/assets/js/103.ce6083bd.js"><link rel="prefetch" href="/assets/js/104.2c7e306e.js"><link rel="prefetch" href="/assets/js/105.659f7d7c.js"><link rel="prefetch" href="/assets/js/106.44f523c6.js"><link rel="prefetch" href="/assets/js/107.aabb4e24.js"><link rel="prefetch" href="/assets/js/108.0b847ccb.js"><link rel="prefetch" href="/assets/js/109.0ecdc3e8.js"><link rel="prefetch" href="/assets/js/11.a86e49df.js"><link rel="prefetch" href="/assets/js/110.5cb485d3.js"><link rel="prefetch" href="/assets/js/111.f84f011d.js"><link rel="prefetch" href="/assets/js/112.d91219bd.js"><link rel="prefetch" href="/assets/js/113.802ff697.js"><link rel="prefetch" href="/assets/js/114.4dfa6fa4.js"><link rel="prefetch" href="/assets/js/115.3b84b03c.js"><link rel="prefetch" href="/assets/js/116.95c8cffd.js"><link rel="prefetch" href="/assets/js/117.75446827.js"><link rel="prefetch" href="/assets/js/118.97f15742.js"><link rel="prefetch" href="/assets/js/119.b6069f00.js"><link rel="prefetch" href="/assets/js/12.97a469f4.js"><link rel="prefetch" href="/assets/js/120.de4776ca.js"><link rel="prefetch" href="/assets/js/121.86b44edd.js"><link rel="prefetch" href="/assets/js/122.793976e9.js"><link rel="prefetch" href="/assets/js/123.138a7ccb.js"><link rel="prefetch" href="/assets/js/124.16a35af8.js"><link rel="prefetch" href="/assets/js/125.c481e922.js"><link rel="prefetch" href="/assets/js/126.fb82ff27.js"><link rel="prefetch" href="/assets/js/127.17ab45fd.js"><link rel="prefetch" href="/assets/js/128.9656b085.js"><link rel="prefetch" href="/assets/js/129.0aa7aabb.js"><link rel="prefetch" href="/assets/js/13.ca512a7d.js"><link rel="prefetch" href="/assets/js/130.7d14bd29.js"><link rel="prefetch" href="/assets/js/131.e71f08bd.js"><link rel="prefetch" href="/assets/js/132.6ea6cdf1.js"><link rel="prefetch" href="/assets/js/133.a388baa8.js"><link rel="prefetch" href="/assets/js/134.54d48b3d.js"><link rel="prefetch" href="/assets/js/135.7a128f8f.js"><link rel="prefetch" href="/assets/js/136.00a01734.js"><link rel="prefetch" href="/assets/js/137.aa593fc2.js"><link rel="prefetch" href="/assets/js/138.31960a86.js"><link rel="prefetch" href="/assets/js/139.562e6302.js"><link rel="prefetch" href="/assets/js/14.f91f7aa3.js"><link rel="prefetch" href="/assets/js/140.5f453876.js"><link rel="prefetch" href="/assets/js/141.b32d4af3.js"><link rel="prefetch" href="/assets/js/142.585e2900.js"><link rel="prefetch" href="/assets/js/143.1deb8b59.js"><link rel="prefetch" href="/assets/js/144.e98c9234.js"><link rel="prefetch" href="/assets/js/145.69e3d8ba.js"><link rel="prefetch" href="/assets/js/146.854ca873.js"><link rel="prefetch" href="/assets/js/147.ce852530.js"><link rel="prefetch" href="/assets/js/148.4df7ad54.js"><link rel="prefetch" href="/assets/js/149.5885680e.js"><link rel="prefetch" href="/assets/js/15.35ce02ea.js"><link rel="prefetch" href="/assets/js/150.e77a1752.js"><link rel="prefetch" href="/assets/js/151.e256e236.js"><link rel="prefetch" href="/assets/js/152.2269a9f4.js"><link rel="prefetch" href="/assets/js/153.67177abf.js"><link rel="prefetch" href="/assets/js/154.4b8625b0.js"><link rel="prefetch" href="/assets/js/155.84ff10ab.js"><link rel="prefetch" href="/assets/js/156.bbce15cb.js"><link rel="prefetch" href="/assets/js/157.3b84194d.js"><link rel="prefetch" href="/assets/js/158.1fc4f128.js"><link rel="prefetch" href="/assets/js/159.e74da70a.js"><link rel="prefetch" href="/assets/js/16.d053c0dc.js"><link rel="prefetch" href="/assets/js/160.5757746b.js"><link rel="prefetch" href="/assets/js/161.0956a685.js"><link rel="prefetch" href="/assets/js/162.7bdbb2e8.js"><link rel="prefetch" href="/assets/js/163.caae3dd0.js"><link rel="prefetch" href="/assets/js/164.3d527296.js"><link rel="prefetch" href="/assets/js/165.9e2592b0.js"><link rel="prefetch" href="/assets/js/166.936aefc2.js"><link rel="prefetch" href="/assets/js/167.b715a39c.js"><link rel="prefetch" href="/assets/js/168.21c20463.js"><link rel="prefetch" href="/assets/js/169.0cea4d63.js"><link rel="prefetch" href="/assets/js/17.54956aa7.js"><link rel="prefetch" href="/assets/js/170.99755400.js"><link rel="prefetch" href="/assets/js/171.a503fe92.js"><link rel="prefetch" href="/assets/js/172.b62ff159.js"><link rel="prefetch" href="/assets/js/173.ad699d64.js"><link rel="prefetch" href="/assets/js/174.12971908.js"><link rel="prefetch" href="/assets/js/175.d260a942.js"><link rel="prefetch" href="/assets/js/176.15310578.js"><link rel="prefetch" href="/assets/js/177.dca59880.js"><link rel="prefetch" href="/assets/js/178.762b5655.js"><link rel="prefetch" href="/assets/js/179.8a2150fa.js"><link rel="prefetch" href="/assets/js/18.0e32b1ca.js"><link rel="prefetch" href="/assets/js/180.812eff50.js"><link rel="prefetch" href="/assets/js/181.25741a4f.js"><link rel="prefetch" href="/assets/js/182.be1ead30.js"><link rel="prefetch" href="/assets/js/183.65da99ac.js"><link rel="prefetch" href="/assets/js/184.19aa7b39.js"><link rel="prefetch" href="/assets/js/185.3b47818d.js"><link rel="prefetch" href="/assets/js/186.f17445b2.js"><link rel="prefetch" href="/assets/js/187.5ffa8fb7.js"><link rel="prefetch" href="/assets/js/188.985b2930.js"><link rel="prefetch" href="/assets/js/189.8a086656.js"><link rel="prefetch" href="/assets/js/19.e1031edc.js"><link rel="prefetch" href="/assets/js/190.e1795abc.js"><link rel="prefetch" href="/assets/js/191.ef63b7c9.js"><link rel="prefetch" href="/assets/js/192.9b54e8a1.js"><link rel="prefetch" href="/assets/js/193.b7730945.js"><link rel="prefetch" href="/assets/js/194.bdfd3b2a.js"><link rel="prefetch" href="/assets/js/195.a49577ce.js"><link rel="prefetch" href="/assets/js/196.d7d6ea08.js"><link rel="prefetch" href="/assets/js/197.0038edae.js"><link rel="prefetch" href="/assets/js/198.2b7feb5b.js"><link rel="prefetch" href="/assets/js/199.246f826f.js"><link rel="prefetch" href="/assets/js/20.6630eb9b.js"><link rel="prefetch" href="/assets/js/200.7dd47538.js"><link rel="prefetch" href="/assets/js/201.b9f3f3ba.js"><link rel="prefetch" href="/assets/js/202.88580a02.js"><link rel="prefetch" href="/assets/js/203.dc19a146.js"><link rel="prefetch" href="/assets/js/204.3ae4039b.js"><link rel="prefetch" href="/assets/js/205.11713f93.js"><link rel="prefetch" href="/assets/js/206.5009f186.js"><link rel="prefetch" href="/assets/js/207.02d308ce.js"><link rel="prefetch" href="/assets/js/208.e0d30f83.js"><link rel="prefetch" href="/assets/js/209.a189a8f5.js"><link rel="prefetch" href="/assets/js/21.6ba053c1.js"><link rel="prefetch" href="/assets/js/210.0ab50f1b.js"><link rel="prefetch" href="/assets/js/211.ba454b99.js"><link rel="prefetch" href="/assets/js/212.5ab320e9.js"><link rel="prefetch" href="/assets/js/213.0290b30c.js"><link rel="prefetch" href="/assets/js/214.05b80625.js"><link rel="prefetch" href="/assets/js/215.69f82d6d.js"><link rel="prefetch" href="/assets/js/216.ab905448.js"><link rel="prefetch" href="/assets/js/217.bde06399.js"><link rel="prefetch" href="/assets/js/218.c3d46cb2.js"><link rel="prefetch" href="/assets/js/219.cf09aab1.js"><link rel="prefetch" href="/assets/js/22.2cc6e418.js"><link rel="prefetch" href="/assets/js/220.acfa6385.js"><link rel="prefetch" href="/assets/js/221.85cade19.js"><link rel="prefetch" href="/assets/js/222.138988e9.js"><link rel="prefetch" href="/assets/js/223.33eb46d4.js"><link rel="prefetch" href="/assets/js/224.5b505a1a.js"><link rel="prefetch" href="/assets/js/225.a00c337a.js"><link rel="prefetch" href="/assets/js/226.40b7642d.js"><link rel="prefetch" href="/assets/js/227.5855e16b.js"><link rel="prefetch" href="/assets/js/228.510e8061.js"><link rel="prefetch" href="/assets/js/229.6c905504.js"><link rel="prefetch" href="/assets/js/23.44b5e587.js"><link rel="prefetch" href="/assets/js/230.80eec0cb.js"><link rel="prefetch" href="/assets/js/231.5353f9c0.js"><link rel="prefetch" href="/assets/js/232.7caab4ae.js"><link rel="prefetch" href="/assets/js/233.429eb9ac.js"><link rel="prefetch" href="/assets/js/234.92daf6aa.js"><link rel="prefetch" href="/assets/js/235.4f96a6d2.js"><link rel="prefetch" href="/assets/js/236.f6d1fcf4.js"><link rel="prefetch" href="/assets/js/237.c81eb221.js"><link rel="prefetch" href="/assets/js/238.4d0eb5a6.js"><link rel="prefetch" href="/assets/js/239.b5fea603.js"><link rel="prefetch" href="/assets/js/24.22d894b5.js"><link rel="prefetch" href="/assets/js/240.4b907e8d.js"><link rel="prefetch" href="/assets/js/241.509179a2.js"><link rel="prefetch" href="/assets/js/242.6204b29f.js"><link rel="prefetch" href="/assets/js/243.6557eaac.js"><link rel="prefetch" href="/assets/js/244.00ba8687.js"><link rel="prefetch" href="/assets/js/245.2bccaee6.js"><link rel="prefetch" href="/assets/js/246.f450dac3.js"><link rel="prefetch" href="/assets/js/247.f8bded05.js"><link rel="prefetch" href="/assets/js/248.079a3425.js"><link rel="prefetch" href="/assets/js/249.67bc3845.js"><link rel="prefetch" href="/assets/js/25.de046fce.js"><link rel="prefetch" href="/assets/js/250.205203eb.js"><link rel="prefetch" href="/assets/js/251.c02b55cc.js"><link rel="prefetch" href="/assets/js/252.4672e689.js"><link rel="prefetch" href="/assets/js/253.eb0e0af8.js"><link rel="prefetch" href="/assets/js/254.a4560c5d.js"><link rel="prefetch" href="/assets/js/255.7da81997.js"><link rel="prefetch" href="/assets/js/256.12d8ab80.js"><link rel="prefetch" href="/assets/js/257.f75acca0.js"><link rel="prefetch" href="/assets/js/258.e5a6c8e4.js"><link rel="prefetch" href="/assets/js/259.3ffb6bec.js"><link rel="prefetch" href="/assets/js/26.22388c67.js"><link rel="prefetch" href="/assets/js/260.67eed8b3.js"><link rel="prefetch" href="/assets/js/261.6f75c141.js"><link rel="prefetch" href="/assets/js/262.2931901b.js"><link rel="prefetch" href="/assets/js/263.16ee64cc.js"><link rel="prefetch" href="/assets/js/264.cd60d20b.js"><link rel="prefetch" href="/assets/js/265.77c31e29.js"><link rel="prefetch" href="/assets/js/266.a79ab7b3.js"><link rel="prefetch" href="/assets/js/267.1c871665.js"><link rel="prefetch" href="/assets/js/268.6b7edb39.js"><link rel="prefetch" href="/assets/js/269.623f7925.js"><link rel="prefetch" href="/assets/js/27.1092da6f.js"><link rel="prefetch" href="/assets/js/270.1588dc7e.js"><link rel="prefetch" href="/assets/js/271.9d8c84d1.js"><link rel="prefetch" href="/assets/js/272.62691b38.js"><link rel="prefetch" href="/assets/js/273.9edcbfec.js"><link rel="prefetch" href="/assets/js/274.adab5090.js"><link rel="prefetch" href="/assets/js/275.5d464f4c.js"><link rel="prefetch" href="/assets/js/276.56bc4fb1.js"><link rel="prefetch" href="/assets/js/277.560abb1e.js"><link rel="prefetch" href="/assets/js/278.200f23dd.js"><link rel="prefetch" href="/assets/js/279.85bb2707.js"><link rel="prefetch" href="/assets/js/28.6ac8124e.js"><link rel="prefetch" href="/assets/js/280.78cd815f.js"><link rel="prefetch" href="/assets/js/281.301cd53d.js"><link rel="prefetch" href="/assets/js/282.0efd5adf.js"><link rel="prefetch" href="/assets/js/283.cc93d532.js"><link rel="prefetch" href="/assets/js/284.813a0148.js"><link rel="prefetch" href="/assets/js/285.64d647b3.js"><link rel="prefetch" href="/assets/js/286.f08aee76.js"><link rel="prefetch" href="/assets/js/288.987b1a1a.js"><link rel="prefetch" href="/assets/js/289.0a539872.js"><link rel="prefetch" href="/assets/js/29.066202c5.js"><link rel="prefetch" href="/assets/js/290.29960eb5.js"><link rel="prefetch" href="/assets/js/291.4e4d9067.js"><link rel="prefetch" href="/assets/js/292.12a67deb.js"><link rel="prefetch" href="/assets/js/293.40828f6a.js"><link rel="prefetch" href="/assets/js/294.fdd0a014.js"><link rel="prefetch" href="/assets/js/295.f9f2d91c.js"><link rel="prefetch" href="/assets/js/296.e8663dd1.js"><link rel="prefetch" href="/assets/js/297.fb8a6d71.js"><link rel="prefetch" href="/assets/js/298.caf7b822.js"><link rel="prefetch" href="/assets/js/299.6a130c21.js"><link rel="prefetch" href="/assets/js/30.f001d2e0.js"><link rel="prefetch" href="/assets/js/300.01e0caa1.js"><link rel="prefetch" href="/assets/js/301.f32807cc.js"><link rel="prefetch" href="/assets/js/302.779651c3.js"><link rel="prefetch" href="/assets/js/303.3bdd3fe3.js"><link rel="prefetch" href="/assets/js/304.f0f81199.js"><link rel="prefetch" href="/assets/js/305.193ac400.js"><link rel="prefetch" href="/assets/js/306.bdbfc571.js"><link rel="prefetch" href="/assets/js/307.e5ac5443.js"><link rel="prefetch" href="/assets/js/308.104d4362.js"><link rel="prefetch" href="/assets/js/309.93ff7c1d.js"><link rel="prefetch" href="/assets/js/31.51ef7648.js"><link rel="prefetch" href="/assets/js/310.a6f56aee.js"><link rel="prefetch" href="/assets/js/311.5bb6779a.js"><link rel="prefetch" href="/assets/js/312.d1f1032f.js"><link rel="prefetch" href="/assets/js/313.d5d7bcf5.js"><link rel="prefetch" href="/assets/js/314.6220e3b0.js"><link rel="prefetch" href="/assets/js/315.989f9c3b.js"><link rel="prefetch" href="/assets/js/316.5c6be00c.js"><link rel="prefetch" href="/assets/js/317.5f443eed.js"><link rel="prefetch" href="/assets/js/318.bc72ddf9.js"><link rel="prefetch" href="/assets/js/319.5d9d8194.js"><link rel="prefetch" href="/assets/js/32.7dba92e8.js"><link rel="prefetch" href="/assets/js/320.aee2114d.js"><link rel="prefetch" href="/assets/js/321.de477b38.js"><link rel="prefetch" href="/assets/js/322.aa9d4016.js"><link rel="prefetch" href="/assets/js/323.178065b6.js"><link rel="prefetch" href="/assets/js/324.51fb6a96.js"><link rel="prefetch" href="/assets/js/325.1d301881.js"><link rel="prefetch" href="/assets/js/326.42161b0a.js"><link rel="prefetch" href="/assets/js/327.28ab6252.js"><link rel="prefetch" href="/assets/js/328.f7cc4627.js"><link rel="prefetch" href="/assets/js/329.b5e1d8d1.js"><link rel="prefetch" href="/assets/js/33.38edc1ca.js"><link rel="prefetch" href="/assets/js/330.110568ed.js"><link rel="prefetch" href="/assets/js/331.e357336a.js"><link rel="prefetch" href="/assets/js/332.7246ff9a.js"><link rel="prefetch" href="/assets/js/34.09d75d60.js"><link rel="prefetch" href="/assets/js/35.28f77cc1.js"><link rel="prefetch" href="/assets/js/36.170a378d.js"><link rel="prefetch" href="/assets/js/37.8a712480.js"><link rel="prefetch" href="/assets/js/38.7ed5f5d7.js"><link rel="prefetch" href="/assets/js/39.9e375df7.js"><link rel="prefetch" href="/assets/js/4.cfbdbe89.js"><link rel="prefetch" href="/assets/js/40.ca86458f.js"><link rel="prefetch" href="/assets/js/41.0a8911c5.js"><link rel="prefetch" href="/assets/js/42.1f807061.js"><link rel="prefetch" href="/assets/js/43.2ef6f503.js"><link rel="prefetch" href="/assets/js/44.5e2c4992.js"><link rel="prefetch" href="/assets/js/45.90038f5d.js"><link rel="prefetch" href="/assets/js/46.b5efd5cf.js"><link rel="prefetch" href="/assets/js/47.0aa5076d.js"><link rel="prefetch" href="/assets/js/48.b5d02afd.js"><link rel="prefetch" href="/assets/js/49.f9d012fd.js"><link rel="prefetch" href="/assets/js/5.f601e2c6.js"><link rel="prefetch" href="/assets/js/50.63eccc09.js"><link rel="prefetch" href="/assets/js/51.53cfc462.js"><link rel="prefetch" href="/assets/js/52.e9807f0e.js"><link rel="prefetch" href="/assets/js/53.cb7ce425.js"><link rel="prefetch" href="/assets/js/54.b808d48c.js"><link rel="prefetch" href="/assets/js/55.f9ab930d.js"><link rel="prefetch" href="/assets/js/56.4ef6b77e.js"><link rel="prefetch" href="/assets/js/57.ec93b220.js"><link rel="prefetch" href="/assets/js/58.8e78043b.js"><link rel="prefetch" href="/assets/js/59.33e79866.js"><link rel="prefetch" href="/assets/js/6.4e244a8f.js"><link rel="prefetch" href="/assets/js/60.416039d7.js"><link rel="prefetch" href="/assets/js/61.31256bc1.js"><link rel="prefetch" href="/assets/js/62.4dd632ab.js"><link rel="prefetch" href="/assets/js/63.d3f67d18.js"><link rel="prefetch" href="/assets/js/64.d7e3c018.js"><link rel="prefetch" href="/assets/js/65.ba0437da.js"><link rel="prefetch" href="/assets/js/66.fbe062c4.js"><link rel="prefetch" href="/assets/js/67.8b6f0f48.js"><link rel="prefetch" href="/assets/js/68.4864757c.js"><link rel="prefetch" href="/assets/js/69.0adf4b5e.js"><link rel="prefetch" href="/assets/js/7.69014dd1.js"><link rel="prefetch" href="/assets/js/70.95a01842.js"><link rel="prefetch" href="/assets/js/71.ce3fd007.js"><link rel="prefetch" href="/assets/js/72.69b7729a.js"><link rel="prefetch" href="/assets/js/73.9ae8e1ec.js"><link rel="prefetch" href="/assets/js/74.0476bee6.js"><link rel="prefetch" href="/assets/js/75.b72d48e3.js"><link rel="prefetch" href="/assets/js/76.e914a404.js"><link rel="prefetch" href="/assets/js/77.97d4a82e.js"><link rel="prefetch" href="/assets/js/78.0ccf8bcf.js"><link rel="prefetch" href="/assets/js/79.aac64bb1.js"><link rel="prefetch" href="/assets/js/8.61bc0899.js"><link rel="prefetch" href="/assets/js/80.e392086a.js"><link rel="prefetch" href="/assets/js/81.97388622.js"><link rel="prefetch" href="/assets/js/82.9366dacf.js"><link rel="prefetch" href="/assets/js/83.5ed8acc4.js"><link rel="prefetch" href="/assets/js/84.d1d33d38.js"><link rel="prefetch" href="/assets/js/85.a3ef9d25.js"><link rel="prefetch" href="/assets/js/86.31ecbe2e.js"><link rel="prefetch" href="/assets/js/87.14070733.js"><link rel="prefetch" href="/assets/js/88.1c94e8e0.js"><link rel="prefetch" href="/assets/js/89.b59e84a7.js"><link rel="prefetch" href="/assets/js/9.4c1530ec.js"><link rel="prefetch" href="/assets/js/90.4b2949f4.js"><link rel="prefetch" href="/assets/js/91.6ef1ae99.js"><link rel="prefetch" href="/assets/js/92.c13a05d5.js"><link rel="prefetch" href="/assets/js/93.4f730b35.js"><link rel="prefetch" href="/assets/js/94.2cd2abae.js"><link rel="prefetch" href="/assets/js/95.03d94edd.js"><link rel="prefetch" href="/assets/js/96.5bcbc550.js"><link rel="prefetch" href="/assets/js/97.15877723.js"><link rel="prefetch" href="/assets/js/98.beef80df.js"><link rel="prefetch" href="/assets/js/99.3c55205c.js"><link rel="prefetch" href="/assets/js/vendors~docsearch.3b3aacb0.js"> |
| <link rel="stylesheet" href="/assets/css/0.styles.47c4181e.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.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="/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| 基金会 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| 许可证 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| 安全 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| 赞助 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| 致谢 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| 活动 |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/7-TsFile/2-Usage.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.8.x/7-TsFile/2-Usage.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/incubator-iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link"> |
| gitHub |
| <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></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.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="/Development/HowToCommit.html" class="nav-link">如何提交代码</a></li><li class="dropdown-item"><!----> <a href="/Development/Committer.html" class="nav-link">成为Committer</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/ContributeGuide.html" class="nav-link">项目开发指南</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/format-changelist.html" class="nav-link">TsFile的更改列表</a></li><li class="dropdown-item"><!----> <a href="/zh/Development/rpc-changelist.html" class="nav-link">RPC变更清单</a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">ASF</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="http://www.apache.org/" class="nav-link external"> |
| 基金会 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/licenses/" class="nav-link external"> |
| 许可证 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/security/" class="nav-link external"> |
| 安全 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/sponsorship.html" class="nav-link external"> |
| 赞助 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/foundation/thanks.html" class="nav-link external"> |
| 致谢 |
| <!----></a></li><li class="dropdown-item"><!----> <a href="http://www.apache.org/events/current-event" class="nav-link external"> |
| 活动 |
| <!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><a class="dropdown-title"><span class="title">语言</span> <span class="arrow right"></span></a> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="/UserGuide/V0.8.x/7-TsFile/2-Usage.html" class="nav-link">English</a></li><li class="dropdown-item"><!----> <a href="/zh/UserGuide/V0.8.x/7-TsFile/2-Usage.html" aria-current="page" class="nav-link router-link-exact-active router-link-active">简体中文</a></li></ul></div></div> <a href="https://github.com/apache/incubator-iotdb.git" target="_blank" rel="noopener noreferrer" class="repo-link"> |
| gitHub |
| <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></a></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>IoTDB用户手册 (V0.8.x)</span> <!----></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>0-开始使用</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>1-概述</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>2-基本概念</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>3-操作指南</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>4-系统部署与管理</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>5-IoTDB SQL文档</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>6-JDBC API</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>7-TsFile</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/zh/UserGuide/V0.8.x/7-TsFile/1-Installation.html" class="sidebar-link">安装</a></li><li><a href="/zh/UserGuide/V0.8.x/7-TsFile/2-Usage.html" aria-current="page" class="active sidebar-link">用法</a></li><li><a href="/zh/UserGuide/V0.8.x/7-TsFile/3-Hierarchy.html" class="sidebar-link">TsFile层次结构</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>8-系统工具</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="content content__default"><h1 id="用法"><a href="#用法" class="header-anchor">#</a> 用法</h1> <p>现在，您准备开始使用TsFile做一些很棒的事情。 本节演示TsFile的详细用法。</p> <h2 id="时间序列数据"><a href="#时间序列数据" class="header-anchor">#</a> 时间序列数据</h2> <p>时间序列被视为四倍序列。 四元组定义为（设备，测量，时间，值）。</p> <ul><li><p><strong>测量</strong>: 时间序列进行的物理或形式测量，例如城市温度，某些商品的销售数量或火车在不同时间的速度。 由于传统的传感器（例如温度计）也需要进行一次测量并生成一个时间序列，因此我们将在下面互换使用测量和传感器。</p></li> <li><p><strong>设备</strong>: 设备是指正在执行多个测量（产生多个时间序列）的实体，例如，运行中的火车监视其速度，油表，行驶里程，当前乘客均被传送到一个时间序列。</p></li></ul> <p>表1说明了一组时间序列数据。 下表中显示的集合包含一个名为“ device_1”的设备以及三个名为“ sensor_1”，“ sensor_2”和“ sensor_3”的测量值。</p> <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>value</code> 中没有<code>value</code>，请改用空格（实际上，TsFile不存储空值）。 其格式如下所示：</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>一个示例如下所示。 在此示例中，两个测量的数据类型分别为INT32和FLOAT。</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>device_1, 1490860659000, m1, 10, m2, 12.12 |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><h2 id="编写tsfile"><a href="#编写tsfile" class="header-anchor">#</a> 编写TsFile</h2> <h3 id="生成一个tsfile文件。"><a href="#生成一个tsfile文件。" class="header-anchor">#</a> 生成一个TsFile文件。</h3> <p>可以通过以下三个步骤来生成TsFile，完整的代码将在“编写TsFile的示例”部分中给出。</p> <ul><li><p>首先，构造一个<code>TsFileWriter</code>实例。</p> <p>以下是可用的构造函数：</p> <ul><li>没有预定义的架构</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><ul><li>使用预定义的架构</li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code>public TsFileWriter(File file, FileSchema 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, FileSchema schema) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><strong>参量:</strong></p> <ul><li><p>文件: 要写的TsFile</p></li> <li><p>模式: 文件模式将在下一部分中介绍。</p></li></ul></li> <li><p>二，添加测量</p> <p>或者，您可以先创建<code>FileSchema</code>类的实例，然后将其传递给<code>TsFileWriter</code>类的构造函数。</p> <p><code>FileSchema</code>类包含一个映射，该映射的键是一个测量模式的名称，而值是该模式本身。</p> <p>这里是接口：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>// 创建一个空的FileSchema或从现有的映射 |
| public FileSchema() |
| public FileSchema(Map<String, MeasurementSchema> measurements) |
| |
| // 使用这两个界面添加测量 |
| public void registerMeasurement(MeasurementSchema descriptor) |
| public void registerMeasurements(Map<String, MeasurementSchema> measurements) |
| |
| // 一些有用的吸气剂和检查剂 |
| 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><span class="line-number">12</span><br><span class="line-number">13</span><br></div></div><p>您可以始终在<code>TsFileWriter</code>类中使用以下接口来添加其他度量： |
| </p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public void addMeasurement(MeasurementSchema measurementSchema) throws WriteProcessException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p><code>MeasurementSchema</code>类包含一种度量的信息，有几种构造函数：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding) |
| |
| public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType) |
| |
| public MeasurementSchema(String measurementId, TSDataType type, TSEncoding encoding, CompressionType compressionType, |
| Map<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><span class="line-number">5</span><br><span class="line-number">6</span><br></div></div><p><strong>参数：</strong></p> <ul><li><p>measurementID：此测量的名称，通常是传感器的名称。</p></li> <li><p>类型：数据类型，现在支持六种类型：<code>BOOLEAN</code>，<code>INT32</code>，<code>INT64</code>，<code>FLOAT</code>，<code>DOUBLE</code>，<code>TEXT</code>。</p></li> <li><p>encoding：数据编码。 看到 <a href="/zh/UserGuide/V0.8.x/2-Concept Key Concepts and Terminology/3-Encoding.html">章节 2-3</a>.</p></li> <li><p>compression：数据压缩。 现在支持<code>UNCOMPRESSED</code>和<code>SNAPPY</code>。</p></li> <li><p>props：特殊数据类型的属性，例如<code>FLOAT</code>和<code>DOUBLE</code>的<code>max_point_number</code>，<code>TEXT</code>的<code>max_string_length</code>。 用作字符串对，例如（“ max_point_number”，“ 3”）。</p></li></ul> <blockquote><p>**注意：**尽管一个度量名称可以在多个deltaObject中使用，但是不能更改属性。 即 不允许多次使用不同的类型或编码添加一个测量名称。 |
| 这是一个不好的例子：</p></blockquote> <div class="language- extra-class"><pre><code> // 测量值“ sensor_1”为浮点型 |
| addMeasurement(new MeasurementSchema("sensor_1", TSDataType.FLOAT, TSEncoding.RLE)); |
| |
| // 此调用将引发WriteProcessException异常 |
| 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>（一个测量值和一个值对），并使用<code>addTuple</code>方法将<code>DataPoint</code>添加到正确的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> <h3 id="编写tsfile的示例"><a href="#编写tsfile的示例" class="header-anchor">#</a> 编写TsFile的示例</h3> <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>可以在以下位置找到更详尽的示例<code>/tsfile/example/src/main/java/org/apache/iotdb/tsfile/TsFileWrite.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><span class="token punctuation">.</span><span class="token class-name">File</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums</span><span class="token punctuation">.</span><span class="token class-name">TSDataType</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>file<span class="token punctuation">.</span>metadata<span class="token punctuation">.</span>enums</span><span class="token punctuation">.</span><span class="token class-name">TSEncoding</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write</span><span class="token punctuation">.</span><span class="token class-name">TsFileWriter</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write<span class="token punctuation">.</span>record</span><span class="token punctuation">.</span><span class="token class-name">TSRecord</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint</span><span class="token punctuation">.</span><span class="token class-name">DataPoint</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint</span><span class="token punctuation">.</span><span class="token class-name">FloatDataPoint</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write<span class="token punctuation">.</span>record<span class="token punctuation">.</span>datapoint</span><span class="token punctuation">.</span><span class="token class-name">IntDataPoint</span><span class="token punctuation">;</span> |
| <span class="token keyword">import</span> <span class="token namespace">org<span class="token punctuation">.</span>apache<span class="token punctuation">.</span>iotdb<span class="token punctuation">.</span>tsfile<span class="token punctuation">.</span>write<span class="token punctuation">.</span>schema</span><span class="token punctuation">.</span><span class="token class-name">MeasurementSchema</span><span class="token punctuation">;</span> |
| <span class="token comment">/** |
| * 将数据写入TsFile的示例 |
| * 它使用以下接口： |
| * 公共无效addMeasurement（MeasurementSchema MeasurementSchema）抛出WriteProcessException |
| */</span> |
| <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileWrite</span> <span class="token punctuation">{</span> |
| |
| <span class="token keyword">public</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">main</span><span class="token punctuation">(</span><span class="token class-name">String</span> args<span class="token punctuation">[</span><span class="token punctuation">]</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> |
| <span class="token keyword">try</span> <span class="token punctuation">{</span> |
| <span class="token class-name">String</span> path <span class="token operator">=</span> <span class="token string">"test.tsfile"</span><span class="token punctuation">;</span> |
| <span class="token class-name">File</span> f <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">File</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token keyword">if</span> <span class="token punctuation">(</span>f<span class="token punctuation">.</span><span class="token function">exists</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span> |
| f<span class="token punctuation">.</span><span class="token function">delete</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token class-name">TsFileWriter</span> tsFileWriter <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileWriter</span><span class="token punctuation">(</span>f<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// 将度量添加到文件模式</span> |
| tsFileWriter |
| <span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">"sensor_1"</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| tsFileWriter |
| <span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">"sensor_2"</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| tsFileWriter |
| <span class="token punctuation">.</span><span class="token function">addMeasurement</span><span class="token punctuation">(</span><span class="token keyword">new</span> <span class="token class-name">MeasurementSchema</span><span class="token punctuation">(</span><span class="token string">"sensor_3"</span><span class="token punctuation">,</span> <span class="token class-name">TSDataType</span><span class="token punctuation">.</span>INT64<span class="token punctuation">,</span> <span class="token class-name">TSEncoding</span><span class="token punctuation">.</span>RLE<span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// 构造TSRecord</span> |
| <span class="token class-name">TSRecord</span> tsRecord <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TSRecord</span><span class="token punctuation">(</span><span class="token number">1</span><span class="token punctuation">,</span> <span class="token string">"device_1"</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">DataPoint</span> dPoint1 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">"sensor_1"</span><span class="token punctuation">,</span> <span class="token number">1</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">DataPoint</span> dPoint2 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">"sensor_2"</span><span class="token punctuation">,</span> <span class="token number">2</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">DataPoint</span> dPoint3 <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">LongDataPoint</span><span class="token punctuation">(</span><span class="token string">"sensor_3"</span><span class="token punctuation">,</span> <span class="token number">3</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint1<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint2<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| tsRecord<span class="token punctuation">.</span><span class="token function">addTuple</span><span class="token punctuation">(</span>dPoint3<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// 写TSRecord</span> |
| tsFileWriter<span class="token punctuation">.</span><span class="token function">write</span><span class="token punctuation">(</span>tsRecord<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// 关闭TsFile</span> |
| tsFileWriter<span class="token punctuation">.</span><span class="token function">close</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> <span class="token keyword">catch</span> <span class="token punctuation">(</span><span class="token class-name">Throwable</span> e<span class="token punctuation">)</span> <span class="token punctuation">{</span> |
| e<span class="token punctuation">.</span><span class="token function">printStackTrace</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">System</span><span class="token punctuation">.</span>out<span class="token punctuation">.</span><span class="token function">println</span><span class="token punctuation">(</span>e<span class="token punctuation">.</span><span class="token function">getMessage</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br><span class="line-number">54</span><br><span class="line-number">55</span><br><span class="line-number">56</span><br></div></div><h2 id="读取tsfile的接口"><a href="#读取tsfile的接口" class="header-anchor">#</a> 读取TsFile的接口</h2> <h3 id="开始之前"><a href="#开始之前" class="header-anchor">#</a> 开始之前</h3> <p>“时间序列数据”部分中的时间序列数据集在此用于本节的具体介绍。 下表中显示的集合包含一个名为“ device \ _1”的deltaObject和三个名为“ sensor \ _1”，“ sensor \ _2”和“ sensor \ _3”的测量值。 并简化了测量以进行简单说明，每个仅包含4个时间值对。</p> <table><thead><tr><th style="text-align:center;">关系</th> <th style="text-align:center;">描述</th></tr></thead> <tbody><tr><td style="text-align:center;">TimeFilter.eq(value)</td> <td style="text-align:center;">选择等于值的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.lt(value)</td> <td style="text-align:center;">选择小于时间的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.gt(value)</td> <td style="text-align:center;">选择大于值的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.ltEq(value)</td> <td style="text-align:center;">选择小于或等于该值的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.gtEq(value)</td> <td style="text-align:center;">选择大于或等于该值的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.notEq(value)</td> <td style="text-align:center;">选择不等于该值的时间</td></tr> <tr><td style="text-align:center;">TimeFilter.not(TimeFilter)</td> <td style="text-align:center;">选择不满足另一个TimeFilter的时间</td></tr></tbody></table> <h3 id="路径定义"><a href="#路径定义" class="header-anchor">#</a> 路径定义</h3> <p>路径是用点分隔的字符串，该字符串在TsFile中唯一标识时间序列，例如“ root.area_1.device_1.sensor_1”。 |
| 最后一部分“ sensor_1”称为“ measurementId”，其余部分“ root.area_1.device_1”称为deviceId。 |
| 如上所述，不同设备中的相同测量具有相同的数据类型和编码，并且设备也是唯一的。</p> <p>在读取接口中，参数<code>paths</code>指示要选择的测量。</p> <p>路径实例可以通过<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>**注意：**在构造路径时，参数的格式应为点分隔的字符串，最后一部分将被识别为MeasurementId，而其余部分将被识别为deviceId。</p></blockquote> <h3 id="过滤器的定义"><a href="#过滤器的定义" class="header-anchor">#</a> 过滤器的定义</h3> <h4 id="使用场景"><a href="#使用场景" class="header-anchor">#</a> 使用场景</h4> <p>在TsFile读取过程中使用筛选器来选择满足一个或多个给定条件的数据。</p> <h4 id="iexpression"><a href="#iexpression" class="header-anchor">#</a> IExpression</h4> <p><code>IExpression</code>是一个过滤器表达式接口，它将传递给我们的最终查询调用。 |
| 我们创建一个或多个过滤器表达式，并可以使用二进制过滤器运算符将它们链接到最终表达式。</p> <ul><li><p><strong>创建一个过滤器表达式</strong></p> <p>有两种类型的过滤器。</p> <ul><li>时间过滤器: 时间序列数据中时间的过滤器。<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></li></ul> <div class="language- line-numbers-mode"><pre class="language-text"><code> 使用以下关系获取`TimeFilter`对象（值是一个long int变量）。 |
| |
| | 关系 | 描述 | |
| | :------------------------: | :------------------------------: | |
| | TimeFilter.eq(value) | 选择等于值的时间 | |
| | TimeFilter.lt(value) | 选择小于时间的时间 | |
| | TimeFilter.gt(value) | 选择大于值的时间 | |
| | TimeFilter.ltEq(value) | 选择小于或等于该值的时间 | |
| | TimeFilter.gtEq(value) | 选择大于或等于该值的时间 | |
| | TimeFilter.notEq(value) | 选择不等于该值的时间 | |
| | TimeFilter.not(TimeFilter) | 选择不满足另一个TimeFilter的时间 | |
| |
| * ValueFilter：时间序列数据中`value`的过滤器。 |
| |
| </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></div></div><p>IExpression valueFilterExpr = new SingleSeriesExpression(Path, ValueFilter);</p> <div class="language- line-numbers-mode"><pre class="language-text"><code> `ValueFilter`的用法与使用`TimeFilter`的用法相同，只是要确保值的类型等于测量值（在路径中定义）。 |
| |
| </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><strong>二元滤波器运算符</strong></p> <p>二进制过滤器运算符可用于链接两个单个表达式。</p> <ul><li>BinaryExpression.and（Expression，Expression）：选择两个表达式都满足的值。</li> <li>BinaryExpression.or（Expression，Expression）：选择至少满足一个表达式的值。</li></ul></li></ul> <h4 id="过滤器表达式示例"><a href="#过滤器表达式示例" class="header-anchor">#</a> 过滤器表达式示例</h4> <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> <h3 id="读取界面"><a href="#读取界面" class="header-anchor">#</a> 读取界面</h3> <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>方法1</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></li> <li><p><strong>方法二</strong></p> <div class="language- line-numbers-mode"><pre class="language-text"><code>public QueryDataSet query(QueryExpression queryExpression, long partitionStartOffset, long partitionEndOffset) throws IOException |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>此方法设计用于高级应用程序，例如TsFile-Spark连接器。</p> <ul><li><p><strong>参数</strong>: 对于方法2，添加了两个附加参数以支持部分查询：</p> <ul><li><code>partitionStartOffset</code>:TsFile的起始偏移量</li> <li><code>partitionEndOffset</code>: TsFile的结束偏移量</li></ul> <blockquote><p>**什么是部分查询？**在某些分布式文件系统（例如HDFS）中，文件被分成几个部分，这些部分称为“块”，并存储在不同的节点中。 在涉及的每个节点中并行执行查询可以提高效率。 因此，需要部分查询。 Paritial Query只选择存储在零件中的结果，该零件由TsFile的<code>QueryConstant.PARTITION_START_OFFSET</code>和<code>QueryConstant.PARTITION_END_OFFSET</code>分开。</p></blockquote></li></ul></li></ul> <h3 id="querydataset接口"><a href="#querydataset接口" class="header-anchor">#</a> QueryDataset接口</h3> <p>上面执行的查询将返回一个<code>QueryDataset</code>对象。</p> <p>这是对用户有用的界面。</p> <ul><li><p><code>bool hasNext();</code></p> <p>如果此数据集仍包含元素，则返回true。</p></li> <li><p><code>List<Path> getPaths()</code></p> <p>获取此数据集中的路径。</p></li> <li><p><code>List<TSDataType> getDataTypes();</code></p> <p>获取数据类型。 <code>TSDataType</code>类是一个枚举类，值将是以下值之一：</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> <h3 id="读取现有tsfile的示例"><a href="#读取现有tsfile的示例" class="header-anchor">#</a> 读取现有TsFile的示例</h3> <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>有关查询语句的更详尽示例，请参见： |
| <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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</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><span class="token punctuation">.</span><span class="token class-name">QueryDataSet</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">/** |
| * 该类将显示如何读取名为“ test.ts文件”的Ts文件文件。 |
| * TsFile文件“ test.tsfile”是从类TsFileWrite生成的。 |
| * 运行TsFileWrite首先生成test.tsfile |
| */</span> |
| <span class="token keyword">public</span> <span class="token keyword">class</span> <span class="token class-name">TsFileRead</span> <span class="token punctuation">{</span> |
| <span class="token keyword">private</span> <span class="token keyword">static</span> <span class="token keyword">void</span> <span class="token function">queryAndPrint</span><span class="token punctuation">(</span><span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</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">// 文件路径</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">// 创建阅读器并获取readTsFile接口</span> |
| <span class="token class-name">TsFileSequenceReader</span> reader <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">TsFileSequenceReader</span><span class="token punctuation">(</span>path<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token class-name">ReadOnlyTsFile</span> readTsFile <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name">ReadOnlyTsFile</span><span class="token punctuation">(</span>reader<span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token comment">// 使用这些路径（所有传感器）进行所有查询</span> |
| <span class="token class-name">ArrayList</span><span class="token generics"><span class="token punctuation"><</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">// 没有查询语句</span> |
| <span class="token function">queryAndPrint</span><span class="token punctuation">(</span>paths<span class="token punctuation">,</span> readTsFile<span class="token punctuation">,</span> <span class="token keyword">null</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| |
| <span class="token comment">// 离开时关闭阅读器</span> |
| reader<span class="token punctuation">.</span><span class="token function">close</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">;</span> |
| <span class="token punctuation">}</span> |
| <span class="token punctuation">}</span> |
| |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br></div></div><h2 id="用户指定的配置文件路径"><a href="#用户指定的配置文件路径" class="header-anchor">#</a> 用户指定的配置文件路径</h2> <p>默认配置文件<code>tsfile-format.properties.template</code>位于<code>/ tsfile / src / main / resources</code>目录中。 如果要使用自己的路径，则可以：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>System.setProperty(TsFileConstant.TSFILE_CONF, "your config file path"); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div><p>然后调用：</p> <div class="language- line-numbers-mode"><pre class="language-text"><code>TSFileConfig config = TSFileDescriptor.getInstance().getConfig(); |
| </code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br></div></div></div> <div class="page-nav"><p class="inner"><span class="prev"> |
| ← |
| <a href="/zh/UserGuide/V0.8.x/7-TsFile/1-Installation.html" class="prev"> |
| 安装 |
| </a></span> <span class="next"><a href="/zh/UserGuide/V0.8.x/7-TsFile/3-Hierarchy.html"> |
| TsFile层次结构 |
| </a> |
| → |
| </span></p></div> <p style="text-align: center;">Copyright © 2020 The Apache Software Foundation.<br> |
| Apache and the Apache feather logo are trademarks of The Apache Software Foundation</p> <p style="text-align:justify!important;paddingLeft:10px;paddingRight:10px;"> |
| Disclaimer: Apache IoTDB (incubating) is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. |
| </p></main></div><div class="global-ui"></div></div> |
| <script src="/assets/js/app.882d9a07.js" defer></script><script src="/assets/js/3.1dc302ea.js" defer></script><script src="/assets/js/287.7b650265.js" defer></script> |
| </body> |
| </html> |
