设置 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 CLI 使用 连接配置文件 连接并认证您的 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专用凭据：

• 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。