C语言访问INFORMIX数据库 — ESQL语法知识

一、头文件

引入informix数据库的头文件时，可使用如下的方式：

EXEC SQL INCLUDE sqlca;
EXEC SQL INCLUDE sqlda;
EXEC SQL INCLUDE sqlhdr;
EXEC SQL INCLUDE decimal;
EXEC SQL INCLUDE locator;
EXEC SQL INCLUDE varchar;
EXEC SQL INCLUDE datetime;
EXEC SQL INCLUDE sqlstype;
EXEC SQL INCLUDE sqltypes;
EXEC SQL INCLUDE sqlstype;

二、宏定义

宏在宿主变量使用时，此宏定义可使用如下方式：

EXEC SQL DEFINE SQL_USRNAME_MAX_LEN 64;   /* User name max len */
EXEC SQL DEFINE SQL_PASSWD_MAX_LEN 64;    /* Password max len */
EXEC SQL DEFINE SQL_SVRNAME_MAX_LEN 64;   /* Database name max len */
EXEC SQL DEFINE SQL_CNNAME_MAX_LEN 64;    /* Connect name max len */
EXEC SQL DEFINE SQL_STMT_MAX_LEN 1024;    /* SQL statement max len */

三、结构体定义

当SQL语句中使用了结构体变量时，那么此变量的类型结构体必须通过如下方式定义：

EXEC SQL BEGIN DECLARE SECTION;
typedef struct
{
    int id;
    char name[32];
    char gender;
    int age;
    char brf[256];
}DBStudent_t;
EXEC SQL END DECLARE SECTION;

如：

int db_ifx_update(...)
{
EXEC SQL BEGIN DECLARE SECTION;
    DBStudent_t dbstudent;
EXEC SQL END DECLARE SECTION;

    ...

    EXEC SQL UPDATE SET *=(:dbstudent) WHERE id='10001';
}

四、变量定义
宿主变量的必须通过如下方式进行定义：

EXEC SQL BEGIN DECLARE SECTION;
    char svrname[SQL_SVRNAME_MAX_LEN], /* Server name */
         usrname[SQL_USRNAME_MAX_LEN], /* User name */
         passwd[SQL_PASSWD_MAX_LEN],   /* Passwd */
         cnname[SQL_CNNAME_MAX_LEN];   /* Connect name */
EXEC SQL END DECLARE SECTION;

如：

int db_ifx_open(...)
{
EXEC SQL BEGIN DECLARE SECTION;
    char svrname[SQL_SVRNAME_MAX_LEN], /* Server name */
         usrname[SQL_USRNAME_MAX_LEN], /* User name */
         passwd[SQL_PASSWD_MAX_LEN],   /* Passwd */
         cnname[SQL_CNNAME_MAX_LEN];   /* Connect name */
EXEC SQL END DECLARE SECTION;

    ...

    EXEC SQL CONNECT TO :svrname AS :cnname USER :usrname USING :passwd;
    ...
}

五、错误信息
每执行一次SQL语句后，错误码存放在全局变量sqlca.sqlcode中，可通过rgetmsg()获取错误信息。如：

int db_ifx_commit(...)
{
    EXEC SQL COMMIT WORK;
    if(sqlca.sqlcode < 0)
    {
        rgetmsg(sqlca.sqlcode, errmsg, sizeof(errmsg));
        fprintf(stdout, "%s", errmsg);
        return -1;
    }
    ...
}