TL;DR InfluxDB技术技巧 - 如何在本地使用CLI访问Flux REPL并将常规CSV写入InfluxDB Cloud
由 Anais Dotis-Georgiou / 用例,产品,开发者
2020年9月21日
导航至
在这篇文章中,我们分享了如何使用InfluxDB CLI与InfluxDB Cloud。此TL;DR假设您已注册了InfluxDB Cloud账户——注册免费账户是开始使用InfluxDB的最简单方法。
问题:我需要什么来在机器上使用CLI连接到InfluxDB Cloud? 答案:您需要在本地上安装InfluxDB 2.0 CLI。请遵循文档来安装和配置Influx CLI。获取以下授权参数用于您的InfluxDB Cloud账户
- URL:InfluxDB Cloud账户的URL。例如,如果您位于美国西部区域,可能是
https://us-west-2-1.aws.cloud2.influxdata.com
- 组织:组织是您用于注册InfluxDB Cloud账户的电子邮件账户。
- 令牌:通过登录InfluxDB Cloud账户,导航到“数据”标签页,并生成新令牌来创建令牌。您可以选择将令牌限定为特定桶或创建一个完全访问令牌。
在导航到左侧垂直导航栏上的“数据”标签页后,访问“令牌”页面并选择“生成”来命名和生成新令牌。
问题:我如何将本地CLI连接到InfluxDB Cloud? 答案:安装本地Influx CLI后,为您的InfluxDB Cloud账户创建一个包含授权设置的influx配置。
# Set up a configuration profile
influx config create -n Cloud\
-u https://us-west-2-1.aws.cloud2.influxdata.com\
-o [email protected]\
-t $INFLUX-TOKEN\
-a
这将成为您的CLI默认配置。
问题:我可以创建多个InfluxDB CLI配置吗? 答案:您可以创建多个CLI配置设置,并通过以下命令在influx config命令之间切换。例如,要从InfluxDB Cloud配置切换到本地配置,运行
influx config Local
要快速切换回上一个配置,使用以下快捷命令
influx config -
问题:我如何访问Flux REPL? 答案:使用此命令访问REPL
./influx repl
问题:我如何结束Flux REPL会话? 答案:要退出Flux REPL,在MacOS上按CMD+D。其他Linux变体使用CTRL+D。
问:我如何使用 InfluxDB CLI 将常规 CSV 写入 InfluxDB Cloud?答:使用 influx write 命令将以下 CSV 文件 animals.csv
,通过 InfluxDB CLI 写入 InfluxDB Cloud。
Type, Shelter, Age, Description, Date
Cat, A, 1.0, Tabby, 2020-08-01
Cat, A, 3.0, Calico, 2020-08-02
Cat, B, 14.0, Tabby, 2020-08-03
Dog, A, 7.5, Lab, 2020-08-04
Dog, B, 4.0, Pomeranian, 2020-08-05
Dog, B, 5.0, Shiba, 2020-08-06
首先创建一个用于写入数据的存储桶。您可以使用 界面 或 CLI 来创建存储桶。要使用 CLI 创建名为“Animals”的存储桶,请运行以下命令
influx bucket create -n AnimalData -o [email protected] -r 7d
包含存储桶名称、创建存储桶的组织和存储桶的保留策略,使用 influx bucket create CLI 命令 创建存储桶。成功的存储桶创建会返回以下信息
ID Name Retention Organization ID
064139a738a61000 AnimalData 168h0m0s 04e07adbcd0b6000
使用以下命令将 CSV 写入 AnimalData 存储桶
influx write -b AnimalData\
-f path/to/animals.csv \
--header "#constant measurement,Animals" \
--header "#datatype tag,tag,double,string,dateTime:2006-01-02"
请确保包含常量并指定头部数据类型。在本例中,我创建了一个常量度量,名为“Animals”。然而,您也可以创建常量标签、字段和日期。我还创建了两个字段,“Age”和“Description”,分别属于“long”和“string”类型。请参阅此文档了解所有可接受的字段格式。
以下是输出结果
请注意,时区默认为 UTC,小时默认为 00:00:00UTC
。您必须手动更改时间戳才能使 InfluxDB 在您的时区写入时间。或者,您可以使用 Unix 时间戳。以下是一份 支持的日期时间格式 列表。另外,请注意,日期时间头部应正好为 dateTime:2006-01-02
。
希望这篇教程能帮助您了解如何使用 CLI 与 InfluxDB Cloud,以及如何将 CSV 写入 InfluxDB。如往常一样,如果您遇到困难,请在我们社区网站或Slack频道中分享。我们很乐意得到您的反馈,并帮助您解决遇到的问题。