| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 40. PL/Python - Python 수속 언어 | Fast Forward | Next |
PL/Python 언어 모듈은 자동적으로 plpy라는 Python 모듈을 임포트 합니다.
이 모듈의 함수와 정수는,
plpy.
foo
와 같이 작성한 Python 코드로부터 사용할 수가 있습니다.
현재 plpy에서는,
plpy.debug(
msg
),
plpy.log(
msg
),
plpy.info(
msg
),
plpy.notice(
msg
),
plpy.warning(
msg
),
plpy.error(
msg
),및 plpy.fatal(
msg
) 함수를 구현하고 있습니다.
plpy.error 및 plpy.fatal는,
실제로 Python의 예외를 발생시킵니다.
이것이 포착되지 않는 경우, 호출중의 쿼리 외부에 전해져, 그 결과, 현재의 트랜잭션 혹은 서브트랜잭션이 중단(abort) 합니다.
raise plpy.ERROR("msg") 및 raise plpy.FATAL("msg")는,
각각 plpy.error 및 plpy.fatal의 호출과 같습니다.
다른 레벨은, 다른 중요도의 메세지를 생성할 뿐입니다.
log_min_messages 과 client_min_messages설정 변수는,
특정의 중요도의 메세지를 클라이언트에 보고하는지,
서버의 로그에 써내는지, 혹은 그 양쪽 모두 인지를 제어합니다.
자세한 것은 Chapter 17을 참조해 주세요.
게다가
plpy모듈은
execute 및 prepare라는 2개의 함수를 준비하고 있습니다.
plpy.execute를, 쿼리 문자열 및 생략 가능한 제한 인자를 붙여 호출하면, 쿼리가 실행되어 결과 객체로서 쿼리 결과가 돌아갑니다.
이 결과 객체는 리스트 혹은 이전 객체를 모방 합니다.
결과 객체는, 행 번호나 렬명을 통해 접근 할 수가 있습니다.
결과 객체에는,
쿼리 결과의 행수를 돌려주는 nrows(),
SPI_execute가 돌려주는 값을 돌려주는,
status라는 방법이 추가되고 있습니다.
결과 객체는 변경이 가능합니다.
이하에 예를 나타냅니다.
rv = plpy.execute("SELECT * FROM my_table", 5)
이것은, my_table로부터 5행까지를 돌려줍니다. my_table에 my_column열이 존재하는 경우, 그 열에는 이하와 같이 접근 할 수 있습니다.
foo = rv[i]["my_column"]
2번째의 함수 plpy.prepare는, 쿼리의 실행 계획을 준비합니다.
쿼리내에 매개변수 참조가 있는 경우, 쿼리 문자열 및 인자형의 리스트와 함께 불려 갑니다.
예를 들면, 이하와 같이 합니다.
plan = plpy.prepare("SELECT last_name FROM my_users WHERE first_name = $1", [ "text" ])
text는, $1로서 건네주는 변수의 형태입니다.
명령문을 준비한 후, 그것을 실행하기 위해서 함수plpy.execute를 사용합니다.
rv = plpy.execute(plan, [ "name" ], 5)
3번째의 인자는 제한 인자이며, 생략 가능합니다.
PL/Python 모듈을 사용해 준비한 계획은 자동적으로 보존됩니다. 이것이 무엇을 의미하는지에 대해서는 SPI의 문서(Chapter 41)를 참조해 주세요. 이것을 복수 호출에 대해 효과적으로 사용하기 위해서는, 영속적인 저장용 사전인 SD 또는 GD(Section 40.1를 참조)의 어느쪽이든 사용할 필요가 있습니다. 예를 들면, 이하와 같이 합니다.
CREATE FUNCTION usesavedplan() RETURNS trigger AS $$
if SD.has_key("plan"):
plan = SD["plan"]
else:
plan = plpy.prepare("SELECT 1")
SD["plan"] = plan
# rest of function
$$ LANGUAGE plpythonu;