SQL调用层接口标准入门（二）SQL调用层接口例程

（一）SQL调用层接口标准概述

（二）SQL调用层接口例程

SQL调用层接口标准规定以某种编程语言编写的程序与SQL实现间的一种绑定方式。功能效果等同于动态SQL。SQL调用层接口标准为63个例程提供规范，按字母次序罗列如下：

1 AllocConnect
缩写为AC。分配SQL连接并赋值一个句柄。

2 AllocEnv
缩写为AE。分配SQL环境并赋值一个句柄。

3 AllocHandle
缩写为AH。分配资源并赋值一个句柄。

4 AllocStmt
缩写为AS。分配SQL语句并赋值一个句柄。

5 BindCol
缩写为BC。描述目标规范或目标规范的数组。

6 BindParameter
缩写为BP。描述动态参数规范及其值。

7 Cancel
缩写为CAN。尝试取消CLI例程执行。

8 CloseCursor
缩写为CC。关闭游标。

9 ColAttribute
缩写为CO。取得列属性。

10 ColumnPrivileges
缩写为CP。返回结果集，包含对列持有的权限列表，其名称遵守所要求的模式，或遵守存储在连接数据源的信息模式中单个指定表内的模式。

11 Columns
缩写为COL。根据指定选择准则，返回结果集，包含关于存储在连接数据源的信息模式中表列的信息。

12 Connect
缩写为CON。建立连接。

13 CopyDesc
缩写为CD。复制CLI描述符。

14 DataSources
缩写为DS。取得SQL调用层接口应用程序可连接的服务器名，以及描述信息，如果有的话。

15 DescribeCol
缩写为DC。取得列属性。

16 Disconnect
缩写为DIS。终止建立的连接。

17 EndTran
缩写为ET。终止SQL事务。

18 Error
缩写为ER。返回诊断信息。

19 ExecDirect
缩写为ED。直接执行语句。

20 Execute
缩写为EX。执行准备的语句。

21 Fetch
缩写为FT。访存CLI游标的下一行集。

22 FetchScroll
缩写为FTS。在指定行集定位CLI游标，并从该行集检索值。

23 ForeignKeys
缩写为FK。返回结果集，包含关于存储在连接数据源的信息模式中单个指定表中的外键或引用该表的外键的信息。结果集包含下列信息之一：

• 单个指定表的主键，以及引用该主键的所有其他表中的外键。
• 单个指定表的外键，及其引用的主键或唯一键。

24 FreeConnect
缩写为FC。释放SQL连接。

25 FreeEnv
缩写为FE。释放SQL环境。

26 FreeHandle
缩写为FH。释放资源。

27 FreeStmt
缩写为FS。释放SQL语句。

28 GetConnectAttr
缩写为GCA。取得SQL连接属性值。

29 GetCursorName
缩写为GCN。取得与分配的SQL语句相关联的游标名称属性。

30 GetData
缩写为GDA。检索列值。

31 GetDescField
缩写为GDF。从CLI描述符区取得字段。

32 GetDescRec
缩写为GDR。从CLI描述符区取得常用字段。

33 GetDiagField
缩写为GDF。从CLI诊断区取得信息。

34 GetDiagRec
缩写为GDR。从CLI诊断区取得常用信息。

35 GetEnvAttr
缩写为GEA。取得SQL环境属性值。

36 GetFeatureInfo
缩写为GFI。取得关于由CLI实现支持特性的信息。

37 GetFunctions
缩写为GFU。确定是否支持CLI例程。

38 GetInfo
缩写为GI。取得关于实现的信息。

39 GetLength
缩写为GLN。检索大对象定位器表示的串值长度。

40 GetParamData
缩写为GPD。检索动态输出参数值。

41 GetPosition
缩写为GPO。检索串值在另一串值内的起始位置，由大对象定位器表示第二个串值。

42 GetSessionInfo
缩写为GSI。取得关于实现支持<general value specification>的信息。

43 GetStmtAttr
缩写为GSA。取得SQL语句属性值。

44 GetSubString
缩写为GSB。或者检索由大对象定位器表示的串值的一部分，或者在服务器创建大对象值并检索该值的大对象定位器。

45 GetTypeInfo
缩写为GTI。取得关于实现支持的一个或全部预定义数据类型的信息。

46 MoreResults
缩写为MR。确定语句句柄上是否能有多个结果集，如果有，则初始化处理那些结果集。

47 NextResult
缩写为NR。确定语句句柄上是否能有多个结果集，如果有，则在分开的语句句柄上初始化处理下一结果集。

48 NumResultCols
缩写为NRC。取得结果列数。

49 ParamData
缩写为PRD。处理延迟的参数值。

50 Prepare
缩写为PR。准备语句。

51 PrimaryKeys
缩写为PK。返回结果集，包含由单个指定表的主键组成的列名称列表，该表存储在连接数据源的信息模式中。

52 PutData
缩写为PTD。提供延迟的参数值。

53 RowCount
缩写为RC。取得行计数。

54 SetConnectAttr
缩写为SCA。设置SQL连接属性值。

55 SetCursorName
缩写为SCN。设置与分配的SQL语句相关联的游标名称属性。

56 SetDescField
缩写为SDF。设置CLI描述符区中的字段。

57 SetDescRec
缩写为SDR。设置CLI描述符区中的常用字段。

58 SetEnvAttr
缩写为SEA。设置SQL环境属性值。

58 SetStmtAttr
缩写为SSA。设置SQL语句属性值。

60 SpecialColumns
缩写为SC。返回结果集，包含列的列表，其值的组合可以唯一标识单个指定表内的任一行，由连接数据源的信息模式描述该表。

61 StartTran
缩写为STN。明确地开启SQL事务，并设置其特征。

62 TablePrivileges
缩写为TP。返回结果集，包含表上持有的权限列表，这些表的名称遵守由连接数据源的信息模式描述的表内所需的模式。

63 Tables
缩写为TAB。根据指定选择准则，返回结果集，包含关于由连接数据源的信息模式描述的表信息。