例

PostgreSQL 9.1.1文書
前のページ | 巻戻し | 第 43章サーバプログラミングインタフェース | 早送り | 次のページ

# 43.5. 例

本節には、SPIを使用する非常に簡単な例があります。 `execq` プロシージャは1つ目の引数としてSQLコマンドを、2つ目の引数として行数を取り、`SPI_exec`コマンドを実行し、そのコマンドで処理された行数を返します。 SPIのより複雑な例はソースツリー内の`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;

        /* 与えられたテキストオブジェクトを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);
    }

（例をよりわかりやすくするためにこの関数は呼び出し規約Version-0を使用しています。 実際のアプリケーションでは、新しいVersion-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によって挿入された
    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という1つの行のみが挿入された

     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                  -- aテーブルに行がない(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行あり + 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 （2行目のx）
    (4 rows)               ^^^^^^
                           別の呼び出しで execq()で可視な行

前のページ | ホーム | 次のページ
データ変更の可視性 | 上に戻る | リファレンス