Documentation

开始使用 InfluxDB Cloud Serverless

InfluxDB Cloud Serverless 是专门用于收集、存储、处理和可视化时间序列数据的平台。InfluxDB 3.0 存储引擎提供了许多好处,包括几乎无限的系列基数、改进的查询性能,以及与广泛使用的数据处理工具和平台的互操作性。

时间序列数据是一组按照时间顺序排列的数据点。 数据点通常由来自同一源的连续测量组成,用于跟踪随时间的变化。 时间序列数据的示例包括:

  • 工业传感器数据
  • 服务器性能指标
  • 每分钟心跳次数
  • 大脑中的电活动
  • 降雨量测量
  • 股票价格

本系列教程将引导您将时间序列数据写入 InfluxDB 云无服务器,查询并可视化这些数据。

开始之前的关键概念

在开始使用InfluxDB之前,了解时间序列数据是如何在InfluxDB中组织和存储的,以及本文件中使用的一些关键定义,是很重要的。

数据组织

InfluxDB Cloud Serverless 数据模型将时间序列数据组织为桶和测量。 一个桶可以包含多个测量。测量包含多个 标签和字段。

  • Bucket: 存储时间序列数据的命名位置。 一个桶可以包含多个 measurements
    • Measurement: 时间序列数据的逻辑分组。 给定测量中的所有 points 应具有相同的 tags。 一个测量包含多个 tagsfields
      • Tags: 为每个点提供元数据的键值对,例如, 用于识别数据源或上下文的信息,如主机、 位置、站点等。 标签值可以为空。
      • Fields: 随时间变化的键值对,例如, 温度、压力、股票价格等。 字段值可以为空,但在任何给定行上至少有一个字段值不为空。
      • Timestamp: 与数据关联的时间戳。 存储在磁盘上并查询时,所有数据按时间排序。 时间戳永远不为空。

写时模式

在使用InfluxDB时,您在写入数据时定义您的模式。 您不需要创建测量(相当于关系表)或 显式定义测量的模式。 测量模式是通过写入到测量的数据的模式定义的。

重要定义

使用InfluxDB时,以下定义非常重要:

  • : 由其 测量、标签键、标签值、字段键和时间戳 标识的单个数据记录。
  • 系列: 一组具有相同 测量、标签键和值,以及字段键 的点。
  • 主键: 用于唯一标识表中每一行的列。 行通过它们的 时间戳和标签集 进行唯一标识。 行的主键 标签集 不包括值为 null 的标签。
示例 InfluxDB 查询结果

名称: weather

时间城市国家温度湿度
2022-01-01T12:00:00Z伦敦英国12.088.4
2022-01-01T12:00:00Z科隆德国13.288.5
2022-02-01T12:00:00Z伦敦英国12.194.0
2022-02-01T12:00:00Z科隆德国11.587.8
2022-03-01T12:00:00Z伦敦英国11.582.1
2022-03-01T12:00:00Z科隆德国10.276.4
2022-04-01T12:00:00Z伦敦英国5.987.6
2022-04-01T12:00:00Z科隆德国7.993.3

可用工具

下面的表格比较了您可以用来与 InfluxDB Cloud Serverless 交互的工具。 本教程涵盖了许多推荐的工具。

工具管理写入查询
Chronograf--
influx CLI-
influx3 数据 CLI*-
influxctl 命令行界面---
InfluxDB HTTP API
InfluxDB用户界面 *-
InfluxDB 3 客户端库*-
InfluxDB v1 客户端库-
InfluxDB v2 客户端库-
Telegraf--
第三方工具
航班 SQL 客户端--
Grafana--
Superset--
Tableau--
* Covered in this tutorial

influxctl 管理 CLI 不适用于 InfluxDB Cloud Serverless。 它仅适用于 InfluxDB Cloud Dedicated 和 InfluxDB Clustered。

InfluxDB 用户界面

InfluxDB用户界面(UI)提供了一个基于网页的可视化接口,用于与InfluxDB交互和管理。要访问InfluxDB Cloud无服务器UI,登录到您的InfluxDB Cloud账户

influx 命令行界面

influx CLI 允许您管理 InfluxDB Cloud Serverless 并从命令行写入数据。查询 InfluxDB Cloud Serverless 不被支持。

有关详细的CLI安装说明,请参见influx CLI参考

influx3 数据命令行接口

influx3 数据 CLI 是一个社区维护的工具,可以让您从命令行编写和查询 InfluxDB Cloud Serverless 中的数据。它使用 HTTP API 来写入数据,并使用 Flight gRPC 查询数据。

InfluxDB HTTP API

InfluxDB HTTP API 提供了一种简单的方法,让您管理 InfluxDB Cloud Serverless,并使用 HTTP(S) 客户端进行数据的写入和查询。 本教程中的示例使用 cURL,但任何 HTTP(S) 客户端都可以使用。

与用户名/密码认证方案和现有的 InfluxDB 1.x 工具和代码兼容的 /write/query v1 端点。
与现有 InfluxDB 2.x 工具和代码兼容的 /api/v2/write v2 端点。

InfluxDB 客户端库

InfluxDB客户端库是由社区维护的特定语言客户端,用于与InfluxDB API交互。

InfluxDB 3 客户端库 是用于写入和查询 InfluxDB Cloud Serverless 数据的推荐客户端库。 它们使用 HTTP API 来写入数据,并使用 Flight gRPC 来查询数据。

InfluxDB v2 客户端库 可以使用 /api/v2 HTTP 端点来管理资源,如存储桶和 API 令牌,并在 InfluxDB 云无服务器中写入数据。

InfluxDB v1 客户端库 可以将数据写入 InfluxDB Cloud Serverless。

授权

InfluxDB Cloud Serverless 需要使用认证 通过 API tokens。 每个 API token 都与一个用户和一组特定的 InfluxDB 资源权限相关联。 您可以使用管理工具,例如 InfluxDB UI、influx CLI 或 InfluxDB HTTP API 来创建和管理 API tokens。



Flux的未来

Flux 正在进入维护模式。您可以像现在一样继续使用它,而无需对您的代码进行任何更改。

阅读更多

InfluxDB 3 开源版本现已公开Alpha测试

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

我们将发布两个产品作为测试版的一部分。

InfluxDB 3 核心,是我们新的开源产品。 它是一个用于时间序列和事件数据的实时数据引擎。 InfluxDB 3 企业版是建立在核心基础之上的商业版本,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度安全性。

有关如何开始的更多信息,请查看:

InfluxDB 云端无服务器