CREATE AGGREGATE

PostgreSQL 8.3.3문서
Prev	Fast Backward		Fast Forward	Next

설명

CREATE AGGREGATE는 새로운 집계 함수를 정의합니다. 몇몇의 기본적이고 공통으로 사용되는 집계 함수들은 배포물에 포함되어 있습니다; 그것들은 Section 9.15에 문서화되어 있습니다. 이러한 집계 함수가 새로운 타입을 정의하거나, 아직 제공되지 않은 집계 함수를 필요로 하는 경우, 그때 필요한 기능을 제공하기 위해 CREATE AGGREGATE가 사용될 수 있습니다.

스키마 명이 주어지면 (예를 들어, CREATE AGGREGATE myschema.myagg ...) 집계 함수는 지정된 스키마에서 생성될 수 있습니다. 스키마 명이 주어지지 않으면 현재의 스키마에서 생성될 수 있습니다.

집계 함수는 이름과 입력 데이터 타입(들)에 의해 식별됩니다. 같은 스키마안에 있는 두 집계 함수들이 서로 다른 입력 데이터 타입을 연산한다면 같은 이름을 같습니다. 집계 함수의 이름과 입력 데이터 타입(들)은 같은 스키마안에 있는 모든 통상의 함수의 이름과 데이터 타입(들)과 달라야 합니다.

집계함수는 1개나 2개의 통상의 함수로부터 만들어집니다: 상태변이 함수 sfunc, 그리고 옵션의 최종 계산 함수 ffunc. 이것들은 이하와 같이 사용됩니다.


sfunc
(내부 상태, 다음 데이터 값들) ---> 다음의 내부 상태

ffunc
( 내부 상태) ---> 집계 값

PostgreSQL는 집계의 현재 내부 상태를 유지 하기 위해 데이터 타입인 stype의 임시 변수를 생성합니다. 각각의 입력 행에서, 집약 인수 값(들)이 계산되고 상태변이 함수는 현재 상태 값과 새로운 내부 상태 값을 계산하기 위한 새로운 인자 값(들)과 함께 호출됩니다. 모든 행들이 처리된 후에, 최종 함수는 집계의 반환값을 계산하기 위해 한번 호출됩니다. 최종함수가 없으면 종료 상태 값이 그대로 반환됩니다.

집계 함수는 초기 조건을 제공할 수 있습니다, 즉 이것은, 내부 상태 값에 대한 초기 값 입니다. 이것은 text 타입의 값으로서 데이터베이스에 지정되고 저장됩니다, 그러나 상태치 데이터형의 정수로서 유효한 외부 표현이 아니면 안됩니다. 초기 상태 값이 주어지지 않은 경우, 상태 값은 NULL로부터 시작됩니다.

상태변이 함수가 "strict"이라 선언되는 경우, null이 입력 값으로 호출될 수 없습니다. 그러한 변이 함수에서, 집계는 다음과 같이 실행됩니다. null 입력값들을 가지는 행은 무시됩니다. (함수는 호출되지 않고, 이전 상태 값이 유지됩니다.) 초기 상태 값이 null이면, null값이 아닌 입력 값들을 가진 첫번째 행에서, 첫번째 인자 값이 상태 값을 대체합니다, 그리고 null값이 아닌 입력 값들을 가진 다음 행에서 변이 함수는 호출됩니다. 이것은 max과 같은 동작을 실행하기에 편리 합니다. 이 동작은 state_data_type가 처음의 input_data_type.와 같을 때에만 오직 이용가능 합니다. 이들 타입이 다를 때, null이 아닌 초기 조건 또는 엄격하지 않은 변이 함수를 충족시켜야 합니다.

상태변이 함수가 엄격하지 않으면, 각각의 입력행에 대해서 그 함수가 무조건 불려 가므로, null 입력과 null 변이 값을 스스로 처리하지 않으면 안됩니다. 이것은 함수 작성자가 집계함수의 null 값들을 완전히 통제할 수 있음을 허락합니다.

최종 함수가 "엄격(strict)"이라고 선언되고 있으면, 종료 값이 null일 때에는, 최종 함수가 호출되지 않을 것 입니다; 대신에 null 값이 자동적으로 반환될 것입니다. (물론 이것은, 엄격한 함수의 일반저인 동작에 지나지 않습니다.) 어떤 경우라도, 최종 함수는 null 값을 반환하는 선택권을 가지고 있습니다. 예를 들어, avg에 대한 최종 함수는 입력이 0행이라고 알면, null을 반환합니다.

