docs: fix some misdescriptions for odbc

This commit is contained in:
Yaming Pei 2025-02-12 13:50:32 +08:00
parent 544228c6f9
commit be6df4b251
2 changed files with 14 additions and 14 deletions

View File

@ -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 | SQL_BIGINT | SQL_C_SBIGINT |
| BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT | | BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT |
| FLOAT | SQL_REAL | SQL_C_FLOAT | | FLOAT | SQL_REAL | SQL_C_FLOAT |
| DOUBLE | SQL_REAL | SQL_C_DOUBLE | | DOUBLE | SQL_DOUBLE | SQL_C_DOUBLE |
| BINARY | SQL_BINARY | SQL_C_BINARY | | BINARY | SQL_BINARY | SQL_C_BINARY |
| SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | | SMALLINT | SQL_SMALLINT | SQL_C_SSHORT |
| SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | | 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 | | TINYINT UNSIGNED | SQL_TINYINT | SQL_C_UTINYINT |
| BOOL | SQL_BIT | SQL_C_BIT | | BOOL | SQL_BIT | SQL_C_BIT |
| NCHAR | SQL_VARCHAR | SQL_C_CHAR | | NCHAR | SQL_VARCHAR | SQL_C_CHAR |
| JSON | SQL_VARCHAR | SQL_C_CHAR |
| VARCHAR | SQL_VARCHAR | SQL_C_CHAR | | VARCHAR | SQL_VARCHAR | SQL_C_CHAR |
| JSON | SQL_WVARCHAR | SQL_C_WCHAR |
| GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | | GEOMETRY | SQL_VARBINARY | SQL_C_BINARY |
| VARBINARY | 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 | ❌ | ❌ | ✅ | | | ConfigDSN | ❌ | ❌ | ✅ | |
| ConfigDriver | ❌ | ❌ | ✅ | | | ConfigDriver | ❌ | ❌ | ✅ | |
| ConfigTranslator | ❌ | ❌ | | | | ConfigTranslator | ❌ | ❌ | | |
| SQLAllocHandle | ✅ | ✅ | ✅ | | | SQLAllocHandle | ✅ | ✅ | ✅ | |
| SQLBindCol | ✅ | ✅ | ✅ | Column-Wise Binding only | | SQLBindCol | ✅ | ✅ | ✅ | Column-Wise Binding only |
| SQLBindParameter | ✅ | ✅ | ✅ | 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 #### Data Source and Driver Management
- API: ConfigDSN - API: ConfigDSN
- **Supported**: Yes - **Supported**: Yes (Windows only)
- **Standard**: ODBC - **Standard**: ODBC
- **Function**: Configures data sources - **Function**: Configures data sources
- API: ConfigDriver - API: ConfigDriver
- **Supported**: Yes - **Supported**: Yes (Windows only)
- **Standard**: ODBC - **Standard**: ODBC
- **Function**: Used to perform installation and configuration tasks related to a specific driver - **Function**: Used to perform installation and configuration tasks related to a specific driver
- API: ConfigTranslator - API: ConfigTranslator
- **Supported**: Yes - **Supported**: No
- **Standard**: ODBC - **Standard**: ODBC
- **Function**: Used to parse the DSN configuration, translating or converting between DSN configuration and actual database driver configuration - **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 - API: SQLEndTran
- **Support**: Supported - **Support**: Supported
- **Standard**: ISO 92 - **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 #### Connection Termination

View File

