嵌入式SQL
SQL语言提供了两种不同的使用方法
- 交互式
- 嵌入式
为什么要引入嵌入式SQL
- SQL语言是非过程性语言
- 事务处理应用需要高级语言
这两种方式细节上有差别,在程序设计的环境下,SQL语句要做某些必要的扩充
嵌入式SQL的处理过程
主语言
- 嵌入式SQL是将SQL语句嵌入程序设计语言中,被嵌入的程序设计语言,如C,C++,Java,称为宿主语言,简称主语言
处理过程
- 预编译方法
为了区分SQL语句和主语言语句,所有SQL语句必须加前缀exec sql,主语言为C语言时,语句格式:exec sql <SQL语句>;
这里为了方便理解和阅读,这里的代码都用的是小写,真正写在程序里涉及到SQL语句的代码是大写的,后续为了方便阅读,继续使用小写
嵌入式SQL语句与主语言之间的通信
将SQL嵌入到高级语言中混合编程,程序中会含有两种不同计算模型的语句
- SQL语句
- 描述性的面向集合的语句
- 负责操纵数据库
- 高级语言语句
- 过程性的面向记录的语句
- 负责控制逻辑流程
数据库工作单元与源程序工作单元之间的通信
- 向主语言传递SQL语句的执行状态信息,使主语言能够据此控制程序流程,主要用SQL通信区实现
- 主语言向SQL语句提供参数,主要用主变量实现
- 将SQL语句查询数据库的结果交主语言处理,主要用主变量和游标实现
SQL通信区
SQLCA:一个数据结构
用途:
- SQL语句执行后,系统反馈给应用程序信息
- 描述系统当前工作状态
- 描述运行环境
- 这些信息将送到SQL通信区中
- 应用程序从SQL通信区中取出这些状态信息,据此决定接下来执行的语句
使用方法:
- 定义SQLCA
- 用exec sql include sqlca(全部大写)定义
- 使用SQLCA
- SQLCA中有一个存放每次执行SQL语句后返回代码的变量SQLCODE
- 如果SQLCODE等于预定义的常量SUCCESS,则表示SQL语句成功,否则表示出错
- 应用程序每执行完一条SQL语句之后都应该测试一下SQLCODE的值,以了解该SQL语句执行情况并做相应处理
主变量
嵌入式SQL语句中可以使用主语言的程序变量来输入或输出数据
在SQL语句总使用的主语言程序变量称为主变量
主变量的类型
- 输入主变量
- 由应用程序对其赋值,SQL语句引用
- 输出主变量
- 由SQL语句对其赋值或设置状态信息,返回给应用程序
指示变量
- 是一个整形变量,用来“指示”所指主变量的值或条件
- 一个主变量可以附带一个指示变量
- 指示变量的用途
- 指示输入主变量是否为空值
- 检测输出变量是否为空值,值是否被截断
在SQL语句中使用主变量和指示变量的方法
- 说明主变量和指示变量(全部大写)
begin declare section
(说明主变量和指示变量)
end declare section
- 使用主变量
- 说明之后的主变量可以在SQL语句中任何一个能够使用表达式的地方出现
- 为了与数据库对象名(表名,视图名,列名等)区别,SQL语句中的主变量名钱要加冒号(:)作为标志
- 使用指示变量
- 指示变量前也必须加冒号标志
- 必须紧跟在所指主变量之后
在SQL语句之外(主语言语句中)使用主变量和指示变量的方法
- 可以直接引用,不必加冒号
游标
为什么要使用游标
- SQL语言与主语言具有不同数据处理方式
- SQL语言是面向集合的,一条SQL语句原则上可以产生或处理多条记录
- 主语言是面向记录的,一组主变量一次只能存放一条记录
- 仅使用主变量并不能完全满足SQL语句向应用程序输出数据的要求
- 嵌入式SQL引入了游标的概念,用来协调这两种不同的处理方式
游标
- 游标是系统为用户开设的一个数据缓冲区,存放SQL语句的执行结果
- 每个游标区都有一个名字
- 用户可以用SQL语句逐一从游标中获取记录,并赋给主变量,交由主语言进一步处理
建立和关闭数据库连接
建立数据库连接
exec sql connect to target[as connection-name][user user-name];
target是要连接的数据库服务器,除了数据库服务器,连接名和用户名,其他的都要大写
- 常见的服务器标识串,如<dbname>@<hostname>:<port>
- 包含服务器标识SQL串常量
- default
connect-name是可选的连接名,连接名必须是一个有效的标识符
在整个程序内之一偶一个连接时可以不指定连接名
程序运行过程中可以修改当前连接
exec sql set connection connection-name | default;
关闭数据库连接
exec sql disconnect [connection];
除了中括号里面的都要大写
EXEC SQL BEGIN DECLARE SECTION;
/*主变量说明开始*/
char Deptname[20];
char Hsno[9];
char Hsname[20];
char Hssex[2];
int HSage;
int NEWAGE;
EXEC SQL END DECLARE SECTION;
/*主变量说明结束*/
long SQLCODE;
EXEC SQL INCLUDE SQLCA;
/*定义SQL通信区*/
int main(void) {
/*C语言主程序开始*/
int count = 0;
char yn;
/*变量yn代表yes或no*/
printf("Please choose the department name(CS/MA/IS):");
scanf("%s", deptname);
/*为主变量deptname赋值*/
EXEC SQL CONNECT TO TEST@localhost:54321 USER "SYSTEM" / "MANAGER";
/*连接数据库TEST*/
EXEC SQL DECLARE SX CURSOR FOR
/*定义游标*/
SELECT Sno, Sname, Ssex, Sage
/*SX对应的语句*/
FROM Student
WHERE SDept = :detpname;
EXEC SQL OPEN SX;
/*打开游标SX,指向查询结果第一行*/
for (;;) {
/*用循环结构逐条处理结果集中的记录*/
EXEC SQL FETCH SX INTO : HSno, : Hsname, : HSsex, : HSage;
/*推进游标,将当前数据放入主变量*/
if (SQLCA.SQLCODE != 0)
/*SQLCODE != 0,表示操作不成功*/
break;
if (count++ == 0)
/*如果是第一行的话,先打出行头*/
printf("\n%-10s %-20s %-10s %-10s\n", "Sno", "Sname", "Ssex", "Sage");
printf("%-10s %-20s %-10s %-10d\n", HSno, Hsname, Hssex, HSage);
/*打印查询结果*/
printf("UPDATE AGE(y/n)?");
/*询问用户是否要更新该学生的年龄*/
do { scanf("%c", &yn); } while (yn != 'N' && yn != 'n' && yn != 'Y' && yn != 'y');
if (yn == 'y' || yn == 'Y') {
/*如果选择更新操作*/
printf("INPUT NEW AGE :");
scanf("%d", &NEWAGE);
/*用户输入新年龄到主变量中*/
EXEC SQL UPDATE Student
/*嵌入式SQL更新语句*/
SET Sage = :NEWAGE
WHERE CURRENT OF SX;
/*对当前游标指向的学生年龄进行更新*/
}
}
EXEC SQL CLOSE SX;
/*关闭游标SX,不再和查询结果对应*/
EXEC SQL COMMIT WORK;
/*提交更新*/
EXEC SQL DISCONNECT TEST;
/*断开数据库连接*/
}
不用游标的SQL语句
不用游标的SQL语句的种类
- 说明性语句
- 数据定义语句
- 数据控制语句
- 查询结果为单记录的select语句
- 非current形式的增删改语句
查询结果为单记录的select语句
这类语句不需要使用游标,只需用into子句指定存放查询结果的主变量
EXEC SQL SELECT Sno, Sname, Ssex, Sage, Sdept
INTO : HSno, : Hname, : Hsex, : Hage, : Hdept
FROM Student
WHERE Sno = : givensno;
/*把要查询的学生学号赋给为了主变量givensno*/
into子句,where子句和having短语的条件表达式中均可以使用主变量
查询返回到记录中,可能某些列值为空值null
如果查询结果实际上并不是单条记录,而是多条记录,则程序出错,关系数据库管理系统会在sqlca中返回错误信息
EXEC SQL SELECT Sno, Cno, Grade
INTO : Hsno, : Hcno, : Hgrade : Gradeid
/*指示变量Gradeid*/
From SC
WHERE Sno = : givensno AND Cno = : givencno;
/*如果Gradeid < 0,不论Hgrade为何值,均认为该学生成绩为空值*/
非current形式的增删改语句
在update的set子句和where子句中可以使用主变量,set子句还可以使用指示变量
/*修改某个学生选修1号课程的成绩*/
EXEC SQL UPDATE SC
SET Grade = :newgrade
/*修改的成绩已赋给主变量newgrade*/
WHERE Sno = :givensno;
/*学号赋给主变量givensno*/
使用游标的SQL语句
查询结果为多条记录的select语句
使用游标的步骤
说明游标
使用declare语句
语句格式
EXC SQL DECLARE <游标名> CURSOR
FOR <SELECT语句>;
功能:
是一条说明性语句,这时关系数据库关系系统并不执行select语句
打开游标
使用open语句
语句格式
EXEC SQL OPEN<游标名>;
功能:
- 打开游标实际上是执行相应的select语句,把查询结果取到缓冲区中
- 这时游标处于活动状态,指针指向查询结果集中的第一条记录
推进游标指针并取当前记录
使用fetch语句
语句格式
EXEC SQL FETCH <游标名>
INTO <主变量>[<指示变量>];
功能:
指定方向推动游标指针,同时将缓冲区中的当前记录取出来送至主变量供主语言进一步处理
关闭游标
使用close语句
语句格式:
EXEC SQL COLSE <游标名>;
功能:
关闭游标,释放结果集占用的缓冲区及其他资源
说明:
- 游标被关闭后,就不再和原来的查询结果集相联系
- 被关闭的游标可以再次被打开,与新的查询结果相联系
current形式的update语句和delete语句
用途:
- 非current形式的update语句和delete语句
- 面向集合的操作
- 一次修改和删除所有满足条件的记录
- 如果只想修改或删除其中某个记录
- 用带游标的select语句查出所有满足条件的记录
- 从中进一步找出要修改或删除的记录
- 用current形式的update语句和delete语句修改或删除之
- update语句和delete语句中要用子句WHERE CURRENT OF <游标名> 表示修改或删除的是最近一次取出的记录,即游标指针指向的记录
不能使用current形式的update语句和delete语句
- 当游标定义中的select语句带有union或order by子句
- 该select语句相当于定义了一个不可更新的视图
动态SQL
静态嵌入式SQL
- 静态嵌入式SQL语句能够满足一般要求
- 无法满足要到执行时才能够确定要提交的SQL语句、无法查询的条件
动态嵌入式SQL
- 允许在程序运行过程中临时“组装”SQL语句
- 支持动态组装SQL语句和动态参数两种形式
使用SQL语句主变量
SQL语句主变量
- 程序主变量包含的内容是SQL语句的内容,而不是原来保存数据的输入或输出变量
- SQL语句主变量在程序执行期间可以设定不同的SQL语句,然后立即执行
EXEC SQL BEGIN DECLARE SECTION;
const char* stmt = "CREATE TABLE test(a int);";
/*SQL语句主变量,内容是创建表的SQL语句*/
EXEC SQL END DECLARE SECTION;
EXEC SQL EXECUTE IMMEDIATE : stmt;
/*执行动态SQL语句*/
动态参数
SQL语句中的可变元素
使用参数符号(?)表示该位置的数据在运行时设定
主变量是在定义时设定的
动态参数的输入不是编译时完成绑定,而是通过prepare语句准备主变量和执行语句execute绑定数据或主变量来完成的
使用动态参数的步骤
- 声明SQL语句主变量
- 准备SQL语句(prepare)
EXEC SQL PREPARE <语句名>
FROM <SQL语句主变量>;
执行准备好的语句(execute)
EXEC SQL EXECUTE <语句名>
[INTO <主变量表>]
[USING <主变量或常量>];
/*向test中插入元组*/
EXEC SQL BEGIN DECLARE SECTION;
const char* stmt = "INSERT INTO test VALUES(?);";
/*声明SQL主变量内容是insert语句*/
EXEC SQL END DECLARE SECTION;
EXEC SQL PREPARE mystmt FROM : stmt;
/*准备语句*/
EXEC SQL EXECUTE mystmt USING 100;
/*执行语句,设定insert语句插入值100*/
EXEC SQL EXECUTE mystmt USING 200;
/*执行语句,设定insert语句插入值200*/
过程化SQL
过程化SQL的块结构
过程化SQL
- SQL的扩展
- 增加了过程化语句功能
- 基本结构是块
- 块之间可以互相嵌套
- 每个块完成一个逻辑操作
过程化SQL块的基本结构
- 定义部分——declare变量,常量,游标,异常等
- 定义的变量,常量等只能在该基本块中使用
- 当基本块执行结束时,定义就不再存在
- 执行部分
BEGIN
SQL语句,过程化SQL的流程控制语句
EXCEPTION
异常处理部分
END;
变量和常量的定义
变量定义
- 变量名 数据类型[[NOT NULL]:=初值表达式]或
- 变量名 数据类型[[NOT NULL]初值表达式]
常量定义
- 常量名 数据类型 CONSTANT :=常量表达式
- 常量必须要给一个值,并且该值在存在期间或常量的作用域内不能改变,如果试图修改它,过程化SQL将返回一个异常
赋值语句
- 变量名称 :=表达式
流程控制
过程化SQL功能
- 条件控制语句
- 循环控制语句
- 错误处理
条件控制语句
IF-THEN,IF-THEN-ELSE和嵌套的IF语句
(1) IF condition THEN
Sequence_of_statements;
END IF;
(2)IF condition THEN
Sequence_of_statement1;
ELSE
Sequence_of_statement2;
END IF;
(3)在THEN和ELSE子句中还可以再包含IF语句,即IF语句可以嵌套
循环控制语句
LOOP,WHILE-LOOP和FOR-LOOP
(1)简单的循环语句LOOP
LOOP
Sequence_of_statements;
END LOOP;
多数数据库服务器的过程化SQL都提供EXIT,BREAK或LEAVE等循环结束语句,保证LOOP语句块能够结束
(2)WHILE-LOOP
WHILE condition LOOP
Sequence_of_statements;
END LOOP;
- 每次执行循环体语句之前,首先对条件进行求值
- 如果条件为真,则执行循环体内的语句序列
- 如果条件为假,则跳过循环并把控制传递给下一个语句
(3)FOR-LOOP
FOR count IN[REVERSE] bound1 ... bound2 LOOP
Sequence_of_statements;
END LOOP;
错误处理
如果过程化SQL在执行时出现异常,则应该让程序在产生异常的语句处停下来,根据异常的类型去执行异常处理语句
SQL标准对数据库服务器提供什么样的异常处理做出了建议,要求过程化SQL管理器提供完善的异常处理机制
存储过程和函数
存储过程
过程化SQL块类型
- 命名块
- 编译后保存在数据库中,可以被反复调用,运行速度较快,过程和函数是命名块
- 匿名块
- 每次执行时都要进行编译,它不能被存储到数据库中,也不能在其他过程化SQL块中调用
存储过程的优点
存储过程:由过程化SQL语句书写的过程,经编译和优化后存储在数据库服务器中,使用时只要调用即可
存储过程的优点
- 运行效率高,安全性高
- 降低了客户机和服务器之间的通信量
- 方便实施企业规划
存储过程的用户接口
创建存储过程
CREATE OR REPLACE PROCEDURE 过程名([参数1,参数2,...])AS<过程化SQL块>;
过程名: 数据库服务器合法的对象标识
参数列表:用名字来标识调用时给出的参数值,必须指定值的数据类型。参数也可以定义输入参数,输出参数或输入/输出参数,默认为输入参数。
过程体:是一个<过程化SQL块>,包括声明部分和可执行语句部分
CREATE OR REPLACE PROCEDURE
TRANSFER(inAccount INT,outAccount INT,amount FLOAT)
/*定义存储过程TRANSFER,其参数为转入账户、转出账户、转账额度*/
AS DECLARE
totalDepositOut Float;
totalDepositln Float;
inAccountnum INT;
BEGIN
/*检查转储账户的余额*/
SELECT Total INTO totalDepositOut FROM Account
WHERE accountnum = outAccount;
IF totalDepositOut IS NULL THEN
/*如果转出账户不存在或账户中没有存款*/
ROLLBACK;
/*回滚事务*/
RETURN;
END IF;
IF totalDepositOut < amount THEN
/*如果账户存款不足*/
ROLLBACK;
/*回滚事务*/
RETURN;
END IF;
SELECT Accountnum INTO inAccountnum FROM Account
WHERE accountnum = inAccount;
IF inAccount IS NULL THEN
/*如果转入账户不存在*/
ROLLBACK;
/*回滚事务*/
RETURN;
END IF;
UPDATE Account SET total = total - amount
WHERE accountnum = outAccount;
/*修改转出账户余额,减去转出额*/
UPDATE Account SET total = total + amount
WHERE accountnum = inAccount;
/*修改转入账户余额,加上转出额*/
COMMIT;
/*提交转账事务*/
END;
执行存储过程
CALL/PERFROM PROCEDURE 过程名([参数1,参数2,...]);
使用CALL或者PREFORM等方式激活存储过程的执行
在过程化SQL中,数据库服务器支持在过程体中调用其他存储过程
/*从账户1中转100元到账户2中*/
CALL PROCEDURE
TRANSFER(1,2,100);
修改存储过程
ALTER PROCEDURE 过程名1 RENAME TO 过程名2;
删除存储过程
DROP PROCEDURE 过程名();
函数
函数和存储过程的异同
- 同:都是持久性存储模块
- 异:函数必须指定返回的类型
函数的定义语句格式
CREATE OR REPLACE FUNCTION 函数名([参数1,参数2,...])RETURNS<类型>AS<过程化SQL块>;
函数的执行语句格式
CALL/SELECT 函数名([参数1,参数2,...]);
修改函数
- 重命名
ALTER FUNCTION 过程名1 RENAME TO 过程名2;
- 重新编译
ALTER FUNCTION 过程名 COMPILE;
过程化SQL中的游标(自学)
ODBC编程
ODBC优点:
- 移植性好
- 能同时访问不同的数据库
- 共享多个数据资源
ODBC概述
ODBC产生的原因
- 由于不同的数据库管理系统的存在,在某个关系数据库管理系统下编写的应用程序就不能再另一个关系数据库管理系统下运行
- 许多应用程序需要共享多个部门的数据资源,访问不同的关系数据库管理系统
ODBC
- 是微软公司开放服务体系中有关数据库的一个组成部分
- 提供了一组访问数据库的应用程序接口
ODBC约束力
- 规范应用开发
- 规范关系数据库管理系统应用接口
ODBC工作原理概述
ODBC应用系统的体系结构
- 用户应用程序
- ODBC驱动程序管理器
- 数据库驱动程序
- 数据源
用户应用程序
ODBC应用程序包括的内容
- 请求连接数据库
- 向数据源发送SQL语句
- 为SQL语句执行结果分配存储空间,定义所读取的数据格式
- 获取数据库操作结果或处理错误
- 进行数据处理并向用户提交处理结果
- 请求事务的提交和回滚操作
- 断开与数据源的连接
驱动程序管理器:用来管理各种驱动程序
- 包含在ODBC32.DLL中
- 管理应用程序和驱动程序之间的通信
- 建立、配置或删除数据源,并查看系统当前所安装的数据库ODBC驱动程序
ODBC驱动程序管理器
驱动程序管理器:用来管理各种驱动程序
- 包含在ODBC32.DLL中
- 管理应用程序和驱动程序之间的通信
- 建立、配置或删除数据源,并查看系统当前所安装的数据库ODBC驱动程序
主要功能:
- 装载ODBC驱动程序
- 选择和连接正确的驱动程序
- 管理数据源
- 检查ODBC调用参数的合法性
- 记录ODBC函数的调用等
数据库驱动程序
ODBC通过驱动程序来提供应用系统与数据库平台的独立性
ODBC应用程序不能直接存取数据库
- 其各种操作请求由驱动程序管理器提交给某个关系数据库管理系统的ODBC驱动程序
- 通过调用驱动程序所支持的函数来存取数据库
- 数据库的操作结果也通过驱动程序返回给应用程序
- 如果应用程序要操纵不同的数据库,就要动态的链接到不同的驱动程序上
ODBC驱动程序类型
- 单束
- 数据源和应用程序在同一台机器上
- 驱动程序直接完成对数据库文件的I/O操作
- 驱动程序相当于数据管理器
- 多束
- 支持客户机——服务器、客户机——应用服务器/数据库服务器等网络环境下的数据访问
- 由驱动程序完成数据库访问请求的提交和结果集接收
- 应用程序使用驱动程序提供的结果集管理接口操纵执行后的结果数据
ODBC数据源管理
数据源:是最终用户需要访问的数据,包含了数据库位置和数据库类型等信息,是一种数据连接的抽象
数据源对最终用户是透明的
- ODBC给每个被访问的数据源指定唯一的数据源名,并映射到所有必要的、用来存取数据的低层软件
- 在连接中,用数据源名来代表用户名、服务器名、所连接的数据库名等
- 最终用户无须知道数据库管理系统或其他数据管理软件、网络以及有关ODBC驱动程序的细节
ODBC API基础
ODBC应用程序编程接口的一致性
- API一致性
- 包含核心级,扩展1级,扩展2级
- 语法一致性
- 包含最低限度SQL语法级,核心SQL语法级,扩展SQL语法级
函数概述
ODBC 3.0标准提供了76个函数接口
- 分配和释放环境句柄,连接句柄,语句句柄
- 连接函数
- 与信息相关的函数
- 事务处理函数
- 执行相关函数
- 编目函数
- 应用程序可以通过对编目函数的调用来获取数据字典的信息,如权限,表结构等
ODBC不同版本上的函数和函数使用是有差异的
句柄及其属性
句柄是32位整数值,代表一个指针
ODBC 3.0中句柄分类
- 环境句柄
- 连接句柄
- 语句句柄
- 描述符句柄
应用程序句柄之间的关系
- 每个ODBC应用程序需要建立一个ODBC环境,分配一个环境句柄,存取数据的全局性背景,如环境状态,当前环境状态诊断,当前在环境上分配的连接句柄等
- 一个环境句柄可以建立多个连接句柄,每一个连接句柄实现与一个数据源之间的连接
- 在一个连接中可以建立多个语句句柄,他不只是一个SQL语句,还包括SQL语句产生的结果集以及相关的信息等。
- 在ODBC 3.0中又提出了描述符句柄的概念,他是描述SQL语句的参数、结果集列的元数据集合
数据类型
ODBC数据类型
- SQL数据类型:用于数据源
- C数据类型:用于应用程序的C代码
应用程序可以通过SSQLGetTypeInfo来获取不同的驱动程序对于数据类型的支持情况
SQL数据类型 | C数据类型 | |
SQL数据类型 | 数据源之间的转换 | 应用程序变量传送到与参数 |
C数据类型 | 从结果集列中返回到应用程序变量 | 应用程序变量之间的转换 |
ODBC的工作流程
将KingbaseES数据库中Student表的数据备份到SQL Server数据库中
- 该应用涉及两个不同的关系数据库管理系统中的数据源
- 使用ODBC来开发应用程序,只要改变应用程序中连接函数的参数,就可以连接不同关系数据库管理系统的驱动程序,连接两个数据源
在应用程序运行前,已经在KingbaseES和SQL Server中分别建立了Student关系表
应用程序要执行的操作
- 在KingbaseES上执行SELECT * FROM Student;
- 把获取的结果集,通过多次执行INSERT语句插入到SQL Server的Student表中
操作步骤:
- 配置数据源
- 初始化环境
- 建立连接
- 分配语句句柄
- 执行SQL语句
- 结果集处理
- 中止处理
配置数据源
- 运行数据源管理工具来进行配置
- 使用Driver Manager提供的ConfigDsn函数来增加、修改或删除数据源
//定义句柄和变量
int main(){
//Step 1 定义句柄和变量
//以king开头的表示的是连接KingbaseES的变量
//以server开头的表示的是连接SQLServer的变量
SQLHENV kinghenv,serverhenv;
//环境句柄
SQLHDBC kinghdbc,serverhdbc;
//连接句柄
SQLHSTMT kinghstmt,serverhstmt;
// 语句句柄
SQLRETURN ret;
SQLCHAR sName[NAME_LEN],sDepart[DEPART_LEN],sSex[SSEX_LEN],sSno[SNO_LEN];
SQLINTEGER sAge;
SQLINTEGER
cbAge = 0,cbSno = SQL_NTS,cbSex = SQL_NTS,cbName = SQL_NTS,cbDepart = SQL_NTS;
}
初始化环境
没有和具体的驱动程序相关联,有Driver Manager来进行控制,并配置环境属性
应用程序通过调用连接函数和某个数据源进行连接后,Driver Manager才调用所连接的驱动程序中的SQLAllocHandle,来真正分配环境句柄的数据结构
// 初始化环境
ret = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&kinghenv);
ret = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&serverhenv);
ret = SQLSetEnvAttr(kinghenv,SQL_ATTR_ODBC_VERSION,(void*)SQL_OV_ODBC3,0);
ret = SQLSetEnvAttr(serverhenv,SQL_ATTR_ODBC_VERSION,(void*)SQL_OV_ODBC3,0);
建立连接
应用程序调用SQLAllocHandle分配连接句柄,通过SQLConnect、SQLDriverConnect或SQLBrowseConnect与数据源连接
SQLConnect连接函数的输入参数为:
- 配置好的数据源名称
- 用户ID
- 口令
// 建立连接
ret = SQLAllocHandle(SQL_HANDLE_DBC,kinghenv,&kinghdbc);
ret = SQLAllocHandle(SQL_HANDLE_DBC,serverhenv,&serverhdbc);
ret = SQLConnect(kinghdbc,"KingbaseES ODBC",SQL_NTS,"SYSTEM",SQL_NTS,"MANAGER",SQL_NTS);
// KingbaseES ODBC为数据源名,SYSTEM为用户名,MANAGER为用户密码
if(!SQL_SUCCEEDED(ret))
// 连接失败时返回错误值
return -1;
ret = SQLConnect(serverhdbc,"SQLServer",SQL_NTS,"sa",SQL_NTS,"sa",SQL_NTS);
if(!SQL_SUCCEEDED(ret))
return -1;
分配语句句柄
处理任何SQL语句之前,应用程序还需要首先分配一个语句句柄
语句句柄含有具体的SQL语句以及输出的结果集等信息
应用程序还可以通过SQLtStmtAttr来设置语句属性
// 初始化语句句柄
ret = SQLAllocHandle(SQL_HANDLE_STMT,kinghdbc,&kinghstmt);
ret = SQLSetStmtAttr(kinghstmt,SQL_ATTR_ROW_BIND_TYPE,(SQLPOINTER)SQL_BIND_BY_COLUMN,SQL_IS_INTEGER);
ret = SQLAllocHandle(SQL_HANDLE_STMT,serverhdbc,&serverhstmt);
执行SQL语句
应用程序处理SQL语句的两种方式
- 预处理
- 直接执行
如果SQL语句含有参数,应用程序为每个参数调用SQLBindParameter,并把他们绑定至应用程序变量
应用程序可以直接通过改变应用程序缓冲区的内容从而在程序中动态改变SQL语句的具体执行
应用程序根据语句类型进行的处理
- 有结果集的语句,则进行结果集处理
- 没有结果集的函数,可以直接利用本语句句柄继续执行新的语句或是获取行计数之后继续执行
在插入数据时,采用了预编译的方式,首先通过SQLPrepare来预处理SQL语句,然后将每一列绑定到用户缓冲区
// 两种方式执行语句
// 预编译带有参数的语句
ret = SQLPrepare(serverhstmt,"INSERT INTO STUDENT(SNO,SNAME,SSEX,SAGE,SDEPT)VALUES(?,?,?,?,?)",SQL_NTS);
if(ret == SQL_SUCCEEDED || ret == SQL_SUCCEEDED_WITH_INFO){
ret = SQLBindParameter(serverhstmt,1,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,SNO_LEN,0,sSno,0,&cbSno);
ret = SQLBindParameter(serverhstmt,2,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,NAME_LEN,0,sSno,0,&cbSno);
ret = SQLBindParameter(serverhstmt,2,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,2,0,sSex,0,&cbSex);
ret = SQLBindParameter(serverhstmt,4,SQL_PARAM_INPUT,SQL_LONG,SQL_INTEGER,0,0,&sAge,0,&cbAge);
ret = SQLBindParameter(serverhstmt,5,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,DEPART_LEN,0,sDepart,0,&cbDepart);
}
// 执行SQL语句
ret = SQLExecDirect(kinghstmt,"SELECT * FROM STUDENT",SQL_NTS);
if(ret == SQL_SUCCESS || ret == SQL_SUCCESS_WITH_INFO){
ret = SQLBindCol(kinghstmt,1,SQL_C_CHAR,sSno,SNO_LEN,&cbSno);
ret = SQLBindCol(kinghstmt,2,SQL_C_CHAR,sName,NAME_LEN,&cbName);
ret = SQLBindCol(kinghstmt,3,SQL_C_CHAR,sSex,SSEX_LEN,&cbSex);
ret = SQLBindCol(kinghstmt,4,SQL_C_CHAR,&sAge,0,&cbAge);
ret = SQLBindCol(kinghstmt,5,SQL_C_CHAR,sDepart,DEPART_LEN,&cbDepart);
结果集处理
应用程序可以通过SQLNumResultCols来获取结果集中的列数
通过SQL DescribeCol或是SQLColAttrbute函数来获取结果集每一列的名称,数据类型,精度和范围
ODBC中使用游标来处理结果集数据
ODBC中游标类型
- Forward-only游标,是ODBC的默认游标类型
- 可滚动游标
- 静态
- 动态
- 码集驱动
- 混合型
结果集处理步骤
- ODBC游标的打开方式不同于嵌入式SQL,不是显式声明而是系统自动产生一个游标,当结果集刚刚生成时,游标指向第一行数据之前
- 应用程序通过SQLBindCol把查询结果绑定到应用程序缓冲区中,通过SQLFetch或是SQLFetchScroll来移动游标获取结果集中的每一行数据
- 对于如图像这类特别的数据类型,当一个缓冲区不足以容纳所有的数据时,可以通过SQLGetdata分多次获取
- 最后通过SQLClosecursor来关闭游标
// 结果集处理
while((ret = SQLFetch(kinghstmt)) != SQL_NO_DATA_FOUND){
if(ret == SQL_ERROR)
printf("FETCH error\n");
else
ret = SQLExecute(serverhstmt);
}
中止处理
应用程序中止步骤
- 释放语句句柄
- 释放数据库连接
- 与数据库服务器断开
- 释放ODBC环境
// 中止处理
SQLFreeHandle(SQL_HANDLE_STMT,kinghstmt);
SQLDisconnect(kinghdbc);
SQLFreeHandle(SQL_HANDLE_DBC,kinghdbc);
SQLFreeHandle(SQL_HANDLE_ENV,kinghenv);
SQLFreeHandle(SQL_HANDLE_STMT,serverhstmt);
SQLDisconnect(serverhdbc);
SQLFreeHandle(SQL_HANDLE_DBC,serverhdbc);
SQLFreeHandle(SQL_HANDLE_ENV,serverhenv);
return 0;
整体ODBC的编码为:
//创建数据源的详细过程
#include <stdlib.h>
#include <stdio.h>
#include <windows.h>
#include <sql.h>
#include <sqlext.h>
#include <Sqltypes.h>
#define SNO_LEN 30
#define NAME_LEN 50
#define DEPART_LEN 100
#define SSEX_LEN 5
//定义句柄和变量
int main(){
//Step 1 定义句柄和变量
//以king开头的表示的是连接KingbaseES的变量
//以server开头的表示的是连接SQLServer的变量
SQLHENV kinghenv,serverhenv;
//环境句柄
SQLHDBC kinghdbc,serverhdbc;
//连接句柄
SQLHSTMT kinghstmt,serverhstmt;
// 语句句柄
SQLRETURN ret;
SQLCHAR sName[NAME_LEN],sDepart[DEPART_LEN],sSex[SSEX_LEN],sSno[SNO_LEN];
SQLINTEGER sAge;
SQLINTEGER
cbAge = 0,cbSno = SQL_NTS,cbSex = SQL_NTS,cbName = SQL_NTS,cbDepart = SQL_NTS;
// 初始化环境
ret = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&kinghenv);
ret = SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&serverhenv);
ret = SQLSetEnvAttr(kinghenv,SQL_ATTR_ODBC_VERSION,(void*)SQL_OV_ODBC3,0);
ret = SQLSetEnvAttr(serverhenv,SQL_ATTR_ODBC_VERSION,(void*)SQL_OV_ODBC3,0);
// 建立连接
ret = SQLAllocHandle(SQL_HANDLE_DBC,kinghenv,&kinghdbc);
ret = SQLAllocHandle(SQL_HANDLE_DBC,serverhenv,&serverhdbc);
ret = SQLConnect(kinghdbc,"KingbaseES ODBC",SQL_NTS,"SYSTEM",SQL_NTS,"MANAGER",SQL_NTS);
// KingbaseES ODBC为数据源名,SYSTEM为用户名,MANAGER为用户密码
if(!SQL_SUCCEEDED(ret))
// 连接失败时返回错误值
return -1;
ret = SQLConnect(serverhdbc,"SQLServer",SQL_NTS,"sa",SQL_NTS,"sa",SQL_NTS);
if(!SQL_SUCCEEDED(ret))
return -1;
// 初始化语句句柄
ret = SQLAllocHandle(SQL_HANDLE_STMT,kinghdbc,&kinghstmt);
ret = SQLSetStmtAttr(kinghstmt,SQL_ATTR_ROW_BIND_TYPE,(SQLPOINTER)SQL_BIND_BY_COLUMN,SQL_IS_INTEGER);
ret = SQLAllocHandle(SQL_HANDLE_STMT,serverhdbc,&serverhstmt);
// 两种方式执行语句
// 预编译带有参数的语句
ret = SQLPrepare(serverhstmt,"INSERT INTO STUDENT(SNO,SNAME,SSEX,SAGE,SDEPT)VALUES(?,?,?,?,?)",SQL_NTS);
if(ret == SQL_SUCCEEDED || ret == SQL_SUCCEEDED_WITH_INFO){
ret = SQLBindParameter(serverhstmt,1,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,SNO_LEN,0,sSno,0,&cbSno);
ret = SQLBindParameter(serverhstmt,2,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,NAME_LEN,0,sSno,0,&cbSno);
ret = SQLBindParameter(serverhstmt,2,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,2,0,sSex,0,&cbSex);
ret = SQLBindParameter(serverhstmt,4,SQL_PARAM_INPUT,SQL_LONG,SQL_INTEGER,0,0,&sAge,0,&cbAge);
ret = SQLBindParameter(serverhstmt,5,SQL_PARAM_INPUT,SQL_C_CHAR,SQL_CHAR,DEPART_LEN,0,sDepart,0,&cbDepart);
}
// 执行SQL语句
ret = SQLExecDirect(kinghstmt,"SELECT * FROM STUDENT",SQL_NTS);
if(ret == SQL_SUCCESS || ret == SQL_SUCCESS_WITH_INFO){
ret = SQLBindCol(kinghstmt,1,SQL_C_CHAR,sSno,SNO_LEN,&cbSno);
ret = SQLBindCol(kinghstmt,2,SQL_C_CHAR,sName,NAME_LEN,&cbName);
ret = SQLBindCol(kinghstmt,3,SQL_C_CHAR,sSex,SSEX_LEN,&cbSex);
ret = SQLBindCol(kinghstmt,4,SQL_C_CHAR,&sAge,0,&cbAge);
ret = SQLBindCol(kinghstmt,5,SQL_C_CHAR,sDepart,DEPART_LEN,&cbDepart);
}
// 结果集处理
while((ret = SQLFetch(kinghstmt)) != SQL_NO_DATA_FOUND){
if(ret == SQL_ERROR)
printf("FETCH error\n");
else
ret = SQLExecute(serverhstmt);
}
// 中止处理
SQLFreeHandle(SQL_HANDLE_STMT,kinghstmt);
SQLDisconnect(kinghdbc);
SQLFreeHandle(SQL_HANDLE_DBC,kinghdbc);
SQLFreeHandle(SQL_HANDLE_ENV,kinghenv);
SQLFreeHandle(SQL_HANDLE_STMT,serverhstmt);
SQLDisconnect(serverhdbc);
SQLFreeHandle(SQL_HANDLE_DBC,serverhdbc);
SQLFreeHandle(SQL_HANDLE_ENV,serverhenv);
return 0;
}