| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 38. PL/Tcl - Tcl 수속형 언어 | Fast Forward | Next |
아래와 같은 명령는, PL/Tcl 함수내로부터 데이터베이스 접근을 실시할 때에 사용할 수 있는 명령입니다.
spi_exec ?-count
n
? ?-array
name
?
command
?
loop-body
?
문자열으로서 주어진 SQL 쿼리를 실행합니다.
명령내의 에러는, 에러의 발생이 됩니다.
아주 없으면, 이 spi_exec의 반환값은 명령에 의해 처리(선택, 삽입, 갱신, 삭제)된 행수,
또는, 명령이 유틸리티 쿼리 경우는 제로가 됩니다.
게다가 명령이 SELECT쿼리 경우, 선택된 열의 값은 이하와 같이 Tcl의 변수에 저장됩니다.
-count옵션의 값은, spi_exec에 대해, 그 명령으로 처리하는 최대행수를 지시합니다.
이것에 의해, 쿼리를 커서로서 설정해, FETCH
n
를 실행하는 것으로 같은 것이 생깁니다.
명령이 SELECT쿼리 경우, 그 결과 얻을 수 있던 열의 값은, 렬명에 연관된 이름의 Tcl 변수에 저장됩니다. -array옵션이 부여되었을 경우는, 열의 값은 지정한 이름의 연상 배열에 저장되어 그 배열의 인덱스로서 렬명이 사용됩니다.
명령이 SELECT문, 한편,
loop-body
스크립트가 부여되지 않았던 경우, 결과 중 최초의 행만이 Tcl 변수에 저장됩니다.
그 밖에도 행이 있었다고 해도, 그것들은 무시됩니다.
쿼리가 행을 돌려주지 않았던 경우는, 변수에의 저장은 발생하지 않습니다
(spi_exec의 반환값을 검사하는 것으로, 이것을 검출할 수가 있습니다).
이하에 예를 나타냅니다.
spi_exec "SELECT count(*) AS cnt FROM pg_proc"
이것은, $cnt Tcl 변수를, pg_proc시스템 목록의 행수로 설정합니다.
loop-body 옵션 인자가 부여되었을 경우, 그것은, 쿼리의 결과 내의 행 각각 대해 한 번만 실행되는 작은 Tcl 스크립트입니다 ( loop-body 는 SELECT이외의 쿼리로 부여되었을 경우는 무시됩니다). 처리중의 행의 렬값는, 각 반복전에 Tcl 변수에 저장됩니다. 이하에 예를 나타냅니다.
spi_exec -array C "SELECT * FROM pg_class" {
elog DEBUG "have table $C(relname)"
}
이것은, pg_class의 각 행에 대해서 로그 메세지를 출력합니다. 이 기능은 다른 Tcl의 반복 구문에서도와 같이 동작합니다. 특히 루프 본체내의 continue와 break는 통상 대로 동작합니다.
쿼리의 결과, 열이 NULL였을 경우, 대상이 되는 변수는 대입되지 않고, "삭제(unset)"됩니다.
spi_prepare
query
typelist
후의 실행을 위해서 쿼리 계획의 준비, 보존을 실시합니다. 보존된 계획은 현재의 세션이 종료할 때까지 보관 유지됩니다.
쿼리는 매개변수, 즉, 계획이 실제로 실행될 때에 항상 주어지는 값용의 플레이스홀더를 가질 수가 있습니다. 쿼리 문자열 중에서는, $1 ... $ n 라고 하는 심볼을 사용해 인자를 참조해 주세요. 쿼리가 매개변수를 사용하는 경우, Tcl의 리스트로서 매개변수의 형명을 지정할 필요가 있습니다 (파라미터를 사용하지 않는 경우는 typelist 에는 빈 리스트를 지정해 주세요).
spi_prepare의 반환값은 쿼리 ID입니다.
이 ID는 후의 spi_execp로 사용됩니다.
사용예에 대해서는 spi_execp를 참조해 주세요.
spi_execp ?-count
n
? ?-array
name
? ?-nulls
string
?
queryid
?
value-list
? ?
loop-body
?
spi_prepare에 의해 사전에 준비된 쿼리를 실행합니다.
queryid
는 spi_prepare에 의해 돌려주어진 ID입니다.
그 쿼리가 매개변수를 참조하는 경우,
value-list
를 줄 필요가 있습니다.
이것은, 그 매개변수의 실제의 값을 가지는 Tcl의 리스트입니다.
이 리스트의 길이는, 사전에 spi_prepare로 지정한 인자형의 리스트의 길이와 같지 않으면 안됩니다.
쿼리에 매개변수가 없는 경우는,
value-list
를 생략 해 주세요.
-nulls옵션의 값은, 공백 문자와 'n'라고 하는 문자로부터 되는 문자열으로, spi_execp에 대해,
어느 인자가 NULL값인지를 나타냅니다.
지정되었을 경우, 그 문자열의 길이는
value-list
의 길이와 정확하게 일치하고 있지 않으면 안됩니다.
지정되지 않는 경우는, 모든 매개변수의 값은 비NULL입니다.
쿼리와 그 매개변수를 어디서 지정하는가 하는 점을 제외해, spi_execp는 spi_exec와 같게 동작합니다.
-count, -array,
loop-body
옵션도, 그리고, 결과의 값도 같습니다.
여기서, 준비된 계획을 사용한, PL/Tcl 함수의 예를 나타냅니다.
CREATE FUNCTION t1_count(integer, integer) RETURNS integer AS $$
if {![ info exists GD(plan) ]} {
# 최초의 호출에서는 보존할 계획을 준비합니다.
set GD(plan) [ spi_prepare \
"SELECT count(*) AS cnt FROM t1 WHERE num >= \$1 AND num <= \$2" \
[ list int4 int4 ] ]
}
spi_execp -count 1 $GD(plan) [ list $1 $2 ]
return $cnt
$$ LANGUAGE pltcl;
spi_prepare에게 주는 쿼리 문자열의 안쪽에서는, $
n
표가
확실히 그대로 spi_prepare에게 건네져 Tcl 변수의 대입에 의한 치환이 일어나지 않게 backslash가 필요합니다.
spi_lastoid
직전의 spi_exec 또는 spi_execp에 의한 명령가 단일행의 INSERT문,
한편, 갱신되는 테이블이 OID를 가지는 경우, 그 명령에 의해 삽입된 행의 OID를 돌려줍니다(아예 없으면, 제로를 돌려줍니다).
quote
string
지정된 문자열 내의 모든 단일 인용부호와 backslash 문자를 이중화합니다.
spi_exec나 spi_prepare로 주어진 SQL 쿼리에 삽입될 예정의 문자열을 안전하게 인용하기 위해서 이것을 사용할 수가 있습니다.
예를 들면, 이하와 같은 쿼리 문자열을 생각합니다.
"SELECT '$val' AS ret"
여기서, val Tcl 변수에 doesn't가 실제로 포함되어 있는 것으로 합니다. 이것은 최종적으로 이하의 쿼리 문자열이 되어 버립니다.
SELECT 'doesn't' AS ret
이것으로는, spi_exec 또는 spi_prepare의 실행중에 해석 에러가 발생해 버립니다.
올바르게 가동시키려면, 실행하고 싶은 쿼리는 이하와 같이 하지 않으면 안됩니다.
SELECT 'doesn''t' AS ret
이것은, PL/Tcl에서는 이하에 의해 형성할 수가 있습니다.
"SELECT '[ quote $val ]' AS ret"
spi_execp가 가지는 1개의 이점은, 매개변수는 SQL 쿼리 문자열의 일부로서 해석되는 일이 없기 때문에,
이와 같이 매개변수의 값을 인용할 필요가 없는 것입니다.
elog
level
msg
로그 또는 에러 메세지를 발행합니다. 사용할 수 있는 레벨은, DEBUG, LOG, INFO, NOTICE, WARNING,ERROR, 및 FATAL입니다. ERROR는 에러 상태를 발생합니다. 게다가 위레벨의 Tcl 코드로 예외가 포착되지 않으면, 이 에러는 쿼리하고 호출 처리의 외부에 전파 되어 그 결과, 현재의 트랜잭션 혹은 서브트랜잭션는 중단(abort) 됩니다. 이것은 실질적으로 Tcl의error명령와 동일합니다. FATAL는 트랜잭션를 중단(abort)해, 현재의 세션을 정지시킵니다 (PL/Tcl 함수에 대해 이 에러 레벨을 사용해야 할 이유는 아마 존재합니다만, 완전성을 위해서 준비되어 있습니다). 다른 레벨은, 다른 중요도의 메세지를 생성할 뿐입니다. log_min_messages과 client_min_messages설정 매개변수는, 특정의 중요도의 메세지를 클라이언트에 보고하는지, 서버의 로그에 써내는지, 혹은 그 양쪽 모두인지를 제어합니다. 자세한 것은 Chapter 17을 참조해 주세요.