diff --git a/docs-cn/14-reference/03-connector/go.mdx b/docs-cn/14-reference/03-connector/go.mdx index 469508733f679d194bafb82ffa8fb863377f5da6..3ede900e55380a064d863d74f5119a2f7ec32cb9 100644 --- a/docs-cn/14-reference/03-connector/go.mdx +++ b/docs-cn/14-reference/03-connector/go.mdx @@ -15,9 +15,9 @@ import GoOpenTSDBTelnet from "../../04-develop/03-insert-data/_go_opts_telnet.md import GoOpenTSDBJson from "../../04-develop/03-insert-data/_go_opts_json.mdx" import GoQuery from "../../04-develop/04-query-data/_go.mdx" -`driver-go` 是 TDengine 的官方 Go 语言连接器。Go 开发人员可以通过它开发存取 TDengine 集群数据的应用软件。 +`driver-go` 是 TDengine 的官方 Go 语言连接器,实现了 Go 语言[ database/sql ](https://golang.org/pkg/database/sql/) 包的接口。Go 开发人员可以通过它开发存取 TDengine 集群数据的应用软件。 -`driver-go` 实现了 Go 语言[ database/sql ](https://golang.org/pkg/database/sql/) 包的接口。`driver-go` 支持通过客户端驱动程序(taosc)原生连接 TDengine 集群,支持数据写入、查询、订阅、schemaless 接口和参数绑定接口等功能。也支持使用 REST 接口连接 TDengine 集群。REST 接口实现的功能特性集合和原生接口有少量不同。 +`driver-go` 提供两种形式的连接器。一种是原生连接器,它通过 TDengine 客户端驱动程序(taosc)原生连接 TDengine 集群,支持数据写入、查询、订阅、schemaless 接口和参数绑定接口等功能。另外一种是 REST 连接器,它通过 taosAdapter 提供的 REST 接口连接 TDengine 集群。REST 连接实现的功能特性集合和原生连接有少量不同。 本文介绍如何安装 `driver-go`,并通过 `driver-go` 连接 TDengine 集群、进行数据查询、数据写入等基本操作。 @@ -35,7 +35,7 @@ import GoQuery from "../../04-develop/04-query-data/_go.mdx" ### 原生连接 -“原生连接”指连接器通过客户端驱动(taosc)直接与 TDengine 集群建立连接。支持的功能特性有: +“原生连接”指连接器通过 TDengine 客户端驱动(taosc)直接与 TDengine 集群建立连接。支持的功能特性有: * 普通查询 * 连续查询 @@ -45,7 +45,7 @@ import GoQuery from "../../04-develop/04-query-data/_go.mdx" ### REST 连接 -REST 连接指连接器通过 taosAdapter 组件提供的 REST API 建立与 taosd 的连接。支持的功能特性有: +"REST 连接"指连接器通过 taosAdapter 组件提供的 REST API 建立与 taosd 的连接。支持的功能特性有: * 普通查询 * 连续查询 @@ -55,7 +55,7 @@ REST 连接指连接器通过 taosAdapter 组件提供的 REST API 建立与 tao ### 安装前准备 * 安装 Go 开发环境(Go 1.14 及以上,GCC 4.8.5 及以上) - +* 如果使用原生连接器,请安装 TDengine 客户端驱动,具体步骤请参考[安装客户端驱动](/reference/connector#安装客户端驱动) 配置好环境变量,检查命令: @@ -81,9 +81,10 @@ REST 连接指连接器通过 taosAdapter 组件提供的 REST API 建立与 tao ```text username:password@protocol(address)/dbname?param=value ``` +### 使用连接器进行连接 - + _taosSql_ 通过 cgo 实现了 Go 的 `database/sql/driver` 接口。只需要引入驱动就可以使用 [`database/sql`](https://golang.org/pkg/database/sql/) 的接口。 @@ -114,7 +115,7 @@ func main() { ``` - + _taosRestful_ 通过 `http client` 实现了 Go 的 `database/sql/driver` 接口。只需要引入驱动就可以使用[`database/sql`](https://golang.org/pkg/database/sql/)的接口。