使用 Python 连接器建立连接
安装连接器
首先，您需要安装版本大于 2.6.2 的 taospy 模块，然后在终端里面执行下面的命令。
- Pip
- Conda
pip3 install -U taospy[ws]
您必须首先安装 Python3 。
conda install -c conda-forge taospy taospyws
配置
在您的终端里面执行下面的命令来保存 TDengine Cloud 的 URL 和令牌到系统的环境变量里面：
- Bash
- CMD
- Powershell
export TDENGINE_CLOUD_TOKEN="<token>"
export TDENGINE_CLOUD_URL="<url>"
set TDENGINE_CLOUD_TOKEN=<token>
set TDENGINE_CLOUD_URL=<url>
$env:TDENGINE_CLOUD_TOKEN='<token>'
$env:TDENGINE_CLOUD_URL='<url>'
另外您也可以在您的 IDE 的运行配置里面设置这些环境变量。
替换 <token> 和 <url> 为 TDengine Cloud 的令牌和 URL 。 获取 TDengine Cloud 的令牌和 URL，可以登录TDengine Cloud 后点击左边的”编程“菜单，然后选择”Python“。
建立连接
复制下面的代码到您的编辑器，然后执行这段代码。如果您正在使用 Jupyter 并且按照它的指南搭建好环境，您可以赋值下面代码到您浏览器的 Jupyter 编辑器。
- 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)
except Exception as e:
print(str(e))
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))
对于如何写入数据和查询输入，请参考<https://docs.taosdata.com/cloud/programming/insert/>和 <https://docs.taosdata.com/cloud/programming/query/>。
想知道更多通过 REST 接口写入数据的详情，请参考REST 接口.
Jupyter
步骤一：安装模块
对于熟悉使用 Jupyter 来进行 Python 编程的用户，在您的环境中必须准备好 TDengine 的 Python 连接器和 Jupyter。如果您还没有这样做，请使用下面的命令来安装他们。
- Pip
- Conda
pip3 install jupyterlab
pip3 install -U taospy[ws]
您接下来需要安装 Python3 。
conda install -c conda-forge jupyterlab
conda install -c conda-forge taospy
步骤二：配置
在使用 Jupyter 和 TDengine Cloud 连接连接之前，需要在环境变量设置按照下面内容设置，然后再启动 Jupyter。我们使用 Linux 脚本作为例子。
export TDENGINE_CLOUD_TOKEN="<token>"
export TDENGINE_CLOUD_URL="<url>"
jupyter lab
步骤三：建立连接
一旦 Jupter lab 启动成功，Jupyter lab 服务就会自动和 TDengine Cloud 连接并且显示在浏览器里面。您可以创建一个新的 notebook 页面，然后复制下面的样例代码到这个页面中并运行。
import taosrest
import os
url = os.environ["TDENGINE_CLOUD_URL"]
token = os.environ["TDENGINE_CLOUD_TOKEN"]
try:
conn = taosrest.connect(url=url, token=token)
except Exception as e:
print(str(e))
