设置 InfluxDB Cloud 专用版

在您开始本教程时，请做以下几点，以确保您所需的一切都已就位。

• 请求一个 InfluxDB Cloud 专用集群
• 下载、安装和配置 influxctl CLI
• 创建一个数据库
• 创建一个数据库令牌
• 配置认证凭据

请求一个 InfluxDB Cloud 专用集群

联系 InfluxData 销售团队 以请求一个 InfluxDB Cloud 专用集群。 当您的集群部署完成后，InfluxData 会向您发送一封电子邮件，邀请您 加入您的集群。请使用电子邮件中提供的链接接受邀请 并创建您的 InfluxDB Cloud 专用账户。

在接受邀请并创建帐户后，InfluxData提供以下信息：

• 您的 InfluxDB Cloud 专用 帐户 ID
• 您的 InfluxDB Cloud 专用 集群 ID
• 您的 InfluxDB Cloud 专用 集群 URL

下载、安装和配置 influxctl 命令行工具

这个 influxctl CLI 允许您从命令行管理您的 InfluxDB Cloud Dedicated 集群，并执行诸如管理数据库和令牌等管理任务。

1. 下载并安装 influxctl CLI。

2. 创建一个连接配置文件并提供您的 InfluxDB Cloud Dedicated 连接凭据。

   influxctl 命令行界面使用 连接配置文件 来连接和验证您的 InfluxDB Cloud Dedicated 集群。

   根据您的操作系统，在以下位置创建一个名为 config.toml 的文件。

   操作系统	默认配置文件路径
   Linux	~/.config/influxctl/config.toml
   macOS	~/Library/Application Support/influxctl/config.toml
   Windows	%APPDATA%\influxctl\config.toml

   如果存储在非默认位置，请在每个influxctl命令中包含--config标志，并提供您的配置文件路径。

3. 将示例配置文件代码复制并粘贴到您的 config.toml:

[[profile]]
  name = "default"
  product = "dedicated"
  account_id = "
ACCOUNT_ID
"
  cluster_id = "
CLUSTER_ID
"
  host = "cluster-id.a.influxdb.io"

用您的 InfluxDB Cloud Dedicated 凭据替换以下内容：

• ACCOUNT_ID: 您的账户ID
• CLUSTER_ID: 您的集群 ID

有关 influxctl 配置文件的详细信息，请参见 配置连接文件.

创建数据库

使用 influxctl database create 命令 来创建一个数据库。您可以使用现有的数据库或创建一个新的数据库 专门用于本入门教程。 本入门教程中的示例假定数据库名为 get-started。

提供以下内容：

• 数据库名称。
• 可选: 数据库 保留期限 作为一个持续时间值。如果未指定保留期限，则默认值为无限。

influxctl database create --retention-period 
1y
 
get-started

创建数据库令牌

使用 influxctl token create 命令 为您的数据库创建一个具有读写权限的数据库令牌。

提供以下内容：

• 权限授予
  • --read-database: 授予对数据库的读取访问权限
  • --write-database 授予对数据库的写入访问权限
• 令牌描述

influxctl token create \
  --read-database 
get-started
 \
  --write-database 
get-started
 \
  "Read/write token for 
get-started
 database" > /app/iot-starter/secret.txt

该命令返回令牌 ID 和令牌字符串。
将令牌字符串存储在安全的地方。
稍后您将需要它。
这是令牌字符串以纯文本形式可用的唯一一次。

配置认证凭据

后面的代码示例假设您将令牌字符串分配给一个 INFLUX_TOKEN 环境变量——例如：

export INFLUX_TOKEN=
DATABASE_TOKEN

$env:INFLUX_TOKEN = "
DATABASE_TOKEN
"

set INFLUX_TOKEN=
DATABASE_TOKEN
 
# Make sure to include a space character at the end of this command.

用您的 数据库令牌 字符串替换 DATABASE_TOKEN。