开始使用 InfluxDB Cloud Dedicated
InfluxDB 是专为收集、存储和查询时间序列数据而构建的平台。InfluxDB Cloud Dedicated 由 InfluxDB 3.0 存储引擎提供支持,该引擎提供几乎无限的数据系列基数,提高了查询性能,并且与广泛使用的数据处理工具和平台互操作。
时间序列数据 是按时间顺序索引的数据点序列。数据点通常由同一来源的连续测量组成,用于跟踪随时间的变化。时间序列数据的示例包括
- 工业传感器数据
- 服务器性能指标
- 每分钟心跳次数
- 大脑中的电活动
- 降雨量测量
- 股票价格
本多部分教程将指导您如何将时间序列数据写入 InfluxDB Cloud Dedicated,查询,然后可视化这些数据。
开始之前的关键概念
在开始使用 InfluxDB 之前,了解时间序列数据在 InfluxDB 中的组织和存储方式以及本文档中使用的某些关键定义非常重要。
数据组织
InfluxDB Cloud Dedicated 数据模型将时间序列数据组织到数据库和表中。
一个数据库可以包含多个表。表包含多个标签和字段。
- 数据库:存储在 表 中时间序列数据的命名位置。《数据库》在 InfluxDB Cloud Serverless 和 InfluxDB TSM 中与 桶 同义。
- 表:时间序列数据的逻辑分组。给定表中的所有 点 应具有相同的 标签。表包含 标签 和 字段。《表》在 InfluxDB Cloud Serverless 和 InfluxDB TSM 中与 测量 同义。
- 标签:为每个点提供元数据的键值对——例如,用于标识数据源或上下文的信息,如主机、位置、站点等。标签值可以为空。
- 字段:具有随时间变化的值的键值对——例如,温度、压力、股票价格等。字段值可以为空,但任何给定行上至少有一个字段值不为空。
- 时间戳:与数据关联的时间戳。当存储在磁盘上并查询时,所有数据均按时间顺序排列。时间戳永远不会为空。
- 表:时间序列数据的逻辑分组。给定表中的所有 点 应具有相同的 标签。表包含 标签 和 字段。《表》在 InfluxDB Cloud Serverless 和 InfluxDB TSM 中与 测量 同义。
关于桶和测量怎么办?
如果来自InfluxDB云无服务器或由TSM存储引擎驱动的InfluxDB,您可能熟悉桶和测量这两个概念。TSM或InfluxDB云无服务器中的桶与InfluxDB云专用中的数据库同义。测量在TSM或InfluxDB云无服务器中与InfluxDB云专用中的表同义。
写入时模式
当您向InfluxDB写入数据时,数据定义了表模式。您不需要创建表或显式定义表模式。
重要定义
以下定义在使用InfluxDB时非常重要
- 点:由其测量、标签键、标签值、字段键和时间戳标识的单个数据记录。
- 系列:具有相同测量、标签键和值以及字段键的一组点。
- 主键:用于在表中唯一标识每行的列。行通过其时间戳和标签集唯一标识。一行的主键标签集不包括具有null值的标签。
InfluxDB查询结果的示例
name: weather
time | city | country | temperature | humidity |
---|---|---|---|---|
2022-01-01T12:00:00Z | London | UK | 12.0 | 88.4 |
2022-01-01T12:00:00Z | Cologne | DE | 13.2 | 88.5 |
2022-02-01T12:00:00Z | London | UK | 12.1 | 94.0 |
2022-02-01T12:00:00Z | Cologne | DE | 11.5 | 87.8 |
2022-03-01T12:00:00Z | London | UK | 11.5 | 82.1 |
2022-03-01T12:00:00Z | Cologne | DE | 10.2 | 76.4 |
2022-04-01T12:00:00Z | London | UK | 5.9 | 87.6 |
2022-04-01T12:00:00Z | Cologne | DE | 7.9 | 93.3 |
要使用的工具
以下表格比较了您可以用于与InfluxDB云专用交互的工具。本教程涵盖了其中许多推荐工具。
工具 | 管理 | 写入 | 查询 |
---|---|---|---|
Chronograf | - | - | |
influx CLI | - | - | - |
influxctl CLI* | |||
influx3 data CLI* | - | ||
InfluxDB HTTP API* | - | ||
InfluxDB用户界面 | - | - | - |
InfluxDB v3客户端库* | - | ||
InfluxDB v2客户端库 | - | - | |
InfluxDB v1客户端库 | - | ||
Telegraf* | - | - | |
第三方工具 | |||
Flight SQL客户端 | - | - | |
Grafana | - | - | |
Superset | - | - | |
Tableau | - | - |
避免使用influx
CLI与InfluxDB云专用一起使用。虽然它可能偶然工作,但不受支持。
influxctl
CLI
influxctl
命令行界面 (CLI)可以写入、查询并执行管理任务,例如在集群中管理数据库和授权令牌。
influx3
data CLI
influx3
data CLI是一个社区维护的工具,它允许您从命令行写入和查询InfluxDB云专用中的数据。它使用HTTP API写入数据,并使用Flight gRPC查询数据。
InfluxDB HTTP API
InfluxDB HTTP API
提供了一种简单的方法,让您可以通过HTTP(S)客户端管理InfluxDB云专用以及写入和查询数据。本教程中的示例使用cURL,但任何HTTP(S)客户端都适用。
兼容v1的/write
和/query
端点与用户名/密码身份验证方案以及现有的InfluxDB 1.x工具和代码一起工作。兼容v2的/api/v2/write
端点与现有的InfluxDB 2.x工具和代码一起工作。
InfluxDB客户端库
InfluxDB客户端库是社区维护的、特定语言的客户端,可以与InfluxDB API交互。
InfluxDB v3
客户端库是写入和查询InfluxDB云专用数据的推荐客户端库。它们使用HTTP API写入数据,并使用InfluxDB的Flight gRPC API查询数据。
InfluxDB v2
客户端库可以使用/api/v2
HTTP端点管理资源,如桶和API令牌,并在InfluxDB云专用中写入数据。
InfluxDB v1
客户端库可以写入InfluxDB云专用数据。
授权
InfluxDB Cloud Dedicated需要使用以下其中一种令牌类型进行身份验证
数据库令牌:一种允许读取和写入InfluxDB数据库的令牌。
管理令牌:由
influxctl
CLI生成的Auth0身份验证令牌,用于管理您的InfluxDB集群。管理令牌授权用户执行以下相关任务- 账户管理
- 数据库管理
- 数据库令牌管理
- 定价
默认情况下,管理令牌是
- 短暂有效的
- 针对特定用户发行
- 由OAuth2身份提供者发行
- 由
influxctl
管理,不需要用户管理
但是,出于自动化的目的,influxctl
用户可以手动创建一个长期有效管理令牌,以用于InfluxDB Cloud Dedicated管理API。手动创建的管理令牌将直接与您的InfluxDB集群进行身份验证,不需要与身份提供者进行人工交互。
这个页面有帮助吗?
感谢您的反馈!