TL;DR InfluxDB技术技巧 - 如何在本地使用CLI访问Flux REPL并将常规CSV写入InfluxDB Cloud

导航至

在这篇文章中,我们分享了如何使用InfluxDB CLI与InfluxDB Cloud。此TL;DR假设您已注册了InfluxDB Cloud账户——注册免费账户是开始使用InfluxDB的最简单方法。

问题:我需要什么来在机器上使用CLI连接到InfluxDB Cloud? 答案:您需要在本地上安装InfluxDB 2.0 CLI。请遵循文档来安装和配置Influx CLI。获取以下授权参数用于您的InfluxDB Cloud账户

influxdb cloud token

在导航到左侧垂直导航栏上的“数据”标签页后,访问“令牌”页面并选择“生成”来命名和生成新令牌。

问题:我如何将本地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”类型。请参阅此文档了解所有可接受的字段格式。

以下是输出结果

influxdb cloud csv

请注意,时区默认为 UTC,小时默认为 00:00:00UTC。您必须手动更改时间戳才能使 InfluxDB 在您的时区写入时间。或者,您可以使用 Unix 时间戳。以下是一份 支持的日期时间格式 列表。另外,请注意,日期时间头部应正好为 dateTime:2006-01-02

希望这篇教程能帮助您了解如何使用 CLI 与 InfluxDB Cloud,以及如何将 CSV 写入 InfluxDB。如往常一样,如果您遇到困难,请在我们社区网站Slack频道中分享。我们很乐意得到您的反馈,并帮助您解决遇到的问题。