PostgreSQL 使用主變量

這里有一種在 ECPG 主應(yīng)用中處理timestamp變量的模式。

首先，程序必須包括用于timestamp類型的頭文件：

#include <pgtypes_timestamp.h>

接著，在聲明節(jié)中聲明一個主變量為類型timestamp：

EXEC SQL BEGIN DECLARE SECTION;
timestamp ts;
EXEC SQL END DECLARE SECTION;

并且在讀入一個值到該主變量中之后，使用 pgtypes 庫函數(shù)處理它。在下面的例子中，timestamp值被PGTYPEStimestamp_to_asc()函數(shù)轉(zhuǎn)變成文本（ASCII）形式：

EXEC SQL SELECT now()::timestamp INTO :ts;

printf("ts = %s\n", PGTYPEStimestamp_to_asc(ts));

這個例子將展示像下面形式的一些結(jié)果：

ts = 2010-06-27 18:03:56.949343

另外，DATE 類型可以用相同的方式處理。程序必須包括pgtypes_date.h，聲明一個主變量為日期類型并且將一個 DATE 值使用PGTYPESdate_to_asc()函數(shù)轉(zhuǎn)變成一種文本形式。關(guān)于 pgtypes 庫函數(shù)的更多細節(jié)，請參考第 35.6 節(jié)。

對interval類型的處理也類似于timestamp和date類型。不過，必須顯式為一個interval類型分配內(nèi)存。換句話說，該變量的內(nèi)存空間必須在堆內(nèi)存中分配，而不是在棧內(nèi)存中分配。

這里是一個例子程序：

#include <stdio.h>
#include <stdlib.h>
#include <pgtypes_interval.h>

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    interval *in;
EXEC SQL END DECLARE SECTION;

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    in = PGTYPESinterval_new();
    EXEC SQL SELECT '1 min'::interval INTO :in;
    printf("interval = %s\n", PGTYPESinterval_to_asc(in));
    PGTYPESinterval_free(in);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

numeric和decimal類型的處理類似于interval類型：需要定義一個指針、在堆上分配一些內(nèi)存空間并且使用 pgtypes 庫函數(shù)訪問該變量。關(guān)于 pgtypes 庫函數(shù)的更多細節(jié)，請參考第 35.6 節(jié)。

pgtypes 庫沒有特別為decimal類型提供函數(shù)。一個應(yīng)用必須使用一個 pgtypes 庫函數(shù)把它轉(zhuǎn)變成一個numeric變量以便進一步處理。

這里是一個處理numeric和decimal類型變量的例子程序。

#include <stdio.h>
#include <stdlib.h>
#include <pgtypes_numeric.h>

EXEC SQL WHENEVER SQLERROR STOP;

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    numeric *num;
    numeric *num2;
    decimal *dec;
EXEC SQL END DECLARE SECTION;

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    num = PGTYPESnumeric_new();
    dec = PGTYPESdecimal_new();

    EXEC SQL SELECT 12.345::numeric(4,2), 23.456::decimal(4,2) INTO :num, :dec;

    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 0));
    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 1));
    printf("numeric = %s\n", PGTYPESnumeric_to_asc(num, 2));

    /* 將一個decimal轉(zhuǎn)變成numeric以顯示一個decimal值。 */
    num2 = PGTYPESnumeric_new();
    PGTYPESnumeric_from_decimal(dec, num2);

    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 0));
    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 1));
    printf("decimal = %s\n", PGTYPESnumeric_to_asc(num2, 2));

    PGTYPESnumeric_free(num2);
    PGTYPESdecimal_free(dec);
    PGTYPESnumeric_free(num);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

bytea類型的處理與VARCHAR相似。 類型bytea的數(shù)組上的定義被轉(zhuǎn)換為每個變量的命名結(jié)構(gòu)。聲明類似于：

bytea var[180];

is converted into:

struct bytea_var { int len; char arr[180]; } var;

成員 arr 承載二進制格式數(shù)據(jù)。 不像VARCHAR，它還可以作為數(shù)據(jù)的一部分處理 '\0' 。 數(shù)據(jù)往/來轉(zhuǎn)換為十六進制格式，并通過 ecpglib 發(fā)送/接收。

將數(shù)組用作主變量有兩種情況。第一種如第 35.4.4.1 節(jié)所述，是一種將一些文本字符串存儲在char[]或VARCHAR[]中的方法。第二種是不用一個游標(biāo)從一個查詢結(jié)果中檢索多行。如果沒有一個數(shù)組，要處理由多個行組成的查詢結(jié)果，我們需要使用一個游標(biāo)以及 FETCH命令。但是使用數(shù)組主變量，多個行可以被一次收取。該數(shù)組的長度必須被定義成足以容納所有的行，否則很可能會發(fā)生一次緩沖區(qū)溢出。

