From 3c5c99006fcce368ec95cfe676f904f057fa7899 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Fri, 27 Sep 2024 21:22:38 +0800 Subject: [PATCH 1/6] docs: adjust layout --- docs/zh/14-reference/05-connector/50-odbc.mdx | 53 ++++++++++--------- 1 file changed, 27 insertions(+), 26 deletions(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index ac317435df..31ac9eb55b 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -100,6 +100,33 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 7. 也可以在第2步选择已经配置好的数据源名通过【配置】按钮进入配置页面，修改已有配置 + +## 数据类型映射 + +下表说明了 ODBC 连接器如何将服务器数据类型映射到默认的 SQL 和 C 数据类型。 + +| TDengine Type | SQL Type | C Type | +|--------------------|-------------------|-------------------| +| TIMESTAMP | SQL_TYPE_TIMESTAMP| SQL_C_TIMESTAMP | +| INT | SQL_INTEGER | SQL_C_SLONG | +| INT UNSIGNED | SQL_INTEGER | SQL_C_ULONG | +| BIGINT | SQL_BIGINT | SQL_C_SBIGINT | +| BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT | +| FLOAT | SQL_REAL | SQL_C_FLOAT | +| DOUBLE | SQL_REAL | SQL_C_DOUBLE | +| BINARY | SQL_BINARY | SQL_C_BINARY | +| SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | +| SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | +| TINYINT | SQL_TINYINT | SQL_C_STINYINT | +| TINYINT UNSIGNED | SQL_TINYINT | SQL_C_UTINYINT | +| BOOL | SQL_BIT | SQL_C_BIT | +| NCHAR | SQL_VARCHAR | SQL_C_CHAR | +| JSON | SQL_VARCHAR | SQL_C_CHAR | +| VARCHAR | SQL_VARCHAR | SQL_C_CHAR | +| GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | +| VARBINARY | SQL_VARBINARY | SQL_C_BINARY | + + ## ODBC API 参考 本节按功能分类汇总了 ODBC API。 @@ -492,32 +519,6 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 - **作用**: 关闭与当前语句句柄关联的游标，并释放游标所使用的所有资源 -## 数据类型映射 - -下表说明了 ODBC 连接器如何将服务器数据类型映射到默认的 SQL 和 C 数据类型。 - -| Native Value | SQL Type | C Type | -|--------------------|-------------------|-------------------| -| TIMESTAMP | SQL_TYPE_TIMESTAMP| SQL_C_TIMESTAMP | -| INT | SQL_INTEGER | SQL_C_SLONG | -| INT UNSIGNED | SQL_INTEGER | SQL_C_ULONG | -| BIGINT | SQL_BIGINT | SQL_C_SBIGINT | -| BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT | -| FLOAT | SQL_REAL | SQL_C_FLOAT | -| DOUBLE | SQL_REAL | SQL_C_DOUBLE | -| BINARY | SQL_BINARY | SQL_C_BINARY | -| SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | -| SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | -| TINYINT | SQL_TINYINT | SQL_C_STINYINT | -| TINYINT UNSIGNED | SQL_TINYINT | SQL_C_UTINYINT | -| BOOL | SQL_BIT | SQL_C_BIT | -| NCHAR | SQL_VARCHAR | SQL_C_CHAR | -| JSON | SQL_VARCHAR | SQL_C_CHAR | -| VARCHAR | SQL_VARCHAR | SQL_C_CHAR | -| GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | -| VARBINARY | SQL_VARBINARY | SQL_C_BINARY | - - ## 与第三方集成 作为使用 TDengine ODBC driver 的一个示例，你可以使用 Power BI 与 TDengine 分析时序数据。更多细节请参考 [Power BI](../../../third-party/bi/powerbi) From 0654d0d153d1a42899a4ccabdec020859d82c432 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Sat, 28 Sep 2024 12:22:01 +0800 Subject: [PATCH 2/6] docs: api reference rename --- docs/zh/14-reference/05-connector/50-odbc.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 31ac9eb55b..aba46a5d98 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -127,7 +127,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 | VARBINARY | SQL_VARBINARY | SQL_C_BINARY | -## ODBC API 参考 +## API 参考 本节按功能分类汇总了 ODBC API。 From a396bda12a34416457f4047ef4b592324dc73059 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Sat, 28 Sep 2024 16:32:23 +0800 Subject: [PATCH 3/6] docs: add chapters on supported platforms and historical versions --- docs/zh/14-reference/05-connector/50-odbc.mdx | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index aba46a5d98..942b206510 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -101,6 +101,21 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 7. 也可以在第2步选择已经配置好的数据源名通过【配置】按钮进入配置页面，修改已有配置 +## 支持的平台 + +原生连接方式支持的平台和 TDengine Windows X64版 客户端驱动支持的平台一致。 +WebSocket 连接方式除此之外还支持 Windows X64系统上运行的 32 位应用程序上使用。 + + +## 版本历史 + +| taos_odbc版本 | 主要变化 | TDengine 版本 | +| :----------- | :-------------------------------------------------------------------------------------------------- | :---------------- | +| v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考"API 参考"一节 | 3.2.2.0及更高版本 | +| v1.0.1 | 1. 支持DSN设置BI模式，在BI模式下Tdengine数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. Tdengine ODBC数据源配置对话框中默认修改默认连接方式为"WebSocket"；
4. Tdengine ODBC数据源配置对话框增加"测试连接"控件；
5. Tdengine ODBC数据源配置支持中文/英文界面； | - | +| v1.0.2 | 支持CP1252字符编码； | 3.2.3.0及更高版本 | + + ## 数据类型映射 下表说明了 ODBC 连接器如何将服务器数据类型映射到默认的 SQL 和 C 数据类型。 @@ -129,7 +144,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：Websocket 连接与 ## API 参考 -本节按功能分类汇总了 ODBC API。 +本节按功能分类汇总了 ODBC API，关于完整的 ODBC API 参考，请访问 http://msdn.microsoft.com/en-us/library/ms714177.aspx 的ODBC程序员参考页面。 ### 数据源和驱动程序管理 From 0b8026a3d9129c9dc03c156fec93757b63bed3d2 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Sun, 29 Sep 2024 18:48:19 +0800 Subject: [PATCH 4/6] docs: adjust the row order of the Version History table --- docs/zh/14-reference/05-connector/50-odbc.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 942b206510..57f6ef8f22 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -111,9 +111,9 @@ WebSocket 连接方式除此之外还支持 Windows X64系统上运行的 32 位 | taos_odbc版本 | 主要变化 | TDengine 版本 | | :----------- | :-------------------------------------------------------------------------------------------------- | :---------------- | -| v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考"API 参考"一节 | 3.2.2.0及更高版本 | -| v1.0.1 | 1. 支持DSN设置BI模式，在BI模式下Tdengine数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. Tdengine ODBC数据源配置对话框中默认修改默认连接方式为"WebSocket"；
4. Tdengine ODBC数据源配置对话框增加"测试连接"控件；
5. Tdengine ODBC数据源配置支持中文/英文界面； | - | | v1.0.2 | 支持CP1252字符编码； | 3.2.3.0及更高版本 | +| v1.0.1 | 1. 支持DSN设置BI模式，在BI模式下Tdengine数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. Tdengine ODBC数据源配置对话框中默认修改默认连接方式为"WebSocket"；
4. Tdengine ODBC数据源配置对话框增加"测试连接"控件；
5. Tdengine ODBC数据源配置支持中文/英文界面； | - | +| v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考"API 参考"一节 | 3.2.2.0及更高版本 | ## 数据类型映射 From 2b72fb410049bc5374686573fd4f47b824177e51 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Sun, 29 Sep 2024 20:37:23 +0800 Subject: [PATCH 5/6] docs: add version 1.1.0 info --- docs/zh/14-reference/05-connector/50-odbc.mdx | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 57f6ef8f22..38dd88b86d 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -111,9 +111,10 @@ WebSocket 连接方式除此之外还支持 Windows X64系统上运行的 32 位 | taos_odbc版本 | 主要变化 | TDengine 版本 | | :----------- | :-------------------------------------------------------------------------------------------------- | :---------------- | -| v1.0.2 | 支持CP1252字符编码； | 3.2.3.0及更高版本 | -| v1.0.1 | 1. 支持DSN设置BI模式，在BI模式下Tdengine数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. Tdengine ODBC数据源配置对话框中默认修改默认连接方式为"WebSocket"；
4. Tdengine ODBC数据源配置对话框增加"测试连接"控件；
5. Tdengine ODBC数据源配置支持中文/英文界面； | - | -| v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考"API 参考"一节 | 3.2.2.0及更高版本 | +| v1.1.0 | 1. 支持视图功能；
2. 支持 VARBINARY/GEOMETRY 数据类型； | 3.3.3.0及更高版本 | +| v1.0.2 | 支持 CP1252 字符编码； | 3.2.3.0及更高版本 | +| v1.0.1 | 1. 支持 DSN 设置 BI 模式，在 BI 模式下 TDengine 数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. ODBC 数据源配置对话框中默认修改默认连接方式为“WebSocket”；
4. ODBC 数据源配置对话框增加“测试连接”控件；
5. ODBC 数据源配置支持中文/英文界面； | - | +| v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考“API 参考”一节 | 3.2.2.0及更高版本 | ## 数据类型映射 From 14fcb4831860bce8f4b0600d69c8c5f6ed815cd6 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Mon, 30 Sep 2024 10:11:48 +0800 Subject: [PATCH 6/6] docs: adjust the version function description --- docs/zh/14-reference/05-connector/50-odbc.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 38dd88b86d..73e5592cf5 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -7,7 +7,7 @@ TDengine ODBC 是为 TDengine 实现的 ODBC 驱动程序，支持 Windows 系 TDengine ODBC 提供基于 WebSocket（推荐）和 原生连接两种方式连接 TDengine 数据库，使用时可以为 TDengine 数据源设置不同的连接方式。访问云服务时必须使用 WebSocket 连接方式。 -注意：TDengine ODBC 支持 32/64 位 Windows 系统，调用 TDengine ODBC 需要通过相应位数的 ODBC 驱动管理器进行。在 32 位 Windows 系统或者 64 位 Windows 系统的 32 位应用程序中，仅支持使用 WebSocket 连接方式访问 TDengine 数据库。 +注意：TDengine ODBC 支持 64 位 Windows 系统，支持 32 位 Websocket 连接方式（仅企业版支持），调用 TDengine ODBC 需要通过相应位数的 ODBC 驱动管理器进行。在 32 位 Windows 系统或者 64 位 Windows 系统的 32 位应用程序中，仅支持使用 WebSocket 连接方式访问 TDengine 数据库。 想更多了解 TDengine 时序时序数据库的使用，可访问 [TDengine官方文档](https://docs.taosdata.com/intro/)。 @@ -111,7 +111,7 @@ WebSocket 连接方式除此之外还支持 Windows X64系统上运行的 32 位 | taos_odbc版本 | 主要变化 | TDengine 版本 | | :----------- | :-------------------------------------------------------------------------------------------------- | :---------------- | -| v1.1.0 | 1. 支持视图功能；
2. 支持 VARBINARY/GEOMETRY 数据类型； | 3.3.3.0及更高版本 | +| v1.1.0 | 1. 支持视图功能；
2. 支持 VARBINARY/GEOMETRY 数据类型；
3. 支持 ODBC 32 位 WebSocket 连接方式（仅企业版支持）；
4. 支持 ODBC 数据源配置对话框设置对工业软件 KingSCADA、Kepware 等的兼容性适配选项（仅企业版支持）； | 3.3.3.0及更高版本 | | v1.0.2 | 支持 CP1252 字符编码； | 3.2.3.0及更高版本 | | v1.0.1 | 1. 支持 DSN 设置 BI 模式，在 BI 模式下 TDengine 数据库不返回系统数据库和超级表子表信息；
2. 重构字符集转换模块，提升读写性能；
3. ODBC 数据源配置对话框中默认修改默认连接方式为“WebSocket”；
4. ODBC 数据源配置对话框增加“测试连接”控件；
5. ODBC 数据源配置支持中文/英文界面； | - | | v1.0.0.0 | 发布初始版本，支持与Tdengine数据库交互以读写数据，具体请参考“API 参考”一节 | 3.2.2.0及更高版本 |