InfluxDB 3 Explorer 入门

通过连接到 InfluxDB 3 实例、向 InfluxDB 写入数据，然后查询该数据来开始使用 InfluxDB 3 Explorer。本指南将引导您完成所有这些步骤。

1. 连接到 InfluxDB 3 服务器
2. 将数据写入 InfluxDB
3. 从 InfluxDB 查询数据

连接到 InfluxDB 3 服务器

InfluxDB 3 Explorer 支持以下 InfluxDB 3 产品

• InfluxDB 3 Core
• InfluxDB 3 Enterprise
• InfluxDB Cloud Serverless (仅限查询模式)
• InfluxDB Cloud Dedicated (仅限查询模式)

1. 导航到 配置 > 服务器。

2. 点击 + 连接您的第一个服务器。

3. 提供以下 InfluxDB 3 服务器信息

   • 服务器名称：用于标识您正在连接的 InfluxDB 3 服务器的名称。

   • 服务器 URL：用于连接到 InfluxDB 3 服务器的 URL。

     • URL 取决于您的 InfluxDB 3 实例的运行方式和位置。有关更多信息，请参阅 何时使用 host.docker.internal。
     • 选择要使用的协议（http 或 https）。
     • 提供主机，如果需要，请提供端口。

     何时使用 host.docker.internal

     如果您的 InfluxDB 3 实例在 Docker 中运行（与 Explorer 不在同一个容器中），请使用 host.docker.internal 作为您的服务器主机，以允许 Explorer 容器连接到主机上的 InfluxDB 容器 – 例如：

     "DEFAULT_INFLUX_SERVER": "http://host.docker.internal:8181"

     • 如果 Explorer 和 InfluxDB 都在同一个 Docker 网络中，请改用容器名称。
     • 如果 InfluxDB 在您的计算机上本地运行（不在 Docker 中），请使用 localhost。

     有关更多信息，请参阅 Docker 网络文档。

   • 令牌：用于连接到 InfluxDB 3 服务器的授权令牌。我们建议使用 InfluxDB 3 管理员令牌。

     令牌权限可能会限制 Explorer 的功能

     与提供的令牌关联的权限决定了您可以使用此服务器配置访问哪些数据库。权限受限的 InfluxDB 3 令牌可能无法使用某些 Explorer 功能。

4. 点击 添加服务器。

InfluxDB 3 Explorer 会尝试验证连接。如果成功，Explorer 将保存服务器配置并将其选为活动服务器。

将数据写入 InfluxDB

InfluxDB 3 Explorer 允许您向 InfluxDB 3 写入数据，并提供多种选项。在本入门指南中，请使用 Explorer 将一个示例数据集写入 InfluxDB。

1. 导航到 写入数据 > 示例/开发数据。
2. 选择任何可用的示例数据集。
3. 点击 写入示例数据。

InfluxDB 3 Explorer 会创建一个新数据库，然后将示例数据写入该数据库。

其他写入方法

InfluxDB 3 Explorer 提供了其他写入数据到 InfluxDB 的方法，包括以下方法：

• 行协议
• CSV 或 JSON
• InfluxDB 3 客户端库
• Telegraf

从 InfluxDB 查询数据

要使用 InfluxDB 3 Explorer 从 InfluxDB 3 查询数据，请导航到 查询数据 > 数据浏览器。

数据浏览器允许您探索数据库的模式，并通过在模式浏览器中选择列，或者通过使用 InfluxDB 3 Explorer AI 集成的自然语言来自动生成 SQL 查询。

在本入门指南中，请使用模式浏览器构建一个 SQL 查询，该查询将返回来自新写入的示例数据集的数据。

1. 在数据浏览器的模式列中，从数据库下拉菜单中选择要查询的数据库。选择后，将显示数据库中的所有表。
2. 点击要查询的表的名称以展开并查看该表中的所有列。
3. 选择要查询的每一列。当您在模式浏览器中选择列时，Explorer 会在查询窗格中生成并更新 SQL 查询。
4. 使用查询窗格上方的下拉时间范围菜单选择要查询的时间范围。您可以选择预定义的相对时间范围之一，也可以选择自定义范围来定义要查询的绝对时间范围。
5. 选择列和时间范围后，点击 运行查询。

InfluxDB 3 Explorer 会运行查询并在结果窗格中返回结果。结果窗格提供三种查看选项：

• 表（默认）：以分页表格式显示原始查询结果。
• 折线图：以折线图显示查询结果。
• 柱状图：以柱状图显示查询结果。

您已成功使用 InfluxDB 3 Explorer 连接到 InfluxDB 3 实例、向其写入数据以及从中查询数据。

视频演练