使用 Python 连接器建立连接

安装连接器

安装前准备

您必须先安装 Python3 和 Pip3。

安装 Python。新版本 taospy 包要求 Python 3.6.2+。早期版本 taospy 包要求 Python 3.7+。taos-ws-py 包要求 Python 3.7+。如果系统上还没有 Python 可参考 Python BeginnersGuide 安装。
安装 Pip3。大部分情况下 Python 的安装包都自带了 pip 工具，如果没有请参考 pip documentation 安装。

用 Pip 安装

如果以前安装过旧版本的 Python 连接器, 请提前卸载。

REST
WebSocket

pip3 uninstall taos taospy

pip3 uninstall taos taos-ws-py

安装最新或指定版本 taospy 或 taos-ws-py, 在终端里面执行下面的命令。

REST
WebSocket

# 安装最新版本
pip3 install taospy

# 安装指定版本
pip3 install taospy==2.6.2

# 从 GitHub 安装
pip3 install git+https://github.com/taosdata/taos-connector-python.git

pip3 install taos-ws-py

安装验证

REST
WebSocket

对于 REST 连接，只需验证是否能成功导入 taosrest 模块。可在 Python 交互式 Shell 中输入：

import taosrest

对于 WebSocket 连接，只需验证是否能成功导入 taosws 模块。可在 Python 交互式 Shell 中输入：

import taosws

配置

在您的终端里面执行下面的命令来保存 TDengine Cloud 的 URL 和令牌到系统的环境变量里面：

Bash
CMD
Powershell

export TDENGINE_CLOUD_URL="<url>"
export TDENGINE_CLOUD_TOKEN="<token>"

set TDENGINE_CLOUD_URL=<url>
set TDENGINE_CLOUD_TOKEN=<token>

$env:TDENGINE_CLOUD_URL='<url>'
$env:TDENGINE_CLOUD_TOKEN='<token>'

另外您也可以在您的 IDE 的运行配置里面设置这些环境变量。

IMPORTANT

替换 <token> 和 <url> 为您的 TDengine Cloud 实例的令牌和 URL 。

获取 TDengine Cloud 的令牌和 URL，可以登录TDengine Cloud 后点击左边的”编程“菜单，然后选择”Python“。

请注意区分 REST 连接和 WebSocket 连接的URL。

建立连接

复制下面的代码到您的编辑器，然后执行这段代码。

REST
WebSocket

import taosrest
import os

url = os.environ["TDENGINE_CLOUD_URL"]
token = os.environ["TDENGINE_CLOUD_TOKEN"]

try:
    conn = taosrest.connect(url=url, token=token)
    # test the connection by getting version info
    print("TDengine version: ", conn.server_info)
except Exception as e:
    print(str(e))

查看源码

connect() 函数的所有参数都是可选的关键字参数。下面是连接参数的具体说明：

url： TDengine Cloud 的URL。
token: TDengine Cloud 的令牌.
timeout: HTTP 请求超时时间。单位为秒。默认为 socket._GLOBAL_DEFAULT_TIMEOUT。一般无需配置。

import taosws
import os

url = os.environ["TDENGINE_CLOUD_URL"]
token = os.environ["TDENGINE_CLOUD_TOKEN"]

try:
    conn = taosws.connect("%s?token=%s" % (url, token))
except Exception as e:
    print(str(e))