LibOciLib使用说明（2017-1-26更新）
LibOciLib使用说明
整理者：赤勇玄心行天道
QQ：280604597
Email：280604597@qq.com
大家有什么不明白的地方，或者想要详细了解的地方可以联系我，我会认真回复的！
你可以随意转载，无需注明出处！
写文档实属不易，我希望大家能捐助我，继续支持我的工作，我会继续努力帮助大家，金额随意，1块也行，感谢！
支付宝：280604597@qq.com
QQ红包
OCILIB的QQ群：553666676
1、 复制解决方案根目录下的“LibOciLib”文件夹到调用程序的解决方案根目录下。
2、 调用程序需添加代码：
|
#include "..\LibOciLib\ocilib.h" #if (defined _WIN64) && (defined _DEBUG) #pragma comment(lib, "..\\LibOciLib\\LibOciLib_x64_Debug_MDd_LIB.lib") #pragma comment(lib, "..\\LibOciLib\\oci_x64.lib") #elif (defined _WIN64) && (defined NDEBUG) #pragma comment(lib, "..\\LibOciLib\\LibOciLib_x64_Release_MD_LIB.lib") #pragma comment(lib, "..\\LibOciLib\\oci_x64.lib") #elif (defined _WIN32) && (defined _DEBUG) #pragma comment(lib, "..\\LibOciLib\\LibOciLib_x86_Debug_MDd_LIB.lib") #pragma comment(lib, "..\\LibOciLib\\oci_x86.lib") #elif (defined _WIN32) && (defined NDEBUG) #pragma comment(lib, "..\\LibOciLib\\LibOciLib_x86_Release_MD_LIB.lib") #pragma comment(lib, "..\\LibOciLib\\oci_x86.lib") #endif |
3、 编译调用程序的项目。
1 简介
官方网站：http://vrogier.github.io/ocilib/
2 字段数据类型对应规则
|
DATABASE TYPE |
C API TYPE |
C API SUBTYPE |
C++ API |
C++ API SUBTYPE |
|
PL/SQL BOOLEAN |
boolean |
bool |
||
|
NUMBER |
short |
short |
||
|
NUMBER |
unsigned short |
unsigned short |
||
|
NUMBER |
int |
int |
||
|
NUMBER |
unsigned int |
unsigned int |
||
|
NUMBER |
big_int (long long) |
big_int (long long |
||
|
NUMBER |
big_uint (unsigned long long) |
big_uint (unsigned long long) |
||
|
NUMBER |
float |
float |
||
|
NUMBER |
double |
double |
||
|
NUMBER |
OCI_Number * |
ocilib::number |
||
|
FLOAT |
double |
double |
||
|
BINARY FLOAT |
float |
float |
||
|
BINARY DOUBLE |
double |
float |
||
|
CHAR |
otext * |
ocilib::ostring |
||
|
VARCHAR |
otext * |
ocilib::ostring |
||
|
VARCHAR2 |
otext * |
ocilib::ostring |
||
|
NVARCHAR |
otext * |
ocilib::ostring |
||
|
NVARCHAR2 |
otext * |
ocilib::ostring |
||
|
ROWID |
otext * |
ocilib::ostring |
||
|
UROWID |
otext * |
ocilib::ostring |
||
|
VARRAW |
void * |
ocilib::Raw |
||
|
RAW |
void * |
ocilib::Raw |
||
|
LONG |
OCI_Long * |
OCI_CLONG |
ocilib::Clong |
|
|
LONG VARCHAR |
OCI_Long * |
OCI_CLONG |
ocilib::Clong |
|
|
LONG RAW |
OCI_Long * |
OCI_BLONG |
ocilib::Blong |
|
|
DATE |
OCI_Date * |
ocilib::Date |
||
|
TIMESTAMP |
OCI_Timestamp * |
OCI_TIMESTAMP |
ocilib::Timestamp |
NoTimeZone |
|
TIMESTAMP WITH TIME ZONE |
OCI_Timestamp * |
OCI_TIMESTAMP_TZ |
ocilib::Timestamp |
WithTimeZone |
|
TIMESTAMP WITH LOCAL TIME ZONE |
OCI_Timestamp * |
OCI_TIMESTAMP_LTZ |
ocilib::Timestamp |
WithLocalTimeZone |
|
INTERVAL YEAR TO MONTH |
OCI_Interval * |
OCI_INTERVAL_YM |
ocilib::Interval |
YearMonth |
|
INTERVAL DAY TO SECOND |
OCI_Interval * |
OCI_INTERVAL_DS |
ocilib::Interval |
DaySecond |
|
Character LOB |
OCI_Lob * |
OCI_CLOB |
ocilib::Clob |
LobCharacter |
|
National Character LOB |
OCI_Lob * |
OCI__NCLOB |
ocilib::NClob |
LobNationalCharacter |
|
Binary LOB |
OCI_Lob * |
OCI_BLOB |
ocilib::Blob |
LobBinary |
|
Binary FILE |
OCI_File * |
OCI_BFILE |
ocilib::File |
|
|
VARRAY |
OCI_Coll * |
OCI_COLL_VARRAY |
ocilib::Collection |
Varray |
|
NESTED TABLE |
OCI_Coll * |
OCI_COLL_NESTED_TABLE |
ocilib::Collection |
NestedTable |
|
PL/SQL INDEXED TABLE |
OCI_Coll * |
OCI_COLL_INDEXED_TABLE |
ocilib::Collection |
IndexedTable |
|
NAMED DATATYPE (TYPE, OBJECT) |
OCI_Object * |
ocilib::Object |
||
|
PL/SQL RECORD |
OCI_Object * |
ocilib::Object |
||
|
REF |
OCI_Ref * |
ocilib::Reference |
3 常用函数
OCI_Initialize() 初始化OCILIB库
OCI_Cleanup() 释放OCILIB库
OCI_ConnectionCreate() 创建Oracle数据库连接，并返回Oracle数据库连接句柄
OCI_ConnectionFree() 断开Oracle数据库连接，并释放Oracle数据库连接句柄
OCI_GetServerMajorVersion() 获取Oracle数据库服务器版本号
OCI_GetServerMinorVersion() 获取Oracle数据库服务器版本号
OCI_GetServerRevisionVersion() 获取Oracle数据库服务器版本号
OCI_GetVersionConnection() 获取Oracle数据库服务器版本号
OCI_StatementCreate() 创建Statement句柄，Statement句柄用于执行SQL语句
OCI_StatementFree() 释放Statement句柄
OCI_Prepare() 准备SQL语句
OCI_BindString() 绑定SQL语句变量
OCI_Execute() 执行SQL语句
OCI_ExecuteStmt() 准备并执行SQL语句
OCI_GetResultset() 获取结果集句柄
OCI_ReleaseResultsets() 释放结果集句柄
OCI_FetchNext() 获取结果集句柄的第一条或下一条数据
OCI_GetString() 获取结果集句柄的当条数据的某个字段的字符串内容
OCI_GetInt() 获取结果集句柄的当条数据的某个字段的整数内容
3.1 函数模板(未完成)
|
函数名称 |
xxx |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
函数主要功能说明。 |
|
函数声明 |
类型 函数名 ( 类型 参数1, 类型 参数2, …… ); |
|
函数参数 |
参数1，[输入|输出|输入&输出]： 参数说明。 |
|
参数2，[输入|输出|输入&输出]： 参数说明。 |
|
|
…… |
|
|
返回值 |
返回值1：返回值说明。 返回值2：返回值说明。 …… |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
…… …… |
3.2 初始化
3.2.1 OCI_Initialize
|
函数名称 |
OCI_Initialize |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
初始化OCILIB库，必须初始化后才能调用OCILIB库函数。 本函数只需调用一次，再次调用在函数内部自动忽略。 |
|
函数声明 |
boolean OCI_Initialize ( POCI_ERROR err_handler, const mtext * lib_path, unsigned int mode ); |
|
函数参数 |
err_handler，[输入]： 存放当执行数据库操作出错时的出错回调函数的内存指针，函数声明应为void err_handler (OCI_Error * err)，err参数为错误码句柄。 如果本参数为NULL，表示不使用回调函数。 |
|
lib_path，[输入]： 存放Oracle数据库的Oci动态库的上级路径字符串的内存指针，例如：C:\instantclient_11_2。 如果本参数为NULL，表示从ORACLE_HOME环境变量获取Oracle数据库的动态库的路径。 如果要使本参数生效，需要在编译OCILIB库时指定OCI_IMPORT_RUNTIME宏，否则本参数将自动忽略为NULL。 |
|
|
mode，[输入]： 存放模式标记，可以为（用'|'选一至多个）： OCI_ENV_DEFAULT宏（0x0000）： 默认模式，本标记强制设置。 OCI_ENV_THREADED宏（0x0001）： 如果设置本标记，表示启用多线程支持使用本库。 如果不设置本标记，表示单线程使用本库，不能多线程使用本库，如果多线程使用会出现意外。 OCI_ENV_CONTEXT宏（0x0002）： 如果设置本标记，表示启用线程上下文错误处理，其实就是用线程上下文保存每一次数据库操作的错误信息，以便可以调用OCI_GetLastError()函数来查看上次数据库操作的错误信息。 如果不设置本标记，表示不保存数据库操作的错误信息，调用OCI_GetLastError()函数将无法查看到错误信息。 是否设置本标记不影响err_handler参数指定的出错回调函数。 OCI_ENV_EVENTS（0x0004）： enables events for subscription, HA Events, AQ notifications。 |
|
|
返回值 |
非0：成功。 0：失败，加载Oracle数据库的动态库或OCILIB动态库失败。 |
|
错误码 |
无 |
|
线程安全 |
否 |
|
原子操作 |
否 |
|
其他说明 |
本函数会加载Oracle数据库的动态库到调用进程。 如果程序不会再调用OCILIB库，可以调用OCI_Cleanup()函数释放OCILIB库。 |
3.2.2 OCI_Cleanup
|
函数名称 |
OCI_Cleanup |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
释放OCILIB库，释放后OCILIB库函数将不能再调用。 释放后，如果需要再次调用OCILIB库，再次初始化OCILIB库即可。 只需在初始化OCILIB库后，不再调用OCILIB库时，调用本函数，未初始化OCILIB库就调用本函数无意义。 |
|
函数声明 |
boolean OCI_Cleanup ( void ); |
|
函数参数 |
无 |
|
返回值 |
非0：成功。 0：失败。 |
|
错误码 |
无 |
|
线程安全 |
否 |
|
原子操作 |
否 |
|
其他说明 |
本函数会从调用进程卸载Oracle数据库的动态库。 |
3.3 错误处理
3.3.1 OCI_GetLastError(未完成)
|
函数名称 |
OCI_GetLastError |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取最近一次调用OCILIB库的函数的错误或者警告。 |
|
函数声明 |
OCI_Error * OCI_GetLastError ( void ); |
|
函数参数 |
无 |
|
返回值 |
非NULL：错误句柄，表示最近一次调用OCILIB库的函数出现了错误或者警告。 NULL：没有错误或者警告，表示最近一次调用OCILIB库的函数成功完成。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
|
3.3.2 OCI_ErrorGetString
|
函数名称 |
OCI_ErrorGetString |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
根据错误句柄，获取错误或警告的提示信息字符串。 |
|
函数声明 |
const otext * OCI_ErrorGetString ( OCI_Error * err ); |
|
函数参数 |
err，[输入]： 存放错误句柄，不能为NULL。 |
|
返回值 |
错误或警告的提示信息字符串的内存指针。 |
|
错误码 |
无 |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
提示信息字符串示例：ORA-12154: TNS: 无法解析指定的连接标识符 |
3.3.3 OCI_ErrorGetType(未完成)
|
函数名称 |
OCI_ErrorGetType |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
根据错误句柄，获取错误类型，包括：Oracle错误、OCILIB错误、Warning警告。 |
|
函数声明 |
unsigned int OCI_ErrorGetType( OCI_Error * err ) |
|
函数参数 |
err，[输入]： 存放错误句柄，不能为NULL。 |
|
返回值 |
OCI_ERR_ORACLE：Oracle错误。 OCI_ERR_OCILIB：OCILIB错误。 OCI_ERR_WARNING：Warning警告。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
|
3.4 连接数据库
3.4.1 OCI_ConnectionCreate(未完成)
|
函数名称 |
OCI_ConnectionCreate |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
创建一个Oracle数据库的连接，并返回Oracle数据库连接句柄。 |
|
函数声明 |
OCI_Connection * OCI_ConnectionCreate ( const mtext * db, const mtext * user, const mtext * pwd, unsigned int mode ); |
|
函数参数 |
db，[输入]： 存放连接Oracle数据库的连接描述符字符串的内存指针，也可以直接存放连接描述符的配置字符串的内存指针。 连接描述符的配置在oracle的安装路径下的network/admin/tnsnames.ora中。 连接描述符的配置字符串就是tnsnames.ora文件中连接描述符等于符号后面所填写的内容。 |
|
user，[输入]： 存放连接Oracle数据库的用户名字符串的内存指针。 |
|
|
pwd，[输入]： 存放连接Oracle数据库的用户名对应的密码字符串的内存指针。 |
|
|
mode，[输入]： 存放连接Oracle数据库的会话模式，可以为（选一至一个）： OCI_SESSION_DEFAULT宏（0x0000）： 以normal普通身份登陆Oracle数据库。 OCI_SESSION_SYSDBA宏（0x0002）： 以SYSDBA系统管理员身份登陆Oracle数据库。 OCI_SESSION_SYSOPER宏（0x0004）： 以SYSOPER系统操作员身份登陆Oracle数据库。 OCI_SESSION_XA宏（0x0001）： Oracle XA support OCILIB supports Oracle XA connectivity. In order to get a connection using the XA interface : Pass to the parameter 'db' the value of the 'DB' parameter of the given XA connection string pased to the Transaction Processing Monitor (TPM) Pass NULL to the 'user' and 'pwd' parameters Pass the value OCI_SESSION_XA to parameter 'mode'
Oracle XA Connection String The XA connection string used in a transaction monitor to connect to Oracle must be compatible with OCILIB : the XA parameter 'Objects' MUST be set to 'true' If OCI_ENV_THREADED is passed to OCI_Initialize(), the XA parameter 'Threads' must be set to 'true', otherwise to 'false' If OCI_ENV_EVENTS is passed to OCI_Initialize(), the XA parameter 'Events' must be set to 'true', otherwise to 'false' As Oracle does not support Unicode UTF16 characterset through the XA interface, Only OCI_CHARSET_ANSI builds of OCILIB can be used You still can use UTF8 if the NLS_LANG environment variable is set with a valid UTF8 NLS value DO NOT USE OCI_CHARSET_MIXED or OCI_CHARSET_WIDE OCILIB builds with XA connections |
|
|
返回值 |
非NULL：连接成功，Oracle数据库连接句柄。 NULL：连接失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
如果要断开连接，可以调用OCI_ConnectionFree()函数。 |
3.4.2 OCI_ConnectionFree(未完成)
|
函数名称 |
OCI_ConnectionFree |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
断开一个Oracle数据库的连接。 |
|
函数声明 |
boolean OCI_ConnectionFree ( OCI_Connection * con ) |
|
函数参数 |
con，[输入]： 存放调用OCI_ConnectionCreate()函数返回的Oracle数据库连接句柄，不能为NULL。 本参数不能为错误的Oracle数据库连接句柄，否则会内存读写错误。 |
|
返回值 |
非0：断开成功。 0：断开失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
ORA-0：指定的Oracle数据库连接句柄为NULL。 |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
Oracle数据库连接句柄在断开后就不能再使用了，再用就会报错误的Oracle数据库连接句柄。 |
3.5 执行Statement
3.5.1 OCI_StatementCreate(未完成)
|
函数名称 |
OCI_StatementCreate |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
根据Oracle数据库连接句柄，创建Statement对象句柄。 |
|
函数声明 |
OCI_Statement * OCI_StatementCreate ( OCI_Connection * con ); |
|
函数参数 |
con，[输入]： 存放Oracle数据库连接句柄。 |
|
返回值 |
非NULL：成功，Statement对象句柄。 NULL：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
创建完Statement对象句柄，就可以开始准备、解析并执行SQL语句或PL/SQL代码块了。 执行一个SQL语句或PL/SQL代码块需要经过三个步骤：准备、解析、执行。具体如下： 准备就是将SQL语句或PL/SQL代码块存放到Statement对象句柄。 解析就是让Oracle数据库服务器将准备好的SQL语句或PL/SQL代码块进行分析是否可以被执行。 执行就是将已经解析通过后的SQL语句或PL/SQL代码块进行执行。 一个Statement对象句柄在经过准备、解析、执行步骤之后，如果还需要再执行任何SQL语句或PL/SQL代码块，必须要重新进行准备、解析、执行步骤，不能只准备一次，然后重复执行，否则会出现意外错误。
当Statement对象句柄不再使用时，应调用OCI_StatementFree()函数释放Statement对象句柄。 |
3.5.2 OCI_StatementFree(未完成)
|
函数名称 |
OCI_StatementFree |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
释放Statement对象句柄。 |
|
函数声明 |
OCI_EXPORT boolean OCI_StatementFree ( OCI_Statement * stmt ); |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
返回值 |
非0：成功。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.5.3 OCI_Prepare(未完成)
|
函数名称 |
OCI_Prepare |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
向指定的Statement对象句柄里，准备一个SQL语句或PL/SQL代码块，该SQL语句或PL/SQL代码块不会被解析和执行。 |
|
函数声明 |
boolean OCI_Prepare ( OCI_Statement * stmt, const otext * sql ) |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
sql，[输入]： 存放SQL语句或PL/SQL代码块字符串的内存指针，不能为NULL。 如果是SQL语句，不能在末尾添加';'分号，例如：select * from dual。 如果是PL/SQL代码块，必须要在末尾添加';'分号，例如：begin dbms_output.new_line(); end;。 |
|
|
返回值 |
非0：成功，或有警告，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
一般在调用本函数后，会再对SQL语句或PL/SQL代码块中的变量进行绑定，然后再调用OCI_Execute()函数解析并执行。如果不需要绑定变量的，一般会调用OCI_ExecuteStmt()函数来一次性完成准备、解析和执行。 如果SQL语句或PL/SQL代码块中有变量需要绑定，绑定变量的格式都是冒号后面加变量名，例如：insert into table values (:var1, :var2)。 |
3.5.4 OCI_Execute(未完成)
|
函数名称 |
OCI_Execute |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
根据指定的Statement对象句柄，解析并执行一个已经准备好的并绑定了变量的SQL语句或PL/SQL代码块。 |
|
函数声明 |
boolean OCI_Execute ( OCI_Statement * stmt ) |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
返回值 |
非0：成功，或有警告，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
|
3.5.5 OCI_ExecuteStmt(未完成)
|
函数名称 |
OCI_ExecuteStmt |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
向指定的Statement对象句柄里，准备、解析并执行一个SQL语句或PL/SQL代码块。 |
|
函数声明 |
OCI_EXPORT boolean OCI_ExecuteStmt ( OCI_Statement * stmt, const otext * sql ); |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
sql，[输入]： 存放SQL语句或PL/SQL代码块字符串的内存指针，不能为NULL。 如果是SQL语句，不能在末尾添加';'分号，例如：select * from dual。 如果是PL/SQL代码块，必须要在末尾添加';'分号，例如：begin dbms_output.new_line(); end;。 |
|
|
返回值 |
非0：成功，或有警告，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
如果成功执行了Select查询语句，就可以调用OCI_GetResultset()函数来获取结果集。 |
3.5.6 OCI_Parse(未完成)
|
函数名称 |
OCI_Parse |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
向指定的Statement对象句柄里，准备并解析一个SQL语句或PL/SQL代码块，该SQL语句或PL/SQL代码块不会被执行。 |
|
函数声明 |
boolean OCI_Parse ( OCI_Statement * stmt, const otext * sql ) |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
sql，[输入]： 存放SQL语句或PL/SQL代码块字符串的内存指针，不能为NULL。 如果是SQL语句，不能在末尾添加';'分号，例如：select * from dual。 如果是PL/SQL代码块，必须要在末尾添加';'分号，例如：begin dbms_output.new_line(); end;。 |
|
|
返回值 |
非0：成功，或有警告，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
|
3.6 控制Statement
3.6.1 OCI_GetFetchSize(未完成)
|
函数名称 |
OCI_GetFetchSize |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取指定的Statement对象句柄在每次抽取数据时从Oracle数据库服务器预抽取多少行的数据。 |
|
函数声明 |
unsigned int OCI_GetFetchSize ( OCI_Statement * stmt ) |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
返回值 |
预抽取多少行的数据，默认值为OCI_FETCH_SIZE宏。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
预抽取就是先从Oracle数据库服务器一次性抽取多行数据存放到缓存中，然后再从该缓存中依次抽取数据出来，当缓存中的数据抽取完毕时，又会从Oracle数据库服务器一次性抽取多行数据存放到缓存中，直到全部抽取完毕，这样可以加快抽取速度，减少Oracle数据库服务器的压力。 |
3.6.2 OCI_SetFetchSize(未完成)
|
函数名称 |
OCI_SetFetchSize |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
修改指定的Statement对象句柄在每次抽取数据时从Oracle数据库服务器预抽取多少行的数据。 |
|
函数声明 |
boolean OCI_SetFetchSize ( OCI_Statement * stmt, unsigned int size ) |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
size，[输入]： 存放预抽取多少行的数据的值。 |
|
|
返回值 |
非0：成功，或有警告，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是，需启用多线程支持 |
|
其他说明 |
本函数必须要在调用OCI_GetResultset()函数之前调用，否则将无效。 调大预抽取行数可以加快抽取速度，越打越快，一般为10000至50000能达到最快抽取速度。 |
3.7 抽取结果集数据
3.7.1 OCI_GetResultset(未完成)
|
函数名称 |
OCI_GetResultset |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取根据Statement对象句柄执行Select查询语句后的结果集句柄。 |
|
函数声明 |
OCI_Resultset * OCI_GetResultset ( OCI_Statement * stmt ); |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
返回值 |
非0：成功，结果集句柄。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
当结果集句柄不再使用时，应调用OCI_ReleaseResultsets()函数释放结果集句柄。 |
3.7.2 OCI_ReleaseResultsets(未完成)
|
函数名称 |
OCI_ReleaseResultsets |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
释放结果集句柄。 |
|
函数声明 |
boolean OCI_ReleaseResultsets ( OCI_Statement * stmt ); |
|
函数参数 |
stmt，[输入]： 存放Statement对象句柄。 |
|
返回值 |
非0：成功。 0：失败，通过err_handler()出错回调函数或调用OCI_GetLastError()函数查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.3 OCI_GetColumnCount(未完成)
|
函数名称 |
OCI_GetColumnCount |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取结果集句柄的字段个数。 |
|
函数声明 |
unsigned int OCI_GetColumnCount ( OCI_Resultset * rs ); |
|
函数参数 |
rs，[输入]： 存放结果集句柄。 |
|
返回值 |
字段个数。 |
|
错误码 |
无 |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.4 OCI_GetColumn(未完成)
|
函数名称 |
OCI_GetColumn |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取结果集句柄的指定索引的字段句柄。 |
|
函数声明 |
OCI_Column * OCI_GetColumn ( OCI_Resultset * rs, unsigned int index ); |
|
函数参数 |
rs，[输入]： 存放结果集句柄。 |
|
index，[输入]： 存放字段索引的值，从1开始。 |
|
|
返回值 |
非NULL：成功，返回值就是字段句柄。 NULL：失败，字段索引超出范围或发生错误，无法查看错误码。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.5 OCI_ColumnGetName(未完成)
|
函数名称 |
OCI_ColumnGetName |
|
头文件 |
#include <xxx.h> #include <xxx.h> |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取字段句柄的名称字符串。 |
|
函数声明 |
const otext * OCI_ColumnGetName ( OCI_Column * col ); |
|
函数参数 |
col，[输入]： 存放字段句柄。 |
|
返回值 |
名称字符串的内存指针。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.6 OCI_ColumnGetSQLType(未完成)
|
函数名称 |
OCI_ColumnGetSQLType |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取字段句柄的类型字符串，只有类型，没有精度。 例如：VARCHAR2。 |
|
函数声明 |
const otext * OCI_ColumnGetSQLType ( OCI_Column * col ) |
|
函数参数 |
col，[输入]： 存放字段句柄。 |
|
返回值 |
类型字符串的内存指针。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.7 OCI_ColumnGetFullSQLType(未完成)
|
函数名称 |
OCI_ColumnGetFullSQLType |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取字段句柄的完整类型字符串，包括类型和精度。 注意：VARCHAR2类型的字段会写成VARCHAR，但是不影响，因为Oracle中VARCHAR和VARCHAR2是同一种类型。 例如：VARCHAR(30)。 |
|
函数声明 |
unsigned int OCI_ColumnGetFullSQLType ( OCI_Column * col, otext * buffer, unsigned int len ); |
|
函数参数 |
col，[输入]： 存放字段句柄。 |
|
buffer，[输入]： 存放用于存放字段完整类型字符串的内存指针。 |
|
|
len，[输入]： 存放用于存放字段完整类型字符串的内存大小。 |
|
|
返回值 |
向用于存放字段完整类型字符串的内存写入了多少长度的字符，单位字节，不包括'\0'结束符。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.8 OCI_ColumnGetSize(未完成)
|
函数名称 |
OCI_ColumnGetSize |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取字段句柄的大小，不同数据类型单位不一样。
VARCHAR2类型：单位为字符个数，和精度一致。 NUMBER类型：单位为字节，通常都是22个字节。 DATE类型：单位为字节，通常都是7个字节。 TIMESTAMP类型：单位为字节，通常都是11个字节，精度为0是7个字节。 TIMESTAMP WITH LOCAL TIME ZONE类型：单位为字节，通常都是11个字节，精度为0是7个字节。 TIMESTAMP WITH TIME ZONE类型：单位为字节，通常都是13个字节。 |
|
函数声明 |
unsigned int OCI_ColumnGetSize ( OCI_Column * col ); |
|
函数参数 |
col，[输入]： 存放字段句柄。 |
|
返回值 |
返回值1：返回值说明。 返回值2：返回值说明。 …… |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
3.7.9 OCI_ColumnGetNullable(未完成)
|
函数名称 |
OCI_ColumnGetNullable |
|
头文件 |
#include "..\LibOciLib\ocilib.h" |
|
库文件 |
#pragma comment(lib, "xxx.lib") |
|
函数功能 |
获取字段句柄的值可否为NULL。 |
|
函数声明 |
boolean OCI_ColumnGetNullable ( OCI_Column * col ); |
|
函数参数 |
col，[输入]： 存放字段句柄。 |
|
返回值 |
非0：可以为NULL。 0：不可以为NULL。 |
|
错误码 |
EXXXX：错误码说明。 EXXXX：错误码说明。 …… |
|
线程安全 |
是，需启用多线程支持 |
|
原子操作 |
是 |
|
其他说明 |
|
