# 44.5\. 例子 這是一個非常簡單的 SPI 使用的例子。過程`execq` 在其第一個參數里接收一個 SQL 命令，第二個參數接收一個行計數， 用`SPI_exec`執行這個查詢并且返回查詢執行過的記錄個數。 你可以在`src/test/regress/regress.c`中的源碼樹和 [spi](#calibre_link-399)模塊里找更復雜的例子。 ``` #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的接口。 下面是你在把函數編譯成共享庫之后聲明它的方法（詳情請看 [Section 35.9.6](#calibre_link-926)）： ``` 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() 看到的東西不同 ```