本節には、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 int64 execq(text *sql, int cnt); int64 execq(text *sql, int cnt) { char *command; int ret; uint64 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]; uint64 j; for (j = 0; j < proc; j++) { HeapTuple tuple = tuptable->vals[j]; int i; 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インタフェースを使用すべきです。)
以下は、コンパイルし共有ライブラリ(36.9.6. 動的にロードされる関数のコンパイルとリンクを参照)を作成した後で、関数を宣言する方法です。
CREATE FUNCTION execq(text, integer) RETURNS int8
AS 'filename
'
LANGUAGE C STRICT;
以下はセッションの例です。
=> 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()で可視な行