文档文档

InfluxDB v2 JavaScript 客户端库,用于 Web 浏览器

使用 InfluxDB 3 客户端

/api/v2/query API 端点和相关工具(例如 InfluxDB v2 客户端库和 influx CLI)无法查询 InfluxDB 集群。

InfluxDB 3 客户端库Flight SQL 客户端 可用于与您的代码集成,以写入和查询存储在 InfluxDB Clustered 中的数据。

InfluxDB 3 支持许多不同的工具,用于 写入查询 数据。 比较您可以使用的工具 以与 InfluxDB Clustered 交互。

在浏览器和前端客户端中使用 InfluxDB v2 JavaScript 客户端库 将数据写入 InfluxDB Clustered 数据库。

该库同时支持前端和服务器端环境,并提供以下发行版

  • ECMAScript 模块 (ESM) 和 CommonJS 模块 (CJS)
  • 捆绑的 ESM
  • 捆绑的 UMD

本指南假定您对 JavaScript、浏览器环境和 InfluxDB 有一定的了解。如果您刚开始使用 InfluxDB,请参阅InfluxDB 入门

生产应用程序中的令牌

以下示例仅出于演示目的在源代码中配置身份验证令牌。为了保护您的数据,请采取以下步骤

  1. 避免将令牌发送到公共客户端,例如 Web 浏览器和移动应用。将发送到客户端设备的任何应用程序密钥都视为公开而非机密。

  2. 尽可能使用短生命周期、只读令牌,以防止未经授权的写入和删除。

开始之前

  1. 安装 Node.js 以服务您的前端应用程序。

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

与模块捆绑器一起使用

如果您使用像 Webpack 或 Parcel 这样的模块捆绑器,请安装 @influxdata/influxdb-client-browser

将捆绑的发行版与浏览器和模块加载器一起使用

  1. 为您的脚本配置 InfluxDB 属性。

    <script>
      window.INFLUX_ENV = {
        url: 'https://cluster-host.com',
        token: 'DATABASE_TOKEN'
      }
    </script>
    
  2. 从最新的客户端库浏览器发行版导入模块。@influxdata/influxdb-client-browser 导出捆绑的 ESM 和 UMD 语法。

    <script type="module">
      import {InfluxDB, Point} from 'https://unpkg.com/@influxdata/influxdb-client-browser/dist/index.browser.mjs'
    
      const influxDB = new InfluxDB({INFLUX_ENV.url, INFLUX_ENV.token})
    </script>
    
    <script src="https://unpkg.com/@influxdata/influxdb-client-browser"></script>
    <script>
      const Influx = window['@influxdata/influxdb-client']
    
      const InfluxDB = Influx.InfluxDB
      const influxDB = new InfluxDB({INFLUX_ENV.url, INFLUX_ENV.token})
    </script>
    

导入客户端库后,您就可以开始使用示例应用程序写入数据了。

开始使用示例应用程序

客户端库包含一个示例浏览器应用程序,该应用程序写入您的 InfluxDB 实例。

  1. 克隆 influxdb-client-js 仓库。

  2. 导航到 examples 目录

    cd examples
    
  3. 使用您的 InfluxDB 集群 URL、您的数据库名称(作为 bucket)、任意字符串(作为 org)和您的数据库令牌更新 ./env_browser.js

  4. 运行以下命令以在 https://#:3001/examples/index.html 启动应用程序

    npm run browser
    

    index.html 加载 env_browser.js 配置、客户端库 ESM 模块以及浏览器中的应用程序。

有关更多示例,请参阅如何使用适用于 Node.js 的 JavaScript 客户端库写入数据


此页是否对您有帮助?

感谢您的反馈!


Flux 的未来

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

阅读更多

InfluxDB 3 开源版本现已发布公开 Alpha 版

InfluxDB 3 开源版本现已可用于 Alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

我们正在发布两个产品作为 Alpha 版的一部分。

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

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