CloudWise-Lukemiao commented on code in PR #139: URL: https://github.com/apache/tsfile/pull/139#discussion_r1665345346
########## java/tools/README-zh.md: ########## @@ -0,0 +1,129 @@ +<!-- + + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +--> + +[English](./README.md) | [中文](./README-zh.md) +# TsFile Tools 手册 +## 简介 + +## 开发 + +### 前置条件 + +构建 Java 版的 TsFile Tools，必须要安装以下依赖: + +1. Java >= 1.8 (1.8, 11 到 17 都经过验证. 请确保设置了环境变量). +2. Maven >= 3.6 (如果要从源代码编译TsFile). + + +### 使用 maven 构建 + +``` +mvn clean package -P with-java -DskipTests +``` + +### 安装到本地机器 + +``` +mvn install -P with-java -DskipTests +``` + +## schema 定义 + +| 参数 | 说明 | 是否必填 | 默认值 | +|------------|--------------------------|------|------| +| table_name | 表名 | 是 | | +| time_precision | 时间精度（可选值有：ms/us/ns） | 否 | ms | +| has_header | 是否包含表头 (可选值有：true/false) | 否 | true | +| separator | 行内分隔符（可选值有：, /tab/ ;） | 否 | , | +| null_format | 空值 | 否 | | +| id_columns | 主键列，支持cvs中不存在的列做为层级 | 否 | | +| time_column | 时间列 | 是 | | +| csv_columns | 按照顺序与csv列一一对应 | 是 | | + +说明： + +id_columns 按照顺序进行设置值，支持加csv 文件中不存在的列作为层级 +例如csv 只有a,b,c,d,time 则 +id_columns +a1 default aa +a +其中a1 就为虚拟列，默认值为aa + +csv_columns 之后的内容为时间序列的定义，每一个时间序列一行，每一行第一个字段为在tsfile中的测点名，第二个字段为类型 +当某一列不需要写入 tsfile时，可以设置为 SKIP +SKIP 会忽略，不写入 tsfile +例： +csv_columns +地区 TEXT， +厂号 TEXT, +设备号 TEXT, +SKIP, +SKIP, +时间 INT64, +温度 FLOAT, +排量 DOUBLE, + +### 数据示例 +csv 文件内容 +``` +地区, 厂号, 设备号, 型号, 维修周期, 时间, 温度, 排量 +河北, 1001, 1, 10, 1, 1, 80.0, 1000.0 +河北, 1001, 1, 10, 1, 4, 80.0, 1000.0 +河北, 1002, 7, 5, 2, 1, 90.0, 1200.0 +``` +schema 定义 + +``` +table_name=root.db1 +time_precision=ms +time_format=ISO8601 +has_header=true +aligned=true Review Comment: time_format and aligned has been deleted -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
