本節には、SPIを使用する非常に簡単な例があります。
execq
プロシージャは1つ目の引数としてSQLコマンドを、2つ目の引数として行数を取り、SPI_exec
コマンドを実行し、そのコマンドで処理された行数を返します。
SPIのより複雑な例はソースツリー内のsrc/test/regress/regress.cとcontrib/spiにあります。
#include "executor/spi.h" int execq(text *sql, int cnt); int execq(text *sql, int cnt) { char *command; int ret; int proc; /* 与えられたテキストオブジェクトをC文字列に変換 */ command = DatumGetCString(DirectFunctionCall1(textout, PointerGetDatum(sql))); SPI_connect(); ret = SPI_exec(command, cnt); proc = SPI_processed; /* * これがSELECTなど数行を取り出すものであれば、 * 行をelog(INFO)を使用して表示 */ if (ret == SPI_OK_SELECT && SPI_processed > 0) { 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インタフェースを使用すべきです。)
以下は、コンパイルし共有ライブラリを作成した後で、関数を宣言する方法です。
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()で可視な行