| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
DECLARE
name
[ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ]
CURSOR [ { WITH | WITHOUT } HOLD ] FOR
query
[ FOR { READ ONLY | UPDATE [ OF
column
[, ...] ] } ]
DECLARE를 사용하면, 거대한 쿼리의 결과로부터 한 번에 소수의 행을 불러내는 커서를 사용할 수 있게 됩니다. 커서는 데이터를 FETCH 를 사용하여 텍스트 또는 바이너리 형식으로 반환합니다.
통상의 커서는,SELECT의 출력과 같은 텍스트 형식에서 데이터를 반환합니다. 데이터가 바이너리 형식으로 저장되기 때문에, 시스템은 텍스트 형식을 출력하도록 변환해야 합니다. 텍스트 형식으로 정보가 돌아오면, 클라이언트 애플리케이션은 그것을 바이너리 형식으로 변환할 필요가 있습니다. 게다가, 텍스트 형식의 데이터는 바이너리 형식의 데이터보다 종종 사이즈가 더 클 수 있습니다. 바이너리 커서는, 쉽게 조작할 수 있는 바이너리 형태로 있는 데이터를 반환합니다. 그럼에도 불구하고, 데이터를 텍스트 형식으로 표시하고자 하는 경우, 텍스트 형식에서 추출한 것을 클라이언트 측에 효과가 있도록(텍스트 형식으로 표시 되도록) 저장합니다.
이의 예로, 쿼리는 정수 열에서 한 개의 값을 반환하는 경우, 디폴트 커서와 함께 1의 문자열을 받습니다. 반면에, 바이너리 커서는, 값의 내부 표식을 포함하는 4-바이트 필드를 얻습니다. (빅-엔디언 바이트 순서로)
바이너리 커서는 주의하여 사용해야만 합니다. psql를 포함한 많은 애플리케이션은, 데이터는 텍스트 형식에서 돌려주어지는 것으로 간주하고 있어 바이너리 형식의 커서를 취급할 수가 없습니다.
Note: 클라이언트 애플리케이션이 FETCH 커멘드를 발행하기 위해 "extended query"프로토콜을 사용할 시, 바인드 프로토콜 메시지는, 데이터가 텍스트 혹은 바이너리 형식으로 추출될 것인지를 지정합니다. 이 선택은, 커서가 정의되는 방식을 오버라이드합니다. 모든 커서를 텍스트 형식 또는 바이너리 형식으로 취급할 수가 있는 확장의 프로토콜에서는, 바이너리 커서라고 하는 개념은 구식인 것입니다.
생성되는 커서의 이름입니다.
데이터를 반환하는 커서의 형식은, 텍스트가 아닌, 바이너리 형식이 됩니다.
커서로부터 추출된 데이터가, 커서가 존재하는 동안에는 배후에 있는 테이블의 갱신의 영향을 받지 않는 것을 나타냅니다. PostgreSQL에 있는 모든 커서는 영향을 받지 않습니다. 이 키워드는 현재 효과가 없으며, SQL 표준과의 호환성을 위해 존재합니다.
SCROLL는, 커서가 통상의 순서 대로가 아닌 방법으로(예를 들면 후방으로부터) 행을 추출 하기 위해 사용될 수 있다는 것을 지정합니다. 쿼리의 실행 계획이 복잡하게 되면,SCROLL의 지정에 의해 쿼리의 실행 시간이 증대할 가능성이 있습니다. NO SCROLL는, 순서 대로가 아닌 방법에서는 커서가 행을 추출할 수 없다는 것을 지정합니다. 디폴트에서는, 몇 개의 경우로 스크롤 가능합니다. 이것은SCROLL의 지정과 같지는 않습니다. 자세한 것은 Notes 을 참조해 주세요.
WITH HOLD는, 커서를 생성한 트랜잭션 후에도 계속적으로 커서가 사용될 것을 지정합니다. WITHOUT HOLD, 커서를 생성한 트랜잭션의 외부에서는 커서가 사용될 수 없음을 지정합니다. WITH HOLD도WITHOUT HOLD도 지정되지 않는 경우,WITHOUT HOLD가 디폴트가 됩니다.
FOR READ ONLY는 커서가 읽기 전용 모드에서 사용됨을 나타냅니다. FOR UPDATE는 커서가 테이블을 업데이트 하는데 사용됨을 나타냅니다. 커서 업데이트는, 현재 PostgreSQL내에서 지원되지 않습니다. FOR UPDATE를 지정하는 PostgreSQL는, 에러메시지를 발생하고, 효용이 없는 FOR READ ONLY를 지정합니다.
커서에 의해 업데이트되는 열입니다. 커서 업데이트가 PostgreSQL내에서 현재 지원되지 않기 때문에, FOR UPDATE절이 에러 메세지를 호출합니다.
키워드 BINARY, INSENSITIVE, 및 SCROLL는 순서에 상관없이 지정할 수 있습니다.
WITH HOLD가 지정되지 않는 경우, 이 커멘드로 생성된 커서는 현재의 트랜잭션 내에서만 사용될 수 있습니다. 그러므로, WITH HOLD가 없는 DECLARE는, 트랜잭션 블록 외부에서 의미가 없습니다: 커서는 문장이 완료할 때까지만 유효합니다. 그 때문에, PostgreSQL는, 이 커멘드가 트랜잭션 블록 외부에서 사용된 경우 에러를 보고합니다. 트랜잭션 블록을 정의하려면 , BEGIN , COMMIT , ROLLBACK 를 사용해 주세요.
WITH HOLD이 지정되는 경우 및 커서를 생성한 트랜잭션이 성공적으로 커밋하는 경우, 동일 세션 내의 다음 트랜잭션에서도 커서에 액세스 할 수 있습니다. (그러나 트랜잭션 생성이 중단되었을 경우, 커서는 삭제됩니다.) WITH HOLD로 생성된 커서는, 명시적인 CLOSE커멘드가 발행될 경우나 세션이 종료되었을 때에 닫혀집니다. 현재의 실행에서, 유지된 커서를 사용해 나타낸 행은 다음의 트랜잭션에서도 이용될 수 있도록 임시파일 또는 메모리 영역에 복사됩니다.
SCROLL옵션은, 역방향으로 데이터를 불러오기 위해 사용되는 커서를 정의할 시에 지정되어야 합니다. 이것은 SQL 표준에 의해 요구됩니다. 그러나, 이전 버전과의 호환성을 위해, PostgreSQL에서는, 커서의 쿼리의 계획이 단순하고, 지원하는 데에 불필요한 오버헤드가 필요없는 경우, PostgreSQL는 SCROLL을 지정하지 않고 역방향으로 데이터를 불러낼 수 있습니다. 그러나, 애플리케이션 개발자는 SCROLL로 생성되지 않은 커서에서, 역방향으로 데이터를 불러내지 않도록 권고받습니다. NO SCROLL이 지정된 경우에는, 어떠한 경우에서도 데이터를 역방향으로 불러낼 수 없습니다.
표준 SQL에서는, 내장된 SQL에 있는 커서만을 규정하고 있습니다. PostgreSQL서버는 커서용의OPEN문을 실행하고 있습니다. 커서는 선언되었을 때에 열린 것으로 간주되고 있습니다. 그러나,PostgreSQL용의 내장된 SQL 프리프로세서인ECPG에서는,DECLARE와OPEN문등을 포함해 표준 SQL의 커서 규정을 지원하고 있습니다.
pg_cursors 시스템뷰를 문의하는 것으로, 이용 가능한 모든 커서를 확인할 수가 있습니다.
커서를 선언하려면, 아래와 같이 하세요.
DECLARE liahona CURSOR FOR SELECT * FROM films;
커서 사용의 보다 많은 예에 대해서는 FETCH 을 참조해 주세요.