From 1b0044c2475d0269e639dc41a0b3d12e4c619c2c Mon Sep 17 00:00:00 2001 From: Jeff Tao Date: Sat, 16 Apr 2022 21:21:29 -0700 Subject: [PATCH] Update index.mdx --- docs-cn/04-connect/index.mdx | 44 ++++++++++++++++++++++++++++-------- 1 file changed, 35 insertions(+), 9 deletions(-) diff --git a/docs-cn/04-connect/index.mdx b/docs-cn/04-connect/index.mdx index 8d769de8f0..d588792552 100644 --- a/docs-cn/04-connect/index.mdx +++ b/docs-cn/04-connect/index.mdx @@ -14,21 +14,47 @@ import ConnCSNative from "./_connect_cs_native.mdx"; import ConnC from "./_connect_c.mdx"; import ConnR from "./_connect_r.mdx"; -TDengine 提高了多种编程语言的连接器方便用户开发应用程序。本节介绍如何使用连接器建立与 TDengine 的连接。 +TDengine 提供RESTful接口，容许在任何平台的任何应用程序通过它访问TDengine运行实例，详细介绍请看 [RESTful API](https://docs.taosdata.com/reference/restful-api/)。除RESTful之外，TDengine还提供多种编程语言的连接器方便用户开发应用程序，其中包括 C/C++、Java、Python、Go、Node.js、C# 、RESTful 等。 本节介绍如何使用连接器建立与 TDengine 的连接。 ## 连接器建立连接的方式 -连接器建立连接的方式，从本质上分为三种: - 1. 通过 taosAdapter 组件提供的 RESTful API 建立连接。 - 2. 通过 taosAdapter 组件提供的 WebSocket API 建立连接（目前只有 Java 连接器支持）。 - 3. 通过客户端驱动程序直接与服务端程序 taosd 建立连接，这种连接方式下文中简称“本地连接”。 +连接器建立连接的方式，TDengine提供两种: + 1. 通过 taosAdapter 组件提供的 RESTful API 建立与 taosd 的连接，这种连接方式下文中简称" + 2. 通过客户端驱动程序 taosc 直接与服务端程序 taosd 建立连接，这种连接方式下文中简称“本地连接”。 -无论使用何种方式建立连接，连接器都提供了相同或相似的 API 操作数据库，都可以执行 SQL 语句，只是初始化连接的方式稍有不同，用户在使用上不会感到太大差别。 +无论使用何种方式建立连接，连接器都提供了相同或相似的 API 操作数据库，都可以执行 SQL 语句，只是初始化连接的方式稍有不同，用户在使用上不会感到什么差别。 关键不同点在于： -1. 使用 RESTful 方式，用户无需安装客户端驱动程序，具有跨平台和易用的优势。 -2. WebSocket 方式可以看作对 RESTful 方式的优化，在批量拉取大量数据的场景具有性能优势。 -3. 使用本地连接可以体验 TDengine 的全部功能，如[原生接口写入](/reference/connector/cpp#参数绑定-api)、[订阅](reference/connector/cpp#数据订阅接口)等等。 +1. 使用 RESTful 方式，用户无需安装客户端驱动程序 taosc，具有跨平台易用的优势，但性能要下降30%左右。 +2. 使用本地连接可以体验 TDengine 的全部功能，如[原生接口写入](/reference/connector/cpp#参数绑定-api)、[订阅](reference/connector/cpp#数据订阅接口)等等。 + +## 安装客户端驱动taosc + +如果选择本地连接，而且应用程序不在TDengine同一台服务器上运行，你需要先安装客户端驱动，否则可以跳过此一步。 + +### 安装步骤 + + + + + + + + + + +### 安装验证 + +以上安装和配置完成后，并确认 TDengine 服务已经正常启动运行，此时可以执行 taos 客户端进行登录。 + + + + + + + + + ## 安装连接器 -- GitLab