未验证 提交 efd7b17b 编写于 作者: sangshuduo's avatar sangshuduo 提交者: GitHub

docs: connector refine (#11795)

* docs: refine connector doc

[TD-14839]

* docs: use TDengine CLI

[TD-14839]

* docs: replace JNI with navtive connection

[TD-14839]

* docs: make connectors doc use same preparition

[TD-14839]

* docs: refine connectors doc

[TD-14839]

* docs: refine connectors doc

[TD-14839]

* docs: refine connector docs

* docs: refine connector doc

[TD-14839]

* docs: refine connector doc

[TD-14839]
上级 c4a261da
......@@ -2,7 +2,7 @@
title: 连接器
---
TDengine 提供了丰富的应用程序开发接口,为了便于用户快速开发自己的应用,TDengine 支持了多种编程语言的连接器,其中官方连接器包括支持 C/C++、Java、Python、Go、Node.js、C# 等语言的连接器。这些连接器支持使用原生接口(taosc)连接和 REST 接口(部分语言暂不支持)连接 TDengine 数据库。社区开发者也贡献了多个非官方连接器,例如 Lua 连接器和 PHP 连接器。
TDengine 提供了丰富的应用程序开发接口,为了便于用户快速开发自己的应用,TDengine 支持了多种编程语言的连接器,其中官方连接器包括支持 C/C++、Java、Python、Go、Node.js、C# 和 Rust 的连接器。这些连接器支持使用原生接口(taosc)和 REST 接口(部分语言暂不支持)连接 TDengine 集群。社区开发者也贡献了多个非官方连接器,例如 Lua 连接器和 PHP 连接器。
![image-connector](/img/connector.png)
......@@ -24,19 +24,29 @@ TDengine 提供了丰富的应用程序开发接口,为了便于用户快速
其中 ● 表示官方测试验证通过,○ 表示非官方测试验证通过,-- 表示未经验证。
使用 REST 接口连接由于不依赖原生接口可以支持更广泛的操作系统。
使用 REST 连接由于不依赖客户端驱动可以支持更广泛的操作系统。
## 功能特性矩阵
## 版本支持
连接器对 TDengine 功能特性的支持对照矩阵如下[1]:
| **TDengine 版本** | **Java** | **Python** | **Go** | **C#** | **Node.js** | **Rust** |
| ---------------------- | -------- | ---------- | ------ | ------ | ----------- | -------- |
| **2.4.0.14 及以上** | 2.0.38 | | | | | |
| **2.4.0.6 及以上** | 2.0.37 | | | | | |
| **2.4.0.4 - 2.4.0.5** | 2.0.37 | | | | | |
| **2.2.x.x ** | 2.0.36 | | | | | |
| **2.0.x.x ** | 2.0.34 | | | | | |
## 功能特性
连接器对 TDengine 功能特性的支持对照如下[1]:
### 使用原生接口(taosc)
| **功能特性** | **Java** | **Python** | **Go** | **C#** | **Node.js** | **Rust** |
| ------------------ | --------- | ---------- | -------- | -------- | ----------- | -------- |
| **连接管理** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| **同步查询** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| **异步查询** | 不支持[2] | 支持 | 支持 | 支持 | 支持 | 暂不支持 |
| **普通查询** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| **连续查询** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| **参数绑定** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
| **订阅功能** | 支持 | 支持 | 支持 | 支持 | 支持 | 暂不支持 |
| **Schemaless** | 支持 | 支持 | 支持 | 支持 | 支持 | 支持 |
......@@ -46,23 +56,19 @@ TDengine 提供了丰富的应用程序开发接口,为了便于用户快速
| **功能特性** | **Java** | **Python(暂不支持)** | **Go** | **C#(暂不支持)** | **Node.js** | **Rust** |
| ----------------------------- | --------- | ---------------------- | -------- | -------------------- | ----------- | -------- |
| **连接管理** | 支持 | n/a | 支持 | n/a | 支持 | 支持 |
| **同步查询** | 支持 | n/a | 支持 | n/a | 支持 | 支持 |
| **异步查询** | 不支持[2] | n/a | 不支持 | n/a | 不支持 | 不支持 |
| **普通查询** | 支持 | n/a | 支持 | n/a | 支持 | 支持 |
| **连续查询** | 支持 | n/a | 支持 | n/a | 支持 | 支持 |
| **参数绑定** | 不支持 | n/a | 不支持 | n/a | 不支持 | 不支持 |
| **订阅功能** | 不支持 | n/a | 不支持 | n/a | 不支持 | 不支持 |
| **Schemaless** | 暂不支持 | n/a | 暂不支持 | n/a | 支持 | 暂不支持 |
| **Schemaless** | 暂不支持 | n/a | 暂不支持 | n/a | 暂不支持 | 暂不支持 |
| **批量拉取(基于WebSocket)** | 支持 | n/a | 暂不支持 | n/a | 暂不支持 | 暂不支持 |
备注:
[1]: 由于不同语言数据库框架规范不同,并不意味着所有 C/C++ 接口都需要对应封装支持。
[2]: JDBC 标准为同步查询。
:::warning
- 在没有安装 TDengine 服务端软件的系统中使用连接器以原生接口连接 TDengine 数据库,需要安装相应版本的客户端安装包来使客户端驱动(Linux 系统中文件名为 libtaos.so,Windows 系统中为 taos.dll)被安装在系统中,否则会产生无法找到相应库文件的错误。
- 所有执行 SQL 语句的 API,例如 C/C++ Connector 中的 `tao_query()`、`taos_query_a()`、`taos_subscribe()` 等,以及其它语言中与它们对应的 API,每次都只能执行一条 SQL 语句,如果实际参数中包含了多条语句,它们的行为是未定义的。
- 无论选用何种编程语言的连接器,2.0 及以上版本的 TDengine 推荐数据库应用的每个线程都建立一个独立的连接,或基于线程建立连接池,以避免连接内的“USE statement”状态量在线程之间相互干扰(但连接的查询和写入操作都是线程安全的)。
:::
......
......@@ -9,11 +9,11 @@
3. 执行安装脚本
解压软件包之后,会在解压目录下看到以下文件(目录):
- _ install_client.sh_:安装脚本,用于应用驱动程序
- _ taos.tar.gz_:应用驱动安装包
- _ driver_:TDengine 应用驱动 driver
- _connector_: 各种编程语言连接器(go/nodejs/python/JDBC)
- _examples_: 各种编程语言的示例程序(c/C#/go/JDBC/MATLAB/python/R)
- _ install_client.sh_:安装脚本,用于应用驱动程序
- _ taos.tar.gz_:应用驱动安装包
- _ driver_:TDengine 应用驱动 driver
- _connector_: 各种编程语言连接器(go/nodejs/python/JDBC)
- _examples_: 各种编程语言的示例程序(c/C#/go/JDBC/MATLAB/python/R)
运行 install_client.sh 进行安装。
4. 配置 taos.cfg
......
在 Linux shell 下直接执行 `taos` 连接到 TDegine 服务,进入到 TDengine CLI 界面,示例如下:
```sql
```text
$ taos
Welcome to the TDengine shell from Linux, Client Version:2.0.5.0
Copyright (c) 2017 by TAOS Data, Inc. All rights reserved.
......
在 cmd 下进入到 C:\TDengine 目录下直接执行 `taos.exe`,连接到 TDengine 服务,进入到 TDengine CLI 界面,示例如下:
```sql
```text
C:\TDengine>taos
Welcome to the TDengine shell from Linux, Client Version:2.0.5.0
Copyright (c) 2017 by TAOS Data, Inc. All rights reserved.
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册