@ -133,7 +133,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与
| BIGINT | SQL_BIGINT | SQL_C_SBIGINT | | BIGINT | SQL_BIGINT | SQL_C_SBIGINT |
| BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT | | BIGINT UNSIGNED | SQL_BIGINT | SQL_C_UBIGINT |
| FLOAT | SQL_REAL | SQL_C_FLOAT | | FLOAT | SQL_REAL | SQL_C_FLOAT |
| DOUBLE | SQL_REAL | SQL_C_DOUBLE | | DOUBLE | SQL_DOUBLE | SQL_C_DOUBLE |
| BINARY | SQL_BINARY | SQL_C_BINARY | | BINARY | SQL_BINARY | SQL_C_BINARY |
| SMALLINT | SQL_SMALLINT | SQL_C_SSHORT | | SMALLINT | SQL_SMALLINT | SQL_C_SSHORT |
| SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT | | SMALLINT UNSIGNED | SQL_SMALLINT | SQL_C_USHORT |
@ -141,8 +141,8 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与
| TINYINT UNSIGNED | SQL_TINYINT | SQL_C_UTINYINT | | TINYINT UNSIGNED | SQL_TINYINT | SQL_C_UTINYINT |
| BOOL | SQL_BIT | SQL_C_BIT | | BOOL | SQL_BIT | SQL_C_BIT |
| NCHAR | SQL_VARCHAR | SQL_C_CHAR | | NCHAR | SQL_VARCHAR | SQL_C_CHAR |
| JSON | SQL_VARCHAR | SQL_C_CHAR |
| VARCHAR | SQL_VARCHAR | SQL_C_CHAR | | VARCHAR | SQL_VARCHAR | SQL_C_CHAR |
| JSON | SQL_WVARCHAR | SQL_C_WCHAR |
| GEOMETRY | SQL_VARBINARY | SQL_C_BINARY | | GEOMETRY | SQL_VARBINARY | SQL_C_BINARY |
| VARBINARY | SQL_VARBINARY | SQL_C_BINARY | | VARBINARY | SQL_VARBINARY | SQL_C_BINARY |
@ -157,7 +157,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与
| :----- | :---- | :---- | :---- | :---- | | :----- | :---- | :---- | :---- | :---- |
| ConfigDSN | ❌ | ❌ | ✅ | | | ConfigDSN | ❌ | ❌ | ✅ | |
| ConfigDriver | ❌ | ❌ | ✅ | | | ConfigDriver | ❌ | ❌ | ✅ | |
| ConfigTranslator | ❌ | ❌ | | | | ConfigTranslator | ❌ | ❌ | | |
| SQLAllocHandle | ✅ | ✅ | ✅ | | | SQLAllocHandle | ✅ | ✅ | ✅ | |
| SQLBindCol | ✅ | ✅ | ✅ | 只能按列绑定 | | SQLBindCol | ✅ | ✅ | ✅ | 只能按列绑定 |
| SQLBindParameter | ✅ | ✅ | ✅ | 只能按列绑定 | | SQLBindParameter | ✅ | ✅ | ✅ | 只能按列绑定 |
@ -268,17 +268,17 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与
#### 数据源和驱动程序管理 #### 数据源和驱动程序管理
- API: ConfigDSN - API: ConfigDSN
- **是否支持**: 支持 - **是否支持**: 支持(仅 Windows
- **标准**: ODBC - **标准**: ODBC
- **作用**: 配置数据源 - **作用**: 配置数据源
- API: ConfigDriver - API: ConfigDriver
- **是否支持**: 支持 - **是否支持**: 支持(仅 Windows
- **标准**: ODBC - **标准**: ODBC
- **作用**: 用于执行与特定驱动程序相关的安装和配置任务 - **作用**: 用于执行与特定驱动程序相关的安装和配置任务
- API: ConfigTranslator - API: ConfigTranslator
- **是否支持**: 支持 - **是否支持**: 支持
- **标准**: ODBC - **标准**: ODBC
- **作用**: 用于解析DSN的配置在DSN配置和实际数据库驱动程序配置之间进行翻译或转换 - **作用**: 用于解析DSN的配置在DSN配置和实际数据库驱动程序配置之间进行翻译或转换
@ -617,7 +617,7 @@ TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与
- API: SQLEndTran - API: SQLEndTran
- **是否支持**: 支持 - **是否支持**: 支持
- **标准**: ISO 92 - **标准**: ISO 92
- **作用**: 用于提交或回滚事务TDengine 不支持事务,因此不支持回滚操作 - **作用**: 用于提交或回滚事务。TDengine 是非事务性的,因此 SQLEndTran 函数最多只能模拟提交或回滚操作。如果有任何未完成的连接或语句无论是提交commit还是回滚rollback都不会成功
#### 终止连接 #### 终止连接