8.3 KiB
| title | description |
|---|---|
| 建立连接 | 本节介绍如何使用连接器建立与 TDengine 的连接，给出连接器安装、连接的简单说明。 |
import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; import ConnJava from "./_connect_java.mdx"; import ConnGo from "./_connect_go.mdx"; import ConnRust from "./_connect_rust.mdx"; import ConnNode from "./_connect_node.mdx"; import ConnPythonNative from "./_connect_python.mdx"; import ConnCSNative from "./_connect_cs.mdx"; import ConnC from "./_connect_c.mdx"; import ConnR from "./_connect_r.mdx"; import ConnPHP from "./_connect_php.mdx"; import InstallOnWindows from "../../14-reference/03-connector/_linux_install.mdx"; import InstallOnLinux from "../../14-reference/03-connector/_windows_install.mdx"; import VerifyLinux from "../../14-reference/03-connector/_verify_linux.mdx"; import VerifyWindows from "../../14-reference/03-connector/_verify_windows.mdx";
TDengine 提供了丰富的应用程序开发接口，为了便于用户快速开发自己的应用，TDengine 支持了多种编程语言的连接器，其中官方连接器包括支持 C/C++、Java、Python、Go、Node.js、C#、Rust、Lua（社区贡献）和 PHP （社区贡献）的连接器。这些连接器支持使用原生接口（taosc）和 REST 接口（部分语言暂不支持）连接 TDengine 集群。社区开发者也贡献了多个非官方连接器，例如 ADO.NET 连接器、Lua 连接器和 PHP 连接器。
连接器建立连接的方式
连接器建立连接的方式，TDengine 提供两种:
- 通过 taosAdapter 组件提供的 REST API 建立与 taosd 的连接，这种连接方式下文中简称“REST 连接”
- 通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接，这种连接方式下文中简称“原生连接”。
无论使用何种方式建立连接，连接器都提供了相同或相似的 API 操作数据库，都可以执行 SQL 语句，只是初始化连接的方式稍有不同，用户在使用上不会感到什么差别。
关键不同点在于：
安装客户端驱动 taosc
如果选择原生连接，而且应用程序不在 TDengine 同一台服务器上运行，你需要先安装客户端驱动，否则可以跳过此一步。为避免客户端驱动和服务端不兼容，请使用一致的版本。
安装步骤
安装验证
以上安装和配置完成后，并确认 TDengine 服务已经正常启动运行，此时可以执行安装包里带有的 TDengine 命令行程序 taos 进行登录。
安装连接器
如果使用 maven 管理项目，只需在 pom.xml 中加入以下依赖。
<dependency>
<groupId>com.taosdata.jdbc</groupId>
<artifactId>taos-jdbcdriver</artifactId>
<version>2.0.38</version>
</dependency>
使用 pip 从 PyPI 安装:
pip install taospy
从 Git URL 安装：
pip install git+https://github.com/taosdata/taos-connector-python.git
编辑 go.mod 添加 driver-go 依赖即可。
module goexample
go 1.17
require github.com/taosdata/driver-go/v2 develop
:::note driver-go 使用 cgo 封装了 taosc 的 API。cgo 需要使用 gcc 编译 C 的源码。因此需要确保你的系统上有 gcc。
:::
编辑 Cargo.toml 添加 libtaos 依赖即可。
[dependencies]
libtaos = { version = "0.4.2"}
:::info
Rust 连接器通过不同的特性区分不同的连接方式。如果要建立 REST 连接，需要开启 rest 特性：
libtaos = { version = "*", features = ["rest"] }
:::
Node.js 连接器通过不同的包提供不同的连接方式。
- 安装 Node.js 原生连接器
npm i td2.0-connector
:::note
推荐 Node 版本大于等于 node-v12.8.0 小于 node-v13.0.0
:::
- 安装 Node.js REST 连接器
npm i td2.0-rest-connector
编辑项目配置文件中添加 TDengine.Connector 的引用即可：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net6.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<StartupObject>TDengineExample.AsyncQueryExample</StartupObject>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="TDengine.Connector" Version="1.0.6" />
</ItemGroup>
</Project>
也可通过 dotnet 命令添加：
dotnet add package TDengine.Connector
:::note 以下示例代码，均基于 dotnet6.0，如果使用其它版本，可能需要做适当调整。
:::
- 下载 taos-jdbcdriver-version-dist.jar。
- 安装 R 的依赖包
RJDBC：
install.packages("RJDBC")
如果已经安装了 TDengine 服务端软件或 TDengine 客户端驱动 taosc， 那么已经安装了 C 连接器，无需额外操作。
下载代码并解压：
curl -L -o php-tdengine.tar.gz https://github.com/Yurunsoft/php-tdengine/archive/refs/tags/v1.0.2.tar.gz \
&& mkdir php-tdengine \
&& tar -xzf php-tdengine.tar.gz -C php-tdengine --strip-components=1
版本
v1.0.2只是示例，可替换为任意更新的版本，可在 TDengine PHP Connector 发布历史 中查看可用版本。
非 Swoole 环境：
phpize && ./configure && make -j && make install
手动指定 TDengine 目录：
phpize && ./configure --with-tdengine-dir=/usr/local/Cellar/tdengine/2.4.0.0 && make -j && make install
--with-tdengine-dir=后跟上 TDengine 目录。 适用于默认找不到的情况，或者 macOS 系统用户。
Swoole 环境：
phpize && ./configure --enable-swoole && make -j && make install
启用扩展：
方法一：在 php.ini 中加入 extension=tdengine
方法二：运行带参数 php -d extension=tdengine test.php
建立连接
在执行这一步之前，请确保有一个正在运行的，且可以访问到的 TDengine，而且服务端的 FQDN 配置正确。以下示例代码，都假设 TDengine 安装在本机，且 FQDN（默认 localhost） 和 serverPort（默认 6030） 都使用默认配置。
:::tip 如果建立连接失败，大部分情况下是 FQDN 或防火墙的配置不正确，详细的排查方法请看《常见问题及反馈》中的“遇到错误 Unable to establish connection, 我怎么办？”
:::