编程-其他语言

Python API

1. 介绍

这是一个如何使用thrift rpc接口通过python连接到IoTDB的示例。 在Linux或Windows上情况会有所不同，我们将介绍如何分别在两个系统上进行操作。

2. Prerequisites

首选python3.7或更高版本。

您必须安装Thrift（0.11.0或更高版本）才能将我们的Thrift文件编译为python代码。 以下是安装的官方教程：

  1. http://thrift.apache.org/docs/install/

3. 如何获取Python库

选项1：pip安装

您可以在https://pypi.org/project/apache-iotdb/上找到Apache IoTDB Python客户端API软件包。 ​ 下载命令为：

  1. pip install apache-iotdb
选项2：使用我们提供的编译脚本

如果您在路径中添加了Thrift可执行文件，则可以只运行client-py / compile.sh或client-py \ compile.bat，或者必须对其进行修改以将变量THRIFT_EXE设置为指向 您的可执行文件。 这将在文件夹“target下生成节俭的源代码，您可以将其添加到PYTHONPATH中，以便可以在代码中使用该库。 请注意，这些脚本按相对路径查找节俭源文件，因此，如果将脚本移动到其他位置，它们将不再有效。

选项3：节俭的基本用法

或者，如果您了解Thrift的基本用法，则只能将Thrift源文件下载到service-rpc \ src \ main \ thrift \ rpc.thrift中，而只需使用thrift -gen py -out ./target/ iotdb rpc.thrift生成python库。

4. 使用范例

我们在client-py / src /client_example.py中提供了一个示例，说明如何使用Thrift库连接到IoTDB，在编写自己的代码之前，请仔细阅读。