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 帐户，导航到“数据”选项卡，然后生成新令牌。您可以选择将令牌范围限定为特定存储桶，或创建完全访问令牌。

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

首先创建一个存储桶来写入数据。您可以使用 UI 或 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 频道上分享。我们很乐意获得您的反馈并帮助您解决遇到的任何问题。