大连网站快速排名提升,滕州网站搜索引擎优化,小程序注册完成后如何制作,jsp网站开发公司简介
TDengine ODBC 是为 TDengine 实现的 ODBC 驱动程序#xff0c;支持 Windows 系统的应用#xff08;如 PowerBI 等#xff09;以及用户自定义开发的应用程序#xff0c;通过 ODBC 标准接口访问本地、远程和云服务的 TDengine 数据库。
TDengine ODBC 提供基于 WebSo…简介
TDengine ODBC 是为 TDengine 实现的 ODBC 驱动程序支持 Windows 系统的应用如 PowerBI 等以及用户自定义开发的应用程序通过 ODBC 标准接口访问本地、远程和云服务的 TDengine 数据库。
TDengine ODBC 提供基于 WebSocket推荐和 原生连接两种方式连接 TDengine 数据库使用时可以为 TDengine 数据源设置不同的连接方式。访问云服务时必须使用 WebSocket 连接方式。
TDengine ODBC 提供 64 位 和 32 位 两种驱动程序。但 32 位仅企业版支持且仅支持 WebSocket 连接方式。
注意
驱动管理器确保使用与应用程序架构匹配的 ODBC 驱动管理器。32 位应用程序需要使用 32 位 ODBC 驱动管理器64 位应用程序需要使用 64 位 ODBC 驱动管理器。数据源名称DSN32 位和 64 位 ODBC 驱动管理器都可以看到所有 DSN用户 DSN 标签页下的 DSN 如果名字相同会共用因此需要在 DSN 名称上去区分。
想更多了解 TDengine 时序时序数据库的使用可访问 TDengine官方文档。
ODBC 版本兼容性
支持 ODBC 所有版本
安装 仅支持 Windows 平台。Windows 上需要安装过 VC 运行时库可在此下载安装 VC运行时库 如果已经安装VS开发工具可忽略。 安装 TDengine Windows 客户端。版本在 3.2.1.0 或以上包含 TDengine 的 ODBC 64 位驱动版本在 3.3.3.0 或以上包含 TDengine 的 ODBC 32/64 位驱动。
配置数据源
数据源连接类型与区别
TDengine ODBC 支持两种连接 TDengine 数据库方式WebSocket 连接与 Native 连接其区别如下 访问云服务仅支持使用 WebSocket 连接方式。 32 位应用程序仅支持使用 WebSocket 连接方式。 WebSocket 连接的兼容性更好一般不需要随着 TDengine 数据库服务端升级而升级客户端的库。 Native 连接通常性能更好一点但是必须与 TDengine 数据库服务端的版本保持一致。 对于一般用户建议使用 WebSocket 连接方式性能与 Native 差别不大兼容性更好。
WebSocket 连接 【开始】菜单搜索打开【ODBC 数据源(32 位)】或者【ODBC 数据源(64 位)】管理工具 选中【用户 DSN】标签页通过【添加(D)】按钮进入创建数据源界面 选择想要添加的数据源这里我们选择【TDengine】 点击完成进入 TDengine ODBC 数据源配置页面填写如下必要信息 4.1 【DSN】Data Source Name 必填为新添加的 ODBC 数据源命名4.2【连接类型】必选选择连接类型这里选择 【WebSocket】4.3【URL】必填ODBC 数据源 URL示例http://localhost:6041 云服务的 url 示例https://gw.cloud.taosdata.com?tokenyour_token4.4【数据库】选填需要连接的默认数据库4.5【用户名】仅供第5步测试连接使用选填数据库用户名如果不填TDengine 默认 root4.6【密码】仅供第5步测试连接使用选填数据库用户密码如果不填TDengine 默认 taosdata4.7【兼容软件】支持对工业软件 KingSCADA、Kepware 等的兼容性适配通常情况下选择默认值 General 即可点【测试连接】测试连接情况如果成功提示成功连接到URL 点【确定】即可保存配置并退出 也可以在第2步选择已经配置好的数据源名通过【配置】按钮进入配置页面修改已有配置
原生连接不支持云服务和 32 位应用程序 【开始】菜单搜索打开【ODBC 数据源(64 位)】管理工具注意不要选择ODBC 数据源(32 位) 选中【用户 DSN】标签页通过【添加(D)】按钮进入创建数据源界面 选择想要添加的数据源这里我们选择【TDengine】 点击完成进入 TDengine ODBC 数据源配置页面填写如下必要信息 4.1 【DSN】Data Source Name 必填为新添加的 ODBC 数据源命名 4.2 【连接类型】必选选择连接类型这里选择 【Native】 原生连接 4.3 【服务器】必填ODBC 数据源 服务器 地址示例localhost:6030 4.4 【数据库】选填需要连接的默认数据库 4.5 【用户名】仅供第5步测试连接使用选填数据库用户名如果不填TDengine 默认 root 4.6 【密码】仅供第5步测试连接使用选填数据库用户密码如果不填TDengine 默认 taosdata 4.7【兼容软件】支持对工业软件 KingSCADA、Kepware 等的兼容性适配通常情况下选择默认值 General 即可 点【测试连接】测试连接情况如果成功提示连接成功 点【确定】即可保存配置并退出 也可以在第2步选择已经配置好的数据源名通过【配置】按钮进入配置页面修改已有配置
支持的平台
原生连接方式支持的平台和 TDengine Windows X64版 客户端驱动支持的平台一致。WebSocket 连接方式除此之外还支持 Windows X64系统上运行的 32 位应用程序上使用。
版本历史
taos_odbc 版本主要变化TDengine 版本v1.1.01. 支持视图功能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.11. 支持 DSN 设置 BI 模式在 BI 模式下 TDengine 数据库不返回系统数据库和超级表子表信息2. 重构字符集转换模块提升读写性能3. ODBC 数据源配置对话框中默认修改默认连接方式为“WebSocket”4. ODBC 数据源配置对话框增加“测试连接”控件5. ODBC 数据源配置支持中文/英文界面-v1.0.0.0发布初始版本支持与 TDengine 数据库交互以读写数据具体请参考“API 参考”一节3.2.2.0 及更高版本
数据类型映射
下表说明了 ODBC 连接器如何将服务器数据类型映射到默认的 SQL 和 C 数据类型。
TDengine TypeSQL TypeC TypeTIMESTAMPSQL_TYPE_TIMESTAMPSQL_C_TIMESTAMPINTSQL_INTEGERSQL_C_SLONGINT UNSIGNEDSQL_INTEGERSQL_C_ULONGBIGINTSQL_BIGINTSQL_C_SBIGINTBIGINT UNSIGNEDSQL_BIGINTSQL_C_UBIGINTFLOATSQL_REALSQL_C_FLOATDOUBLESQL_DOUBLESQL_C_DOUBLEBINARYSQL_BINARYSQL_C_BINARYSMALLINTSQL_SMALLINTSQL_C_SSHORTSMALLINT UNSIGNEDSQL_SMALLINTSQL_C_USHORTTINYINTSQL_TINYINTSQL_C_STINYINTTINYINT UNSIGNEDSQL_TINYINTSQL_C_UTINYINTBOOLSQL_BITSQL_C_BITNCHARSQL_VARCHARSQL_C_CHARVARCHARSQL_VARCHARSQL_C_CHARJSONSQL_WVARCHARSQL_C_WCHARGEOMETRYSQL_VARBINARYSQL_C_BINARYVARBINARYSQL_VARBINARYSQL_C_BINARY
API 参考
API 列表
目前导出的ODBC函数有:
ODBC/Setup APILinuxmacOSWindowsNoteConfigDSN❌❌✅ConfigDriver❌❌✅ConfigTranslator❌❌❌SQLAllocHandle✅✅✅SQLBindCol✅✅✅只能按列绑定SQLBindParameter✅✅✅只能按列绑定SQLBrowseConnect❌❌❌SQLBulkOperations❌❌❌TDengine 没有对应的SQLCloseCursor✅✅✅SQLColAttribute✅✅✅SQLColumnPrivileges❌❌❌TDengine 没有严格对应的SQLColumns✅✅✅SQLCompleteAsync❌❌❌SQLConnect✅✅✅SQLCopyDesc❌❌❌SQLDescribeCol✅✅✅SQLDescribeParam✅✅✅SQLDisconnect✅✅✅SQLDriverConnect✅✅✅SQLEndTran✅✅✅TDengine是非事务性的因此这最多是模拟SQLExecDirect✅✅✅SQLExecute✅✅✅SQLExtendedFetch❌❌❌SQLFetch✅✅✅SQLFetchScroll✅✅✅TDengine 没有对应的, 仅仅实现 SQL_FETCH_NEXTSQLForeignKeys❌❌❌TDengine 没有对应的SQLFreeHandle✅✅✅SQLFreeStmt✅✅✅SQLGetConnectAttr✅✅✅支持部分属性下面列出了不支持的属性SQLGetCursorName❌❌❌TDengine 没有对应的SQLGetData✅✅✅SQLGetDescField❌❌❌SQLGetDescRec❌❌❌SQLGetDiagField✅✅✅SQLGetDiagRec✅✅✅SQLGetEnvAttr✅✅✅SQLGetInfo✅✅✅SQLGetStmtAttr✅✅✅支持部分属性下面列出了不支持的属性SQLGetTypeInfo✅✅✅SQLMoreResults✅✅✅SQLNativeSql❌❌❌TDengine 没有对应的SQLNumParams✅✅✅SQLNumResultCols✅✅✅SQLParamData❌❌❌TDengine 没有对应的SQLPrepare✅✅✅SQLPrimaryKeys✅✅✅SQLProcedureColumns❌❌❌TDengine 没有对应的SQLProcedures❌❌❌TDengine 没有对应的SQLPutData❌❌❌TDengine 没有对应的SQLRowCount✅✅✅SQLSetConnectAttr✅✅✅支持部分属性下面列出了不支持的属性SQLSetCursorName❌❌❌TDengine 没有对应的SQLSetDescField❌❌❌SQLSetDescRec❌❌❌SQLSetEnvAttr✅✅✅SQLSetPos❌❌❌TDengine 没有对应的SQLSetStmtAttr✅✅✅支持部分属性下面列出了不支持的属性SQLSpecialColumns❌❌❌TDengine 没有对应的SQLStatistics❌❌❌TDengine 没有对应的SQLTablePrivileges❌❌❌TDengine 没有严格对应的SQLTables✅✅✅
不支持的语句属性 (SQLSetStmtAttr)
AttributeNoteSQL_ATTR_CONCURRENCYTDengine 没有 updatable-CURSOR 机制SQL_ATTR_FETCH_BOOKMARK_PTRTDengine 没有 BOOKMARK 机制SQL_ATTR_IMP_PARAM_DESCSQL_ATTR_IMP_ROW_DESCSQL_ATTR_KEYSET_SIZESQL_ATTR_PARAM_BIND_OFFSET_PTRSQL_ATTR_PARAM_OPERATION_PTRSQL_ATTR_ROW_NUMBER只读属性SQL_ATTR_ROW_OPERATION_PTRSQL_ATTR_SIMULATE_CURSOR
不支持的连接属性 (SQLSetConnectAttr)
AttributeNoteSQL_ATTR_AUTO_IPD只读属性SQL_ATTR_CONNECTION_DEAD只读属性SQL_ATTR_ENLIST_IN_DTCSQL_ATTR_PACKET_SIZESQL_ATTR_TRACESQL_ATTR_TRACEFILESQL_ATTR_TRANSLATE_LIBSQL_ATTR_TRANSLATE_OPTION
允许任何带有 ODBC 库的编程语言与 TDengine 通信:
programming languageODBC-API or bindings/pluginsC/CODBC-APICSharpSystem.Data.OdbcErlangodbc moduleGoodbc, database/sqlHaskellHDBC, HDBC-odbcCommon Lispplain-odbcNodejsodbcPython3pyodbcRustodbc
API 功能分类
本节按功能分类汇总了 ODBC API关于完整的 ODBC API 参考请访问 Microsoft Open Database Connectivity (ODBC)。
数据源和驱动程序管理 APIConfigDSN 是否支持支持仅 Windows标准ODBC作用配置数据源 APIConfigDriver 是否支持支持仅 Windows标准ODBC作用用于执行与特定驱动程序相关的安装和配置任务 APIConfigTranslator 是否支持不支持标准ODBC作用用于解析DSN的配置在DSN配置和实际数据库驱动程序配置之间进行翻译或转换
连接到数据源 APISQLAllocHandle 是否支持支持标准ISO 92作用分配环境、连接、语句或描述符句柄 APISQLConnect 是否支持支持标准ISO 92作用通过数据源名称、用户 ID 和密码连接到特定驱动程序 APISQLDriverConnect 是否支持支持标准ODBC作用通过连接字符串连接到特定驱动程序支持更多连接信息 APISQLBrowseConnect 是否支持不支持标准ODBC作用用于发现和枚举连接到数据源所需的特性和属性值。每次调用 SQLBrowseConnect 都会返回属性和属性值的连续级别 APISQLAllocEnv 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.x 函数 SQLAllocEnv 已替换为 SQLAllocHandle APISQLAllocConnect 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.x 函数 SQLAllocConnect 已替换为 SQLAllocHandle
获取有关驱动程序和数据源的信息 APISQLDataSources 是否支持不支持标准ISO 92作用返回可用数据源的列表由驱动程序管理器处理 APISQLDrivers 是否支持不支持标准ISO 92作用返回由驱动程序管理器处理的已安装驱动程序及其属性的列表 APISQLGetInfo 是否支持支持标准ISO 92作用返回有关数据库环境的详细信息如数据库产品名称、驱动程序名、数据库的SQL语法特性、连接能力等等 APISQLGetFunctions 是否支持不支持标准ISO 92作用用于查询驱动程序支持的函数 APISQLGetTypeInfo 是否支持支持标准ISO 92作用返回有关支持的数据类型的信息
设置和检索驱动程序属性 APISQLSetConnectAttr 是否支持支持标准ISO 92作用设置连接属性当设置SQL_ATTR_AUTOCOMMIT属性时用于控制自动提交模式 APISQLGetConnectAttr 是否支持支持标准ISO 92作用返回连接属性的值 APISQLSetConnectOption 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLSetConnectOption 已替换为 SQLSetConnectAttr APISQLGetConnectOption 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLSetConnectOption 已替换为 SQLGetConnectAttr APISQLSetEnvAttr 是否支持支持标准ISO 92作用设置控制环境的属性 APISQLGetEnvAttr 是否支持支持标准ISO 92作用返回环境属性的当前设置 APISQLSetStmtAttr 是否支持支持标准ISO 92作用设置与语句相关的属性 APISQLGetStmtAttr 是否支持支持标准ISO 92作用返回语句属性的当前设置 APISQLSetStmtOption 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLSetStmtOption 已替换为 SQLSetStmtAttr APISQLGetStmtOption 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLSetStmtOption 已替换为 SQLGetStmtAttr
准备 SQL 请求 APISQLAllocStmt 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.x 函数 SQLAllocStmt 已替换为 SQLAllocHandle APISQLPrepare 是否支持支持标准ISO 92作用用于预处理SQL语句这通常是SQLExecute之前的一个步骤 APISQLBindCol 是否支持支持标准ODBC作用用于将结果集中的列绑定到应用程序缓冲区 APISQLBindParameter 是否支持支持标准ODBC作用用于将SQL语句的参数绑定到应用程序缓冲区 APISQLGetCursorName 是否支持不支持标准ISO 92作用返回与指定语句关联的游标名称 APISQLSetCursorName 是否支持不支持标准ISO 92作用设置游标名称允许在查询中使用命名游标 APISQLSetScrollOptions 是否支持不支持标准ODBC作用设置控制光标行为的选项
提交请求 APISQLExecute 是否支持支持标准ISO 92作用用于执行之前通过 SQLPrepare 准备好的SQL语句 APISQLExecDirect 是否支持支持标准ISO 92作用用于执行包含SQL语句的字符串 APISQLNativeSql 是否支持不支持标准ODBC作用用于将应用程序提供的SQL语句转换为数据库驱动程序的本机SQL语法 APISQLDescribeParam 是否支持支持标准ODBC作用返回语句中特定参数的描述 APISQLNumParams 是否支持支持标准ISO 92作用用于查询预编译SQL语句中的参数数量 APISQLParamData 是否支持不支持标准ISO 92作用用于从参数数据流中获取下一个参数值 APISQLPutData 是否支持不支持标准ISO 92作用当使用流输入方式时可以用于向输出参数发送数据块
检索结果和关于结果的信息 APISQLRowCount 是否支持支持标准ISO 92作用返回受插入或删除请求影响的行数 APISQLNumResultCols 是否支持支持标准ISO 92作用返回结果集中的列数 APISQLDescribeCol 是否支持支持标准ISO 92作用用于描述结果集中列的属性。它提供了关于列的数据类型、列名、列的最大宽度、小数位数和是否可为空等信息 APISQLColAttribute 是否支持支持标准ISO 92作用返回结果集中列的描述符信息如标题、排序规则等 APISQLColAttributes 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLColAttributes 已替换为 SQLColAttribute APISQLGetData 是否支持支持标准ODBC作用用于从结果集中的当前行获取特定列的数据 APISQLMoreResults 是否支持支持标准ODBC作用多个结果集的 SQL 语句执行后例如一个批处理或存储过程移动到下一个结果集 APISQLFetch 是否支持支持标准ISO 92作用用于从结果集中提取下一行数据并返回所有绑定列的数据 APISQLFetchScroll 是否支持支持标准ISO 92作用用于从结果集中提取指定的数据行集并返回所有绑定列的数据 APISQLExtendedFetch 是否支持不支持标准弃用作用在 ODBC 3.x 中SQLExtendedFetch 已替换为 SQLFetchScroll APISQLSetPos 是否支持支持标准ODBC作用设置行集中的游标位置并允许应用程序更新数据集中的行 APISQLBulkOperations 是否支持不支持标准ODBC作用执行批量插入和批量书签操作包括更新、删除和按书签提取
检索错误或诊断信息 APISQLError 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.x 函数 SQLError 已替换为 SQLGetDiagRec APISQLGetDiagField 是否支持支持标准ISO 92作用返回附加诊断信息单条诊断结果 APISQLGetDiagRec 是否支持支持标准ISO 92作用返回附加诊断信息多条诊断结果
获取有关数据源的系统表项的信息 APISQLColumnPrivileges 是否支持不支持标准ODBC作用用于检索指定表中列的权限信息如哪些用户或角色拥有对特定列的读取、插入、更新或删除权限 APISQLColumns 是否支持支持标准X/Open作用返回指定表中的列名列表 APISQLForeignKeys 是否支持不支持标准ODBC作用检索外键关系的详细信息 APISQLPrimaryKeys 是否支持支持标准ODBC作用返回构成表主键的列名列表 APISQLSpecialColumns 是否支持不支持标准X/Open作用返回数据库中特殊列的信息如唯一键或索引列 APISQLStatistics 是否支持不支持标准ISO 92作用返回关于表的统计信息如行数、列数、平均行宽等 APISQLTablePrivileges 是否支持不支持标准ODBC作用返回用户在特定表上的权限如SELECT、INSERT、UPDATE等 APISQLTables 是否支持支持标准X/Open作用返回存储在数据源的当前数据库中的表信息 APISQLProcedures 是否支持不支持标准ODBC作用返回数据库中可用的存储过程信息包括名称和类型 APISQLProcedureColumns 是否支持不支持标准ODBC作用返回存储过程的列信息包括输入输出参数的详细信息
执行事务 APISQLTransact 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.x 函数 SQLTransact 已替换为 SQLEndTran APISQLEndTran 是否支持支持标准ISO 92作用用于提交或回滚事务。TDengine 是非事务性的因此 SQLEndTran 函数最多只能模拟提交或回滚操作。如果有任何未完成的连接或语句无论是提交commit还是回滚rollback都不会成功
终止连接 APISQLDisconnect 是否支持支持标准ISO 92作用断开数据库连接 APISQLFreeHandle 是否支持支持标准ISO 92作用释放与特定环境、连接、语句或描述符句柄关联的资源 APISQLFreeConnect 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLFreeConnect 已替换为 SQLFreeHandle APISQLFreeEnv 是否支持不支持标准弃用作用在 ODBC 3.x 中ODBC 2.0 函数 SQLFreeEnv 已替换为 SQLFreeHandle APISQLFreeStmt 是否支持支持标准ODBC作用结束语句处理丢弃挂起的结果并且可以选择释放与语句句柄关联的所有资源 APISQLCloseCursor 是否支持支持标准ODBC作用关闭与当前语句句柄关联的游标并释放游标所使用的所有资源
访问官网
更多内容欢迎访问 TDengine 官网