MIN or MAX와 같은 행동을 하는 집계에서는, 때때로 모든 입력 행을 자세히 조사 하는 대신에, 인텍스를 조사함에 의해서 최적화 될 수 있습니다. 이처럼 집계함수가 최적화되는 경우, 정렬 연산자를 명시함에 의해 나타냅니다. 기본적인 요구사항은 집계함수가 정렬 연산자에 의해 생성되는 정렬 순서에서 첫번째 요소를 산출해야 하는 것 입니다. 즉,

SELECT agg(col) FROM tab;

~에 상등 되어야 합니다.

SELECT col FROM tab ORDER BY col USING sortop LIMIT 1;

더욱이 집계가 null 입력을 무시하는 것, 그리고 null 이외의 입력이 전혀 없었던 때에게만, null 결과 값을 전달 합니다. 통상, 데이터 타입의 < 연산자는 MIN에 대한 적절한 정렬 연산자 이고, > 연산자는 MAX에 대한 적절한 정렬 연산자 입니다. 지정한 연산자가 B-tree 인덱스 연산자 클래스의 것"보다 작은"스트래터지인가 "보다 큰"스트래터지의 멤버가 아닌 한, 최적화가 실제로는 효과가 없는 것에 주의해 주세요.

파라미터

name: 생성하는 집계 함수의 이름(선택적으로 한정된 스키마) 입니다.
input_data_type: 집계 함수가 연산하는 입력 데이터 타입 입니다. 인수가 존재하지 않는 집계 함수를 작성하려면 , 입력 데이터 타입의 장소에*라고 기재해 주세요. (그러한 집계의 예는 count(*) 입니다.)
base_type: CREATE AGGREGATE의 구 구문에서는, 입력 데이터 타입이 집계 함수 이름 옆에 기재되는 것보다 basetype 파라미터에 의해 지정 됩니다. 이 구문은 오직 하나의 입력 파라미터를 허용함을 주의 하세요. 인수가 없는 집계 함수를 정의 하기 위해, basetype를 "ANY" (*가 아닙니다)와 지정해 주세요.
sfunc: 각각의 입력 행에 대해 호출 되는 상태변이 함수의 이름 입니다. N인수를 가지는 집계 함수에서는, sfunc가 state_data_type타입의 첫번째 것과 집계의 선언된 입력 데이터 타입과 매칭하는 나머지로 이루어진 N+1의 인수를 가져야 합니다. 이 함수는 현재 상태 값과 현재의 입력 데이터 값을 취하고, 다음 상태 값을 반환합니다.
state_data_type: 집계 상태 값에 대한 데이터 타입입니다.
ffunc: 모든 입력 행에 대한 처리가 끝난 후, 집계의 결과를 계산하기 위해 호출되는 최종 함수의 이름 입니다. 이 함수는 state_data_type 타입의 인수 1개를 가져야 합니다. 집계의 반환 데이터 타입은 이 함수의 반환 타입으로 정의 됩니다. ffunc가 지정되지 않으면, 종료 상태 값은 집계의 결과로 사용됩니다. 반환 타입은 state_data_type가 됩니다.
initial_condition: 상태 값의 초기 설정입니다. 이것은 데이터 타입 state_data_type에 대해 수용된 형식안에 있는 문자열 상수여야 합니다. 이것이 지정되지 않으면, 상태값은 null부터 시작 됩니다.
sort_operator: MIN또는MAX와 같은 집계와 관련된 정렬 연산자 입니다. 이것은 단순한 연산자 이름입니다. (적격의 스키마로 수식 가능) 이 연산자는 집계(하나의 인수만 가지는 집계)와 같은 입력 데이터 타입을 가지는 것을 전제로 합니다.

CREATE AGGREGATE의 파라미터는 단지 위에 설명된 순서 뿐만 아니라, 어떤 순서로도 기재될 수 있습니다.

Prev	Home	Next
COPY	Up	CREATE CAST

CREATE AGGREGATE

Name

Synopsis

설명

파라미터

예

호환성

관련 항목