18.3. 呼叫PostgreSQL function或procedure

• URL：cf

• POST資料：{"n":"function or procedure name","fp":"function or procedure","p":[[參數mode,參數型態#,參數值]]}

  Table 18-1. function或procedure

  fp	function or procedure
  function	f
  procedure	p

  Table 18-2. 參數mode

  p	參數mode	備註
  IN	i	務必提供這種mode的參數值，不可遺漏
  INOUT	b	務必提供這種mode的參數值，不可遺漏
  OUT	o	務必提供procedure這種mode的參數值NULL，不可遺漏

  Table 18-3. 參數型態#

  參數型態	參數型態#
  公司#	491
  使用人帳號	38
  語言編號	87
  文字	79
  數字	457
  布林	467

• 回傳：(PostgreSQL function回傳的值)

例一：

• 請求：

  curl -v -H "Content-Type:Application/json" -H 'Authorization:abHEi47obYMiCi193xjEiWIFpOouNmkd' -H 'X-Auth-Database:dev5' -d '{"n":"close_accounts","fp":"f","p":[["i",491,"1"],["i",457,2019],["i",457,12],["i",79,"tw"]]}' https://34.terarows.com/fastcgi/api/cf

  可以把這道請求想像成要在dev5資料庫上面執行這道SQL指令： SELECT * FROM close_accounts('1',2019,12,'tw')

• 回傳：

  "@362 \"8\", @364 \"9\""

例二：呼叫PostgreSQL function

• 假設dev5資料庫有這個table和procedure：

  CREATE TABLE t( c1 INTEGER ); CREATE FUNCTION my_func(OUT a INTEGER,b INTEGER) AS $$ INSERT INTO t VALUES (b) RETURNING b+1 $$ LANGUAGE SQL;

  請求：

  curl -v -H "Content-Type:Application/json" -H 'Authorization:abHEi47obYMiCi193xjEiWIFpOouNmkd' -H 'X-Auth-Database:dev5' -d '{"n":"my_func","fp":"f","p":[["i",457,5]]}' https://34.terarows.com/fastcgi/api/cf

  可以把這道請求想像成要在dev5資料庫上面執行這道SQL指令： SELECT * FROM my_proc(5)

• 回傳：

  "@362 \"8\", @364 \"6\""

例三：呼叫PostgreSQL procedure

• 假設dev5資料庫有這個table和procedure：

  CREATE TABLE t( c1 INTEGER ); CREATE PROCEDURE my_proc(OUT a INTEGER,b INTEGER) AS $$ INSERT INTO t VALUES (b) RETURNING b+1 $$ LANGUAGE SQL;

  請求：

  curl -v -H "Content-Type:Application/json" -H 'Authorization:abHEi47obYMiCi193xjEiWIFpOouNmkd' -H 'X-Auth-Database:dev5' -d '{"n":"my_proc","fp":"p","p":[["o",NULL,NULL],["i",457,5]]}' https://34.terarows.com/fastcgi/api/cf

  可以把這道請求想像成要在dev5資料庫上面執行這道SQL指令： CALL my_proc(NULL,5)

• 回傳：

  "@362 \"8\", @364 \"6\""