ODBC对象-Environment

2019独角兽企业重金招聘Python工程师标准>>>

简述

Environment对象，是ODBC的顶层对象，包含了全局的环境参数。

是创建其他数据库对象的先决条件，在使用ODBC访问数据库前，必须首先创建一个Environment对象。

Environment对象创建和释放：

    SQLSMALLINT hEnv = 0;  // Environment对象句柄
    SQLRETURN ret = SQLAllocHandle(SQL_HANDLE_ENV, NULL, &hEnv); // 创建一个Environment句柄
    ret = SQLFreeHandle(SQL_HANDLE_ENV, hEnv);

Environment属性设置和获取：

    Environment使用下列函数获取和设置属性：

SQLRETURN SQLGetEnvAttr(
            SQLENV hEnv, SQLINTEGER attrib, 
            SQLPOINT valueptr, SQLINTEGER buflen, SQLINTEGER *pStrLen);
SQLRETURN SQLSetEnvAttr(
            SQLENV hEnv, SQLINTEGER attrib, 
            SQLPOINT valueptr, SQLINTEGER stringlen);

Environment对象具有的属性：

    SQL_ATTR_CONNECTION_POOLING 

    ODBC-3.8，表示是否在Env层启用连接池，32位无符号整数，取值如下：

                                 SQL_CP_OFF              不启用连接池，默认值。

                                 SQL_CP_ONE_PER_DRIVER   对于每个ODBC驱动启用一个连接池

                                 SQL_CP_ONE_PER_HENV     对于每个Env对象启用一个连接池

                                 SQL_CP_DRIVER_AWARE     如果驱动不支持驱动级连接池，则转为启用ENV级连接池。

    SQL_ATTR_CP_MATCH    

    ODBC-3.0，表示SQLConnect和SQLDriverConnect函数执行时，连接获取方式，

                          32位无符号整数，取值如下：

                          SQL_CP_STRICT_MATCH   从连接池中获取所有属性参数都匹配的连接，默认值。

                          SQL_CP_RELAXED_MATCH  获取连接字符串中的关键字匹配的连接，无需所有参数都匹配。

    SQL_ATTR_ODBC_VERSION  

    ODBC-3.0，32位整数，表示当前ODBC接口的行为对应的ODBC版本，

                            在执行任何需要SQLHENV的ODBC函数前，必须先设置该属性，否者将遇到HY010错误。

                            取值如下：

                            SQL_OV_ODBC3_80    ODBC 3.8兼容

                            SQL_OV_ODBC3       ODBC 3.0兼容

                            SQL_OV_ODBC2       ODBC 2.0兼容

    SQL_ATTR_OUTPUT_NTS 

    ODBC 3.0，32位整数，表示驱动返回字符串的方式，取值如下：

                         SQL_TRUE   驱动返回字符串以NULL字符结尾，默认方式。

                         SQL_FALSE  驱动返回字符串不以NULL字符结尾。

                                            该选项值默认不被实现，因此调用SQLSetEnvAttr设置时可能返回错误（HYC00）。

转载于:https://my.oschina.net/luckysym/blog/190610