下面的例子掃描pg_database系統(tǒng)表并且顯示所有可用數(shù)據(jù)庫的 OID 和名稱：

int
main(void)
{
EXEC SQL BEGIN DECLARE SECTION;
    int dbid[8];
    char dbname[8][16];
    int i;
EXEC SQL END DECLARE SECTION;

    memset(dbname, 0, sizeof(char)* 16 * 8);
    memset(dbid, 0, sizeof(int) * 8);

    EXEC SQL CONNECT TO testdb;
    EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT;

    /* 一次檢索多行到數(shù)組中。 */
    EXEC SQL SELECT oid,datname INTO :dbid, :dbname FROM pg_database;

    for (i = 0; i < 8; i++)
        printf("oid=%d, dbname=%s\n", dbid[i], dbname[i]);

    EXEC SQL COMMIT;
    EXEC SQL DISCONNECT ALL;
    return 0;
}

這個例子顯示下面的結(jié)果（確切的值取決于本地環(huán)境）。

oid=1, dbname=template1
oid=11510, dbname=template0
oid=11511, dbname=postgres
oid=313780, dbname=testdb
oid=0, dbname=
oid=0, dbname=
oid=0, dbname=

一個成員名稱匹配查詢結(jié)果列名的結(jié)構(gòu)可以被用來一次檢索多列。該結(jié)構(gòu)使得我們能夠在一個單一主變量中處理多列值。

下面的例子從pg_database系統(tǒng)表以及使用pg_database_size()函數(shù)檢索可用數(shù)據(jù)庫的 OID、名稱和尺寸。在這個例子中，一個成員名匹配SELECT結(jié)果的每一列的結(jié)構(gòu)變量dbinfo_t被用來檢索結(jié)果行，而不需要把多個主變量放在FETCH語句中。

EXEC SQL BEGIN DECLARE SECTION; typedef struct { int oid; char datname[65]; long long int size; } dbinfo_t; dbinfo_t dbval; EXEC SQL END DECLARE SECTION; memset(&dbval, 0, sizeof(dbinfo_t)); EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid)
                AS size FROM pg_database; EXEC SQL OPEN cur1; /* 在達到結(jié)果集末尾時，跳出 while 循環(huán) */ EXEC SQL WHENEVER NOT FOUND DO BREAK; while (1) { /* 將多列取到一個結(jié)構(gòu)中。 */ EXEC SQL FETCH FROM cur1 INTO :dbval; /* 打印該結(jié)構(gòu)的成員。 */ printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname,
                dbval.size); } EXEC SQL CLOSE cur1;

這個例子會顯示下列結(jié)果（確切的值取決于本地環(huán)境）。

oid=1, datname=template1, size=4324580
oid=11510, datname=template0, size=4243460
oid=11511, datname=postgres, size=4324580
oid=313780, datname=testdb, size=8183012

結(jié)構(gòu)主變量將列盡數(shù)“吸收”成結(jié)構(gòu)的域。額外的列可以被分配給其他主變量。例如，上面的程序也可以使用結(jié)構(gòu)外部的size變量重新構(gòu)造：

EXEC SQL BEGIN DECLARE SECTION;
    typedef struct
    {
       int oid;
       char datname[65];
    } dbinfo_t;

    dbinfo_t dbval;
    long long int size;
EXEC SQL END DECLARE SECTION;

    memset(&dbval, 0, sizeof(dbinfo_t));

    EXEC SQL DECLARE cur1 CURSOR FOR SELECT oid, datname, pg_database_size(oid) AS size FROM pg_database;
    EXEC SQL OPEN cur1;

    /* 在達到結(jié)果集末尾時，跳出 while 循環(huán) */
    EXEC SQL WHENEVER NOT FOUND DO BREAK;

    while (1)
    {
        /* 將多列取到一個結(jié)構(gòu)中。 */
        EXEC SQL FETCH FROM cur1 INTO :dbval, :size;

        /* 打印該結(jié)構(gòu)的成員。 */
        printf("oid=%d, datname=%s, size=%lld\n", dbval.oid, dbval.datname, size);
    }

    EXEC SQL CLOSE cur1;

使用typedef關(guān)鍵詞可以把新類型映射到已經(jīng)存在的類型。

EXEC SQL BEGIN DECLARE SECTION;
    typedef char mychartype[40];
    typedef long serial_t;
EXEC SQL END DECLARE SECTION;

注意你也可以使用：

EXEC SQL TYPE serial_t IS long;

這種聲明不需要位于一個聲明節(jié)之中。

你可以聲明最常見類型的指針。不過注意，你不能使用指針作為不帶自動分配內(nèi)存的查詢的目標(biāo)變量。關(guān)于自動分配內(nèi)存的詳情請參考第 35.7 節(jié)。

EXEC SQL BEGIN DECLARE SECTION;
    int   *intp;
    char **charp;
EXEC SQL END DECLARE SECTION;