设置 InfluxDB

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

• 可选： 下载、安装并配置 influx CLI
• 创建一个全访问API令牌
• 配置认证凭据
• 可选： 创建一个桶

1. 可选： 下载、安装并配置 influx CLI。

   influx CLI 提供了一种简单的方法来通过命令行与 InfluxDB 进行交互。有关详细的安装和设置说明，请参见 influx CLI 参考。

2. 创建一个全访问API令牌。

   1. 在浏览器中访问 cloud2.influxdata.com 以登录并访问 InfluxDB 用户界面。

   2. 使用左侧导航栏导航到 加载数据 > API 令牌。

      加载数据

   3. 点击 + 生成API令牌 并选择 全访问API令牌。

   4. 输入API令牌的描述，然后点击 保存。

   5. 复制生成的令牌并将其安全存储。

   我们建议使用密码管理器或秘密存储库来安全地存储敏感令牌。

3. 配置认证凭据。

   在您学习本教程时，与 InfluxDB Cloud Serverless 的交互需要您的 InfluxDB URL 或 主机、组织名称或 ID 以及您的 API token。根据您使用的与 InfluxDB 交互的客户端，有不同的方法来提供这些凭据。

   在配置你的令牌时，如果你 创建了一个全访问令牌，请使用该令牌与 InfluxDB 进行交互。否则，请使用你的操作员令牌。

   InfluxDB 用户界面 influx 命令行工具 Telegraf InfluxDB API

   通过 InfluxDB UI 管理 InfluxDB Cloud Serverless 时，认证凭据会自动使用您登录的用户关联的凭据提供。

   有三种方式可以向influx CLI提供认证凭据：

   CLI 连接配置 (推荐)

   该 influx 命令行界面允许您指定连接配置预设，便于您存储并快速切换多个 InfluxDB 连接凭据。使用 influx config create 命令 创建一个新的 CLI 连接配置。包含以下标志：

   • -n, --config-name: 连接配置名称。这个例子使用 get-started.
   • -u, --host-url: InfluxDB云无服务器区域URL.
   • -o, --org: InfluxDB 组织名称.
   • -t, --token: 你的 API token。

   influx config create \
     --config-name 
   get-started
    \
     --host-url https://cloud2.influxdata.com \
     --org 
   ORG_NAME
    \
     --token 
   API_TOKEN
   

   有关CLI连接配置的更多信息，请参阅influx config命令。

   环境变量

   该 influx CLI 检查特定的环境变量，如果存在，使用这些环境变量填充身份验证凭据。在您的命令行会话中设置以下环境变量：

   • INFLUX_HOST: InfluxDB 云服务器无服务器区域 URL.
   • INFLUX_ORG: InfluxDB 组织名称或ID。
   • INFLUX_TOKEN: 你的 API token。

   MacOS 和 Linux PowerShell 命令提示符

   export INFLUX_HOST=https://cloud2.influxdata.com
   export INFLUX_ORG=
   ORG_NAME
   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_HOST = "https://cloud2.influxdata.com"
   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   $env:INFLUX_ORG = "
   ORG_NAME
   "
   

   set INFLUX_HOST=https://cloud2.influxdata.com
   set INFLUX_ORG=
   ORG_NAME
   set INFLUX_TOKEN=
   API_TOKEN
   # Make sure to include a space character at the end of this command.
   

   命令标志

   使用以下 influx CLI 标志为命令提供所需的凭证：

   • --host: InfluxDB Cloud 无服务器区域 URL.
   • -o, --org: InfluxDB 组织名称或 ID。
   • -t, --token: 你的 API token.

   本快速入门教程中的所有 influx CLI 示例假设您的 InfluxDB 主机、组织 和 令牌 是通过 活动 influx CLI 配置 或环境变量提供的。

   本入门教程中的 Telegraf 示例假设您已将 INFLUX_TOKEN 环境变量分配给您的 InfluxDB 令牌。

   MacOS 和 Linux PowerShell 命令提示符

   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   

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

   替换以下内容：

   • API_TOKEN: 一个具有足够权限访问您存储桶的 InfluxDB API token

   在本入门教程中，API (cURL 和客户端库) 示例假设您已经将环境变量分配给您的 InfluxDB 凭据。

   要将环境变量分配给您的凭证，请在您的配置文件设置或终端中输入以下命令：

   MacOS 和 Linux PowerShell 命令提示符

   export INFLUX_HOST=https://cloud2.influxdata.com
   export INFLUX_ORG=
   ORG_NAME
   export INFLUX_TOKEN=
   API_TOKEN
   

   $env:INFLUX_HOST = "https://cloud2.influxdata.com"
   $env:INFLUX_ORG = "
   ORG_NAME
   "
   $env:INFLUX_TOKEN = "
   API_TOKEN
   "
   

   set INFLUX_HOST=https://cloud2.influxdata.com
   set INFLUX_ORG=
   ORG_NAME
   set INFLUX_TOKEN=
   API_TOKEN
    
   # Make sure to include a space character at the end of this command.
   

   替换以下内容：

   • ORG_NAME: 您的 InfluxDB 组织名称
   • ORG_ID: 你的 InfluxDB 组织 ID
   • API_TOKEN: 一个具有足够权限访问您存储桶的 InfluxDB API token

   使用API客户端和客户端库时，请牢记以下几点：

   • InfluxDB 忽略 org 和 org_id 参数在 API 写入和查询请求中，但某些客户端仍然需要这些参数。
   • 一些客户端使用 host 来指代你的 主机名，你的 InfluxDB Cloud Serverless 区域 URL 不带 https://。

   本入门教程中的所有API、cURL和客户端库示例都假设您的InfluxDB host、organization、url和token通过环境变量提供。

