esql/c (6)

[zjpwm]

第六章 使用说明书

Cobase支持两种方式对数据库中的数据进行访问—交互方式和嵌入C程序（ESQL）的方式。Cobase采用的是Client/Server结构，Client端将对数据库的各种访问请求发送到服务器方，交由服务器方处理。服务器对发送来的请求进行分析和处理，然后将执行结果发送回Client端。交互式（ISQL）和嵌入式C程序都是运行在Client端的进程，通过以网络方式和服务器建立连接来进行通讯。下面简要介绍这两种方式的使用。

一．启动Cobase：
无论使用这两种方式中的哪一种，在和数据库进行交互之前都要首先启动Cobase的DBMS。
;启动Cobas的DBA进程：运行Cobase.exe将启动Cobase的DBA,这时屏幕将出现两个窗口，一个是控制窗口，一个是消息窗口。控制窗口用于完成对系统的控制，包括初始化系统，选择和系统的连接方式，及断开连接，退出系统等。以后的用户操作都在控制窗口中进行，消息窗口只用于显示一些系统信息。
;初始化系统：第一次启动Cobase需对系统初始化。选中主菜单中的File菜单项，在弹出的子菜单中选中Initialize，在弹出的对话框中选中“确定”即可完成对系统的初始化。该步骤只需在第一次进入系统时调用，或当你认为需要清除系统中已存在的所有数据，对整个系统初始化时使用。
;选择和Cobase DBMS的连接方式：在控制窗口的主菜单中选中File，在弹出的子菜单中选择NetWork Share，以网络方式和Cobase建立连接。在弹出的对话框提示DBA启动成功后，进入下一步。

二．退出Cobase:
;Cobase DBA Shutdown:在退出Cobase之前将DBA Shutdown。选中File菜单项，在弹出的子菜单中选择Normal Shutdown，那么DBA将shutdown。如果Client端的进程非正常终止，则选择Immediate Shutdown。如果再需要Cobase DBMS的服务，则须重新启动DBA，以网络方式和Cobase建立连接，然后启动服务器进程shadow.
;退出Cobase:选中File菜单项，在弹出的子菜单中选择Exit。 </P><P>三．交互式SQL（Interactive SQL）访问
交互式SQL提供了一种交互式的方法对数据库中的数据进行访问。在交互式的界面中只能执行交互式的SQL语句—DDL语句,DML语句，COMMIT和ROLLBACK。并且DML语句中不能含有主变量。交互式SQL不支持游标。ISQL将输入的SQL语句发送给服务器方执行，最后负责从服务器方将数据取回来，显示在交互式的界面中。
;启动ISQL:执行SISQL.EXE，启动ISQL。
;登录到Cobase：在弹出的窗口菜单中选择FILE，然后选择Logon子菜单项进行登录。登录的用户名为cobase，口令也为cobase。
;进入SQL命令状态：在产生的窗口中，由三部分组成。第一部分标记为SQL data，用于对查询结果的显示。第二部分标记为Statistics，用于显示对SQL语句执行结果的反馈信息。第三部分标记为SQL Command，用于输入要求执行的SQL语句。首先在SQL Command中输入“SQL”，要求以下进入SQL语句的执行状态。
;执行SQL语句：在SQL Command编辑框中输入要求执行的SQL语句，一次一条，每个语句要求以分号结束。输入完毕后，单击“Execute”语句即被执行，执行结果将在SQL data或Statistics中被显示。
;退出ISQL：在SQL Command中输入“logout”，即可退出ISQL，同时也将关闭服务器方的shadow进程。

四．嵌入式SQL（Enbeded SQL）编程方式
嵌入式SQL在前面的章节中已经介绍了。我们把在C语言中嵌入SQL语句的程序简称为EC程序。开发一个EC程序的基本步骤如下：
1．编辑ESQL程序：可以使用文本编辑器如VC的编辑器编制一个ESQL程序，以.ec作为文件的扩展名。
2．预编译：使用COBASE的预编译器ETE对ESQL源程序进行预处理,该编译器将源程序中嵌入的SQL语句翻译成C++语言形式的对Cobase库函数的调用,生成文件的扩展名为.cpp.
启动ETE.exe，在弹出的对话框中，输入要进行预处理的.ec文件。（该文件本身要以.ec结尾，但在这里输入的文件名无须加上.ec后缀，预编译器会自动查找以.ec结尾的同名文件。）
ETE 的调用格式为:
ETE <filename>
<filename> 为含有嵌入式SQL语句(ESQL)的C/C++语言文本文件名;
3．生成项目：创建一个相应的项目，将预编译生成的.cpp文件加入到该项目中。
4．项目设置：选中VC的Project/setting,在弹出的对话框中选择Link标签。
在Object/Library Modules文本框中加入库文件wetelib.lib,wccilib.lib;
选中Tools/Options,在弹出的对话框中选择Directories/Library files,设置 各库文件的路径。
5.运行：
;启动Cobas：运行Cobase.exe将启动Cobase,这时屏幕将出现两个窗口，一个是控制窗口，一个是消息窗口。控制窗口用于完成对系统的控制，包括初始化系统，选择和系统的连接方式，及断开连接，退出系统等。以后的用户操作都在控制窗口中进行，消息窗口只用于显示一些系统信息。
;初始化系统：第一次启动Cobase需对系统初始化。选中主菜单中的File菜单项，在弹出的子菜单中选中Initialize，即可完成对系统的初始化。该步骤只需在第一次进入系统时调用，或当你认为需要清除系统中已存在的所有数据，对整个系统初始化时使用。
;和Cobase建立连接：在控制窗口的主菜单中选中File，在弹出的子菜单中选择NetWork Share，和Cobase建立连接。
;运行你的应用程序
6.Shutdown:在应用程序终止之后,选择File/NormalShutdown,和DBMS断开连接。如果你应用程序非正常终止，那么选择File/ImmediateShutdown。重新建立连接只要再选中NetWork Share即可，无须退出Cobase。
7．退出系统：成功Shutdown之后，选择File/Exit退出Cobase。