Documentation

InfluxDB 客户端库

本页面记录了早期版本的 InfluxDB OSS。InfluxDB OSS v2 是最新的稳定版本。请参阅等效的 InfluxDB v2 文档: 使用 InfluxDB 客户端库

InfluxDB v2 客户端库是特定语言的软件包,集成了 InfluxDB v2 API,并支持 InfluxDB 1.8+InfluxDB 2.x

如果您刚开始使用 InfluxDB v1,我们建议使用 InfluxDB v1 客户端库和 InfluxQL 来进行 InfluxDB 3 兼容性

有关API和客户端库兼容性更多信息,请参见 InfluxDB v1 API参考

客户端库

功能在客户端库之间有所不同。有关每个客户端库的具体信息,请参阅GitHub上的客户端库。

Arduino

C#

C++

Java

JavaScript

PHP

Python

鲁比

安装和使用客户端库

要安装和使用Python客户端库,请遵循下面的说明。要安装和使用其他客户端库,请参考客户端库文档以获取详细信息。

安装并使用Python客户端库

  1. 安装Python客户端库。

    pip install influxdb-client
    
  2. 确保 InfluxDB 正在运行。如果在本地运行 InfluxDB,请访问 http://localhost:8086。 (如果使用 InfluxDB Cloud,请访问您的 InfluxDB Cloud UI 的网址。)

  3. 在您的程序中,导入客户端库并使用它将数据写入InfluxDB。例如:

    import influxdb_client
    from influxdb_client.client.write_api import SYNCHRONOUS
    
  4. 定义您的数据库和令牌变量,并创建客户端和写入对象。InfluxDBClient 对象需要 2 个参数: urltoken

    database = "<my-db>"
    token = "<my-token>"
    client = influxdb_client.InfluxDBClient(
    url="http://localhost:8086",
    token=token,
    

    数据库(以及保留策略,如果适用)被转换为与 InfluxDB v2 兼容的 bucket 数据存储。

  5. 使用客户端对象和 write_api 方法实例化一个写入对象。使用 write_api 方法来配置写入对象。

    client = influxdb_client.InfluxDBClient(url=url, token=token)
    write_api = client.write_api(write_options=SYNCHRONOUS)
    
  6. 创建一个点对象,并使用API写入器对象的写入方法将其写入InfluxDB。写入方法需要三个参数:数据库,(可选)保留策略和记录。

    p = influxdb_client.Point("my_measurement").tag("location", "Prague").field("temperature", 25.3)
    write_api.write(database:rp, record=p)
    


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 企业版是建立在核心基础之上的商业版本,增加了历史查询能力、读取副本、高可用性、可扩展性和细粒度安全性。

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