文档文档

安装 InfluxDB v2 JavaScript 客户端库

使用 InfluxDB 3 客户端进行查询

InfluxDB 3 支持使用 InfluxDB v2 和 v1 工具的 写入数据兼容性终结点。然而,/api/v2/query API 终结点和相关工具(例如 InfluxDB v2 客户端库和 influx CLI)无法查询存储在 InfluxDB 3 Core 中的数据。

提供了 InfluxDB 3 客户端库,它们可与您的代码集成,以写入和查询存储在 InfluxDB 3 Core 中的数据。

比较可用于与 InfluxDB 3 Core 交互的工具。

安装 Node.js

  1. 安装 Node.js

  2. 请确保 InfluxDB 正在运行并且您可以连接到它。有关连接到 InfluxDB 3 Core 集群时要使用的 URL 的信息,请联系您的 InfluxData 客户代表。

  3. 在终端中,为您的 Node.js 项目创建一个目录并进入该目录。

    mkdir influx-node-app && cd influx-node-app
  4. 输入以下命令为您的项目生成 npm 包。

    • npm:Node.js 附带的包管理器
    • -y:使用包的默认值并绕过提示
    npm init -y

安装 TypeScript

许多客户端库示例都使用 TypeScript。请按照以下步骤初始化 TypeScript 项目

  1. 安装 TypeScript 和 Node.js 的类型定义。

    npm i -g typescript && npm i --save-dev @types/node
  2. 输入以下命令创建一个具有默认值的 TypeScript 配置(tsconfig.json

    tsc --init
  3. 运行 TypeScript 编译器。要使您的代码在更改时自动重新编译,请将 --watch, -w 标志传递给编译器。

    tsc --watch

安装依赖项

使用 @influxdata/influxdb-client JavaScript 客户端库将数据写入 InfluxDB 3 Core。

打开一个新的终端窗口并安装 @influxdata/influxdb-client 包以查询和写入数据

npm i --save @influxdata/influxdb-client

@influxdata/influxdb-client-apis 客户端库包不适用于 InfluxDB 3 Core。它仅适用于 InfluxDB v2 管理 API。

配置凭据

客户端示例包含一个 env 模块,用于从环境变量或 env.js 访问您的 InfluxDB 属性。示例使用这些属性与 InfluxDB API 进行交互。

设置环境变量或使用您的 InfluxDB 数据库、组织(必需,但会被忽略)、数据库令牌和群集 URL 更新 env.js

export INFLUX_URL=https://:8181
export INFLUX_TOKEN=DATABASE_TOKEN
export INFLUX_ORG=ORG_ID
export INFLUX_DATABASE=DATABASE_NAME

替换以下内容:

  • DATABASE_TOKEN:InfluxDB 数据库令牌
  • ORG_ID:任意字符串(InfluxDB 会忽略此凭据,但客户端库需要它)
  • DATABASE_NAME:InfluxDB 数据库名称

下一步

安装客户端库并配置好凭据后,您就可以 写入数据 到 InfluxDB 了。


此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2