文档文档

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,请访问 http://localhost: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="http://localhost:8086",
    token=token,
    

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

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

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

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

此页内容对您有帮助吗?

感谢您的反馈!


Flux 的未来

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

阅读更多

现已全面上市

InfluxDB 3 Core 和 Enterprise

快速启动。更快扩展。

获取更新

InfluxDB 3 Core 是一个开源、高速、近实时数据引擎,可实时收集和处理数据,并将其持久化到本地磁盘或对象存储。InfluxDB 3 Enterprise 构建在 Core 的基础上,增加了高可用性、读取副本、增强的安全性以及数据压缩,从而实现更快的查询和优化的存储。InfluxDB 3 Enterprise 的免费层可供非商业家庭或业余爱好者使用。

有关更多信息,请查看