例子

PostgreSQL 9.4.4 中文手册
上一页 | 上一级 | 章 44. 服务器编程接口 | 下一页

# 44.5. 例子

这是一个非常简单的 SPI 使用的例子。过程`execq` 在其第一个参数里接收一个 SQL 命令，第二个参数接收一个行计数， 用`SPI_exec`执行这个查询并且返回查询执行过的记录个数。 你可以在`src/test/regress/regress.c`中的源码树和 spi模块里找更复杂的例子。

    #include "postgres.h"

    #include "executor/spi.h"
    #include "utils/builtins.h"

    #ifdef PG_MODULE_MAGIC
    PG_MODULE_MAGIC;
    #endif

    int execq(text *sql, int cnt);

    int
    execq(text *sql, int cnt)
    {
        char *command;
        int ret;
        int proc;

        /*  把给出的 text 对象转换成 C 字符串*/
        command = text_to_cstring(sql);

        SPI_connect();

        ret = SPI_exec(command, cnt);

        proc = SPI_processed;
        /*

     * 如果取出了一些行，通过 elog(INFO) 打印它们
         */
        if (ret > 0 && SPI_tuptable != NULL)
        {
            TupleDesc tupdesc = SPI_tuptable->tupdesc;
            SPITupleTable *tuptable = SPI_tuptable;
            char buf[8192];
            int i, j;

            for (j = 0; j < proc; j++)
            {
                HeapTuple tuple = tuptable->vals[j];

                for (i = 1, buf[0] = 0; i <= tupdesc->natts; i++)
                    snprintf(buf + strlen (buf), sizeof(buf) - strlen(buf), " %s%s",
                            SPI_getvalue(tuple, tupdesc, i),
                            (i == tupdesc->natts) ? " " : " |");
                elog(INFO, "EXECQ: %s", buf);
            }
        }

        SPI_finish();
        pfree(command);

        return (proc);
    }

这个函数使用了调用习惯版本0 ，为了是让例子更容易理解。在真实的应用里， 你应该使用新的版本1的接口。

下面是你在把函数编译成共享库之后声明它的方法（详情请看 第 35.9.6 节）：

    CREATE FUNCTION execq(text, integer) RETURNS integer
        AS 'filename'
        LANGUAGE C;

下面是一个会话例子：

    => SELECT execq('CREATE TABLE a (x integer)', 0);
     execq
    -------
         0
    (1 row)

    => INSERT INTO a VALUES (execq('INSERT INTO a VALUES (0)', 0));
    INSERT 0 1
    => SELECT execq('SELECT * FROM a', 0);
    INFO:  EXECQ:  0    -- execq插入 0 行
    INFO:  EXECQ:  1    -- execq 返回，被上层 INSERT 插入

     execq
    -------
         2
    (1 row)

    => SELECT execq('INSERT INTO a SELECT x + 2 FROM a', 1);
     execq
    -------
         1
    (1 row)

    => SELECT execq('SELECT * FROM a', 10);
    INFO:  EXECQ:  0
    INFO:  EXECQ:  1
    INFO:  EXECQ:  2    -- 0 + 2,就像声明的那样只插入了一行

     execq
    -------
         3              -- 10 只是最大值，3 是真实的行数
    (1 row)

    => DELETE FROM a;
    DELETE 3
    => INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
    INSERT 0 1
    => SELECT * FROM a;
     x
    ---
     1                  --  在 (0)+1 里面没有行
    (1 row)

    => INSERT INTO a VALUES (execq('SELECT * FROM a', 0) + 1);
    INFO:  EXECQ:  1
    INSERT 0 1
    => SELECT * FROM a;
     x
    ---
     1
     2                  -- 在 a+1 里面有一行
    (2 rows)

    -- 下面示范了改变数据可视性的规则：

    => INSERT INTO a SELECT execq('SELECT * FROM a', 0) * x FROM a;
    INFO:  EXECQ:  1
    INFO:  EXECQ:  2
    INFO:  EXECQ:  1
    INFO:  EXECQ:  2
    INFO:  EXECQ:  2
    INSERT 0 2
    => SELECT * FROM a;
     x
    ---
     1
     2
     2                  -- 2行 * 1 (x 在第一行)
     6                  -- 3 行 (2 + 1 刚刚插入的) * 2 (第二行里的 x)
    (4 rows)               ^^^^^^
                           在不同的调用里 execq() 看到的东西不同

上一页 | 起始页 | 下一页
数据改变的可视性 | 上一级 | 后台工作进程