From be6df4b251d2bca683c0d2e2ece6149fc56abcd6 Mon Sep 17 00:00:00 2001 From: Yaming Pei Date: Wed, 12 Feb 2025 13:50:32 +0800 Subject: [PATCH] docs: fix some misdescriptions for odbc --- docs/en/14-reference/05-connector/50-odbc.md | 14 +++++++------- docs/zh/14-reference/05-connector/50-odbc.mdx | 14 +++++++------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/en/14-reference/05-connector/50-odbc.md b/docs/en/14-reference/05-connector/50-odbc.md index 70517c15d7..b4c3e23e13 100644 --- a/docs/en/14-reference/05-connector/50-odbc.md +++ b/docs/en/14-reference/05-connector/50-odbc.md @@ -138,7 +138,7 @@ The table below explains how the ODBC connector maps server data types to defaul | 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 | +| DOUBLE | SQL_DOUBLE | SQL_C_DOUBLE | | BINARY | SQL_BINARY | SQL_C_BINARY | | SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | | SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | @@ -146,8 +146,8 @@ The table below explains how the ODBC connector maps server data types to defaul | 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 | +| JSON | SQL_WVARCHAR | SQL_C_WCHAR | | GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | | VARBINARY | SQL_VARBINARY | SQL_C_BINARY | @@ -161,7 +161,7 @@ The table below explains how the ODBC connector maps server data types to defaul | :----- | :---- | :---- | :---- | :---- | | ConfigDSN | ❌ | ❌ | ✅ | | | ConfigDriver | ❌ | ❌ | ✅ | | -| ConfigTranslator | ❌ | ❌ | ✅ | | +| ConfigTranslator | ❌ | ❌ | ❌ | | | SQLAllocHandle | ✅ | ✅ | ✅ | | | SQLBindCol | ✅ | ✅ | ✅ | Column-Wise Binding only | | SQLBindParameter | ✅ | ✅ | ✅ | Column-Wise Binding only | @@ -270,17 +270,17 @@ This section summarizes the ODBC API by functionality. For a complete ODBC API r #### Data Source and Driver Management - API: ConfigDSN - - **Supported**: Yes + - **Supported**: Yes (Windows only) - **Standard**: ODBC - **Function**: Configures data sources - API: ConfigDriver - - **Supported**: Yes + - **Supported**: Yes (Windows only) - **Standard**: ODBC - **Function**: Used to perform installation and configuration tasks related to a specific driver - API: ConfigTranslator - - **Supported**: Yes + - **Supported**: No - **Standard**: ODBC - **Function**: Used to parse the DSN configuration, translating or converting between DSN configuration and actual database driver configuration @@ -610,7 +610,7 @@ This section summarizes the ODBC API by functionality. For a complete ODBC API r - API: SQLEndTran - **Support**: Supported - **Standard**: ISO 92 - - **Function**: Used to commit or rollback transactions, TDengine does not support transactions, therefore rollback operation is not supported + - **Function**: Used to commit or rollback transactions. TDengine is non-transactional, so this function can at most simulate commit or rollback operations. If there are any outstanding connections or statements, neither commit nor rollback will succeed #### Connection Termination diff --git a/docs/zh/14-reference/05-connector/50-odbc.mdx b/docs/zh/14-reference/05-connector/50-odbc.mdx index 4f01550490..7d71b847c6 100644 --- a/docs/zh/14-reference/05-connector/50-odbc.mdx +++ b/docs/zh/14-reference/05-connector/50-odbc.mdx @@ -133,7 +133,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：WebSocket 连接与 | 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 | +| DOUBLE | SQL_DOUBLE | SQL_C_DOUBLE | | BINARY | SQL_BINARY | SQL_C_BINARY | | SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | | SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | @@ -141,8 +141,8 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：WebSocket 连接与 | 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 | +| JSON | SQL_WVARCHAR | SQL_C_WCHAR | | GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | | VARBINARY | SQL_VARBINARY | SQL_C_BINARY | @@ -157,7 +157,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：WebSocket 连接与 | :----- | :---- | :---- | :---- | :---- | | ConfigDSN | ❌ | ❌ | ✅ | | | ConfigDriver | ❌ | ❌ | ✅ | | -| ConfigTranslator | ❌ | ❌ | ✅ | | +| ConfigTranslator | ❌ | ❌ | ❌ | | | SQLAllocHandle | ✅ | ✅ | ✅ | | | SQLBindCol | ✅ | ✅ | ✅ | 只能按列绑定 | | SQLBindParameter | ✅ | ✅ | ✅ | 只能按列绑定 | @@ -268,17 +268,17 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：WebSocket 连接与 #### 数据源和驱动程序管理 - API: ConfigDSN - - **是否支持**: 支持 + - **是否支持**: 支持（仅 Windows） - **标准**: ODBC - **作用**: 配置数据源 - API: ConfigDriver - - **是否支持**: 支持 + - **是否支持**: 支持（仅 Windows） - **标准**: ODBC - **作用**: 用于执行与特定驱动程序相关的安装和配置任务 - API: ConfigTranslator - - **是否支持**: 支持 + - **是否支持**: 不支持 - **标准**: ODBC - **作用**: 用于解析DSN的配置，在DSN配置和实际数据库驱动程序配置之间进行翻译或转换 @@ -617,7 +617,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式：WebSocket 连接与 - API: SQLEndTran - **是否支持**: 支持 - **标准**: ISO 92 - - **作用**: 用于提交或回滚事务，TDengine 不支持事务，因此不支持回滚操作 + - **作用**: 用于提交或回滚事务。TDengine 是非事务性的，因此 SQLEndTran 函数最多只能模拟提交或回滚操作。如果有任何未完成的连接或语句，无论是提交（commit）还是回滚（rollback）都不会成功 #### 终止连接