附录1：主要接口

soci提供建立和管理与Vastbase G100 数据库连接、执行SQL 语句和对结果集进行储存管理的若干接口。主要接口说明如下：

• session::open(backend_factory const &factory,std::string const &connectString)

  此方法用于创建新的数据库会话。参数说明如下：

  关键字	参数说明
  factory	后端工厂，PostgreSQL使用soci::postgresql
  connectString	连接参数字符串，举例为”dbname=postgres user=vastbase_remote password=Aa@123456 host=172.16.12.234 port=5432” dbname：数据库名称 user：用户名 password：密码 host：数据库所在主机IP地址 port：连接端口号，默认为5432

  返回值：无。

  调用示例见附录2。

• sql<<statement,use_list;

  此方法执行被参数化的SQL语句（即占位符，而不是SQL文字）。soci支持用冒号编写的占位符。参数说明如下：

  关键字	参数说明
  statement	SQL语句
  use_list	变量列表，用use表达式将SQL占位符（用冒号编写）与本地数据关联起来

  返回值：无。

  调用示例见附录2。

• sql<<statement,into_list;

  此方法执行SQL语句，获取结果值。参数说明如下：

  关键字	参数说明
  statement	SQL语句
  into_list	变量列表，用into表达式将结果与本地数据关联起来

  返回值：无。

  调用示例见附录2。

• transaction::rollback()

  此方法回滚当前挂起事务。

  参数：无。

  返回值：无。

  调用示例见附录2。

• (session)(sql).prepare<<statement

  此方法获取查询结果集。

  参数说明如下：

  关键字	参数说明
  statement	SQL语句

  返回值：rowset类型值。

  调用示例见附录2。

• session::close()

  此方法用于关闭该连接。

  参数：无。

  返回值：无。

  调用示例见附录2。