influx 写入干运行
要打印写入输出到标准输出而不是写入InfluxDB,请使用influx write dryrun命令。使用此命令来测试数据写入。
支持 line protocol, annotated CSV, 和 extended annotated CSV。 输出始终为 line protocol。
用法
influx write dryrun [flags]
标志
| 标志 | 描述 | 输入类型 | 映射到 ? | |
|---|---|---|---|---|
-c | --active-config | 用于命令的CLI配置 | string | |
-b | --bucket | 存储桶名称(与 --bucket-id 互斥) | 字符串 | INFLUX_BUCKET_NAME |
--bucket-id | 存储桶 ID(与 --bucket 互斥) | 字符串 | INFLUX_BUCKET_ID | |
--configs-path | 指向 influx CLI 配置的路径(默认 ~/.influxdbv2/configs) | string | INFLUX_CONFIGS_PATH | |
--debug | 将错误输出到stderr | |||
--encoding | 输入的字符编码(默认 UTF-8) | 字符串 | ||
--errors-file | 用于记录被拒绝行错误的文件路径 | string | ||
-f | --file | 要导入的文件 | stringArray | |
--format | 输入格式 (lp 或 csv, 默认 lp) | 字符串 | ||
--header | 在CSV输入数据前添加标题行 | string | ||
-h | --help | 关于dryrun命令的帮助 | ||
--host | InfluxDB的HTTP地址(默认 http://localhost:9999) | 字符串 | INFLUX_HOST | |
--max-line-length | 单行可以读取的最大字节数(默认 16000000) | 整数 | ||
-o | --org | 组织名称(与 --org-id 互斥) | 字符串 | INFLUX_ORG |
--org-id | 组织 ID(与 --org 互斥) | 字符串 | INFLUX_ORG_ID | |
-p | --precision | 时间戳的精度(默认为 ns) | 字符串 | INFLUX_PRECISION |
--rate-limit | 限制写入速率(示例: 5MB/5min 或 1MB/s)。 | string | ||
--skip-verify | 跳过TLS证书验证 | INFLUX_SKIP_VERIFY | ||
--skipHeader | 跳过输入数据的前 n 行 | 整数 | ||
--skipRowOnError | 将CSV错误输出到stderr,但继续处理 | |||
-t | --token | API令牌 | 字符串 | INFLUX_TOKEN |
-u | --url | 从中导入数据的URL | stringArray |
示例
身份验证凭据
下面的示例假设您的 InfluxDB 主机、组织 和 令牌 是通过 活动 influx CLI 配置 或环境变量 (INFLUX_HOST、INFLUX_ORG 和 INFLUX_TOKEN) 提供的。如果您没有设置 CLI 配置或环境变量,请在每个命令中使用以下标志包含这些必需的凭据:
--host: InfluxDB 主机-o, --org或--org-id: InfluxDB 组织名称或 ID-t, --token: InfluxDB API 令牌
行协议
通过标准输入进行行协议干运行写入
influx write --bucket example-bucket "
m,host=host1 field1=1.2
m,host=host2 field1=2.4
m,host=host1 field2=5i
m,host=host2 field2=3i
"
从文件中干运行写入行协议
influx write dryrun \
--bucket example-bucket \
--file path/to/line-protocol.txt
从多个文件中干运行写入行协议
influx write dryrun \
--bucket example-bucket \
--file path/to/line-protocol-1.txt \
--file path/to/line-protocol-2.txt
从 URL 写入行协议的干运行
influx write dryrun \
--bucket example-bucket \
--url https://example.com/line-protocol.txt
从多个URL干运行写入行协议
influx write dryrun \
--bucket example-bucket \
--url https://example.com/line-protocol-1.txt \
--url https://example.com/line-protocol-2.txt
从多个来源干运行写入线协议
influx write dryrun \
--bucket example-bucket \
--file path/to/line-protocol-1.txt \
--url https://example.com/line-protocol-2.txt
CSV
通过标准输入干运行写入带注释的CSV数据
influx write dryrun \
--bucket example-bucket \
--format csv \
"#datatype measurement,tag,tag,field,field,ignored,time
m,cpu,host,time_steal,usage_user,nothing,time
cpu,cpu1,host1,0,2.7,a,1482669077000000000
cpu,cpu1,host2,0,2.2,b,1482669087000000000
"
从文件中干运行写入带注释的CSV数据
influx write dryrun \
--bucket example-bucket \
--file path/to/data.csv
从多个文件中干运行写入带注释的CSV数据
influx write dryrun \
--bucket example-bucket \
--file path/to/data-1.csv \
--file path/to/data-2.csv
从URL写入带注释的CSV数据的干运行
influx write dryrun \
--bucket example-bucket \
--url https://example.com/data.csv
从多个URL中写入带注释的CSV数据的干运行
influx write dryrun \
--bucket example-bucket \
--url https://example.com/data-1.csv \
--url https://example.com/data-2.csv
从多个来源写入带注释的CSV数据的干运行
influx write dryrun \
--bucket example-bucket \
--file path/to/data-1.csv \
--url https://example.com/data-2.csv
在CSV数据前添加注释头的干运行准备
influx write dryrun \
--bucket example-bucket \
--header "#constant measurement,birds" \
--header "#datatype dataTime:2006-01-02,long,tag" \
--file path/to/data.csv