文档文档

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++

Go

Java

JavaScript

PHP

Python

Ruby

安装和使用客户端库

要安装和使用 Python 客户端库,请按照以下说明。要安装和使用其他客户端库,请参阅客户端库文档以获取详细信息。

安装和使用 Python 客户端库

  1. 安装 Python 客户端库。

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

  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="https://127.0.0.1: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. 创建一个 point 对象,并使用 API 写入器对象的 write 方法将其写入 InfluxDB。write 方法需要三个参数:database、(可选) retention policy 和 record。

    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 开源版本现已可用于 alpha 测试,根据 MIT 或 Apache 2 许可获得许可。

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

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

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