4. 可选： 创建一个存储桶。

   您可以使用现有的存储桶或创建一个新的存储桶专门用于本快速入门教程。本教程中的所有示例假设一个名为“get-started”的存储桶。

   使用InfluxDB UI、influx CLI或InfluxDB API来创建一个存储桶。

   InfluxDB 用户界面 influx 命令行工具 InfluxDB API

   1. 在浏览器中访问 cloud2.influxdata.com 登录并访问 InfluxDB 用户界面。

   2. 使用左侧导航栏导航到 加载数据 > 桶。

   加载数据

   3. 点击 + 创建存储桶.

   4. 提供一个桶名称 (get-started) 且选择一个 保留期。 支持的保留期取决于您的 InfluxDB Cloud Serverless 计划。

   5. 点击 创建.

   1. 如果您还没有，请下载、安装并配置 influx CLI。

   2. 使用influx bucket create命令创建一个新存储桶。

      提供以下内容:

      • -n, --name 标志与桶的名称。
      • -r, --retention 标志与桶的保留期持续时间。 支持的保留期取决于您的 InfluxDB Cloud Serverless 计划。
      • 连接和认证凭据

   influx bucket create \
     --name 
   get-started
    \
     --retention 
   7d
   

   要使用InfluxDB HTTP API创建一个桶，请使用POST请求方法向InfluxDB API /api/v2/buckets端点发送请求。

   POST https://cloud2.influxdata.com/api/v2/buckets

   请在您的请求中包含以下内容：

   • Headers:
     • Authorization: Token INFLUX_TOKEN
     • Content-Type: application/json
   • 请求体: JSON 对象，包含以下属性:
     • org: InfluxDB 组织名称
     • name: 桶名称
     • retentionRules: 定义桶的保留期限的保留规则对象列表。 每个保留规则对象具有以下属性:
       • type: "expire"
       • everySeconds: 保留期限持续时间（以秒为单位）。 支持的保留期限取决于您的 InfluxDB Cloud Serverless 计划。

   curl --request POST \
   "https://cloud2.influxdata.com/api/v2/buckets" \
     --header "Authorization: Token 
   $INFLUX_TOKEN" \
     --header "Content-Type: application/json" \
     --data '{
       "orgID": "'"
   $INFLUX_ORG_ID"'",
       "name": "
   get-started
   ",
       "retentionRules": [
         {
           "type": "expire",
           "everySeconds": 604800
         }
       ]
     }'