| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 9. 함수와 연산자 | Fast Forward | Next |
본절에서는PostgreSQL의시퀀스 객체에 대해 연산을 실시하는 함수에 대해 설명합니다. 시퀀스 객체(시퀀스 제네레이터라고도 단지 시퀀스라고도 불립니다)란CREATE SEQUENCE로 작성되는 1행의 특별한 테이블입니다. 시퀀스 객체는 통상 테이블의 행에 일의의 식별자를 생성하기 위해서 사용됩니다. Table 9-34에 열거되고 있는 시퀀스 함수는, 시퀀스 객체에서부터 연속한 시퀀스값을 취득하기 위한 , 안전한 멀티유저 메소드를 제공하는 함수입니다.
Table 9-34. 시퀀스 함수
| 함수 | 반환값 | 설명 |
|---|---|---|
currval(regclass)
|
bigint | 지정된 시퀀스에 대해nextval로 얻을 수 있던 최신의 값을 반환한다 |
nextval(regclass)
|
bigint | 시퀀스를 진행시켜 새로운 값을 반환한다 |
setval(regclass, bigint)
|
bigint | 시퀀스의 현재값을 설정한다 |
setval(regclass, bigint, boolean)
|
bigint | 시퀀스의 현재값과is_called플래그를 설정한다 |
시퀀스 함수 호출에 의해 조작되는 시퀀스는regclass인수로 지정되고 그리고 그것은pg_class시스템 카탈로그내의 시퀀스의 OID에 지나지 않습니다. 수작업으로 OID를 검색 해서는 안됩니다,그러나,regclass데이터형의 입력 변환기가 대신 그 작업을 실시합니다. 단일 인용부호로 둘러싸인 시퀀스명을 기술합니다, 따라서 그것은 리터럴 정수와 같이 보입니다. 통상의SQL의 명칭에서의 조작과 호환성을 유지하기 위해서, 문자열이 시퀀스명이 이중 인용부호로 둘러싸여 있지 않는 한, 문자열을 소문자로 변환됩니다. 따라서, 이하와 같이 됩니다.
nextval('foo') operates on sequence foo
nextval('FOO') operates on sequence foo
nextval('"Foo"') operates on sequence Foo
필요하면, 이하와 같이 시퀀스명을 스키마로 수식할 수 있습니다.
nextval('myschema.foo') operates on myschema.foo
nextval('"myschema". foo') same as above
nextval('foo') searches search path for foo
regclass에 관한 보다 상세한 정보는Section 8.12을 참조해 주세요.
Note: PostgreSQL 8.1 이전에 있어서는, 시퀀스 함수의 인수는regclass형은 아닌,text형이었습니다. 그리고 상기의 텍스트 문자열으로부터 OID값으로의 변환은 각각의 호출 실행시에 일어났습니다. 후방 호환성을 위해, 이 구조는 아직 존재합니다만, 내부적으로는 함수가 실행되기 전에text로부터regclass에의 암묵적 강제형 변환으로서 현재 처리되고 있습니다.
리터럴 문자열으로서 시퀀스 함수의 인수를 기술할 때는,regclass데이터형의 정수가 됩니다. 이것은 단지 OID이기 때문에, 다음에 이름이 다시 설정되었다든가, schema의 재할당되었음에도 불구하고, 원래의 식별된 시퀀스를 계승합니다. 이"정적 바인딩"의 행동은, 통상 열의 디폴트와 뷰 참조하는 시퀀스에 있어 매력이 있습니다. 그러나, 때때로 실행시에 시퀀스 참조가 해결되는 "동적 바인딩"이 바람직합니다. 동적 바인딩의 행동을 얻으려면 , 정수를regclass가 아니라, text상수로서 그 상수를 저장시킵니다.
nextval('foo'::text) foo is looked up at runtime동적 바인딩은 PostgreSQL의 릴리스 8.1 이전에 지원된 행동이었으므로, 구래의 애플리케이션의 시멘틱스를 유지하고 싶은 경우 이와 같이 할 필요가 있을 경우도 있습니다.
물론, 시퀀스 함수의 인수는 상수와 함께, 식이 될 수도 있습니다. 텍스트식의 경우, 암묵적 강제형 변환으로 런타임 검색이 실행됩니다.
사용할 수 있는 시퀀스 함수로는 이하의 것이 있습니다.
nextval
시퀀스 오브젝트를 진행하여, 그 다음의 값에 그 값을 반환합니다.
이것은 자동적으로 처리됩니다. 복수의 세션이 동시에nextval를 실행했다고 해도, 각각의 세션은 개별의 시퀀스값을 반드시 받습니다.
currval
현재의 세션에서, 이 시퀀스의 nextval에 의해 취득된 가장 최근값을 반환합니다(세션내에서 그 시퀀스에 대해nextval가 호출되지 않은 경우에는, 에러가 보고됩니다).
이것은 로컬의 세션값을 반환하는 것으로부터, 현재의 세션이 실행하고 나서 다른 세션이nextval를 실행하거나 하지 않아도, 예측할 수 있는 답을 가져온다는 것에 주의해 주세요.
lastval
현재의 세션의nextval로 반환되는 최신의 값을 반환합니다.
이 함수는,nextval가 현재의 세션 내에서 사용된 마지막 시퀀스의 값을 페치 하는 인수로서의 시퀀스명을 취하는 것을 제외하고는,currval와 동등합니다.
현재의 세션내에서 nextval가 아직 호출되지 않은 경우, 에러가 됩니다.
setval
시퀀스 오브젝트의 계수값을 재설정 합니다.
2개의 파라미터를 소유하는 형식에서는, 시퀀스의last_value필드가 지정된 값으로 설정해,is_called필드를true로 설정합니다.
이 의미는, 다음의nextval가 값을 반환하기 전에 시퀀스를 진행시킨다는 것입니다.
3개의 파라미터 형식의 경우,is_called를true 혹은false로 설정할 수 있습니다.
false로 설정되었을 경우, 다음의nextval가 지정된 정확한 값을 반환하여, 시퀀스의 진행은 계속되는nextval로 시작됩니다.
예를 들면,
SELECT setval('foo', 42); Next nextval will return 43
SELECT setval('foo', 42, true); Same as above
SELECT setval('foo', 42, false); Next nextval will return 42
setval에 의해 반환되는 결과는 제 2번째의 인수의 값입니다.
디폴트의 파라미터에 의해 시퀀스 오브젝트가 작성되고 있다면,nextval의 호출로 1으로부터 시작되는 연속적인 값을 반환합니다.
그 외의 행동은
CREATE SEQUENCE
커멘드의 특별한 파라미터를 사용하여 취득할 수 있습니다.
보다 자세한 정보는 커멘드의 레퍼런스 페이지를 참조해 주십시오.
Important: 동일한 시퀀스로부터 수치를 취득하는 동시에 실행되는 트랜잭션끼리의 블록을 방지하기 위해,
nextval연산은 결코 롤백(rollback) 되지 않습니다. 이렇게 말하는 것은, 비록nextval를 실행한 트랜잭션이 후에 중단했다고 해도, 값이 인출되면, 그것은 사용된 것으로 간주합니다. 즉, 중단된 트랜잭션은, 할당된 값의 시퀀스 내에서 사용되지 않은"결손"을 남길 가능성이 있습니다.setval연산은 결코 롤백하지 않습니다.