새로 만들고자 하는 함수의 이름(스키마 이름 포함).

사용할 수 있는 모드값: IN, OUT, INOUT, 또는 VARIADIC. 생략하면 기본값인 IN으로 간주한다. OUT VARIADIC 형은 한번만 사용할 수 있다. 또한, OUT , INOUT 인자는 RETURNS TABLE 구문과 함께 사용할 수 없다.

해당 인자의 이름. SQL, PL/pgSQL 언어를 포함해서 몇 언어를 사용하는 함수에서는 함수 본문에서 여기서 지정한 이름을 변수명으로 사용할 수 있다. 그외 다른 언어에서는 단순히 함수 문서화 작업에 도움을 줄 뿐이다. 물론 함수를 호출 할 때 명령문의 가독성을 높이기 위해서, 입력 인자 이름과 그 값을 함께 지정해서 쓰기도 한다(4.3절 참조). (이렇게 함수 이름을 사용할 수 없는 언어에서는 그 인자값을 사용하기 위해 별도의 변수 선언, 변수 값 할당 같은 부가 작업을 함수 본문에 추가해서 보통 진행한다. - 옮긴이) 한편, 출력 인자 이름은 그 함수 결과의 칼럼 이름으로 사용하기 때문에, 중요한 의미를 지닌다. (출력 인자 이름을 사용하지 않은 경우에는 출력 결과에 사용하는 각 칼럼 이름은 시스템이 자동으로 부여한다.)

함수 인자의 해당 자료형 이름(스키마 이름 포함). 그 자료형으로 기본 자료형, 복합 자료형, 도메인, 한 테이블의 칼럼이 사용하는 자료형을 뜻하는 참조 자료형을 사용할 수 있다.

사용하는 언어에 따라 어떤 경우는 cstring 같은 “의사-자료형” “pseudo-type”도 사용할 수 있다. 의사 자료형은 그 진짜 인자 자료형이 불완전한 지정이거나, (SQL 수준에서 임의로 어떤 자료형으로 바뀔 수 있는), 보통의 SQL 자료형이 아닌 경우를 뜻한다.

인자 자료형으로 테이블이름.칼럼이름%TYPE 구문으로 특정 테이블의 특정 칼럼이 사용하는 참조 자료형을 쓸 수 있다. 이런 자료형 정의는 테이블 정의 변경과 독립적인 함수를 만드는데 유용하게 쓰인다.

이 표현식으로 지정한 기본값은 함수를 호출 할 때, 해당 인자를 아에 지정하지 않았을 때, 자동으로 사용할 인자값이 된다. 즉, 이 표현식의 계산 결과는 해당 인자 자료형과 같아야 한다. 입력 인자 (INOUT 인자 포함)만 기본값을 사용할 수 있다. 모든 입력 인자는 이 기본값 표현식을 구문을 이용해서 기본값을 지정할 수 있다.

함수 반환값의 자료형 이름(스키마 이름 포함). 이 자료형으로 기본 자료형, 복합 자료형, 도메인, 테이블 칼럼의 참조 자료형을 사용할 수 있다. 사용하는 언어에 따라 cstring 같은 “의사-자료형”도 사용할 수 있다. 반환값이 없는 함수를 만드려면, 이 반환 자료형을 void로 지정한다.

OUT 또는 INOUT 인자를 지정했다면, RETURNS 절은 생략할 수 있다. 둘 다 있다면, 출력 인자의 자료형과 이 반환 자료형이 같아야 한다. 반환 자료형이 RECORD 형이라면, 각 개별 출력 인자의 자료형은 그 출력 결과의 각 칼럼 자료형과 같아야 한다.

SETOF 옵션을 자료형 이름 앞에 지정할 수 있는데, 이 때는 반환 되는 자료형이 단일 자료가 아니라, 그 자료들의 집합임을 지시한다. (다중 로우 반환을 뜻한다.)

이 자료형으로 테이블이름.칼럼이름%TYPE 형태의 테이블 칼럼 참조 자료형도 사용할 수 있다.

RETURNS TABLE 구문에서 사용하는 반환 테이블의 칼럼 이름. RETURNS TABLE 반환은 RETURNS SETOF 옵션을 사용하지 않아도, 집합을 반환한다. 또한 OUT 인자에 이름을 함께 사용하는 출력 자료형 지정보다 편하게 다중 칼럼 출력 자료형을 지정할 수 있다.

RETURNS TABLE 구문에서 사용하는 반환 테이블의 칼럼 자료형.

함수 본문으로 지정하는 코드들을 해석하고 처리하는 내장 언어 이름. sql, c, internal 이렇게 기본 3 종을 제공하면, 일반적으로 SQL 사용자 정의 함수나 프로시져를 만들 때 사용하는 plpgsql 언어를 확장 모듈로 제공한다(이것은 데이터베이스를 만들 때 자동 설치된다.) 언어 이름에 작은 따옴표를 함께 쓰지 않으며, 대소문자를 구분한다.

해당 함수에서 사용할 transform 목록. transform은 SQL 자료형과 프로시져 언어에서 사용하는 고유 자료형 사이 전환을 담당한다. CREATE TRANSFORM 명령 설명서 참조. 일반적으로 프로시져 언어는 내장 자료형에 대한 하드 코딩된 정보를 구현해서 제공한다. 그래서, 그 언어가 다루지 못하는 자료형이 아니면, 이 구문은 필요가 없다. 프로시져 언어가 SQL 자료형을 자신이 쓸 자료형으로 바꾸지 못하면(여기서 지정한 transform을 사용하든, 아니면, 기본 자료형으로 바꾸든, 이런 변환 작업을 못하면) 오류를 발생한다. 이런 형 변환에 대한 부분은 각 언어를 어떻게 구현했는가에 달렸다.

WINDOW 옵션은 이 함수가 윈도우 함수로 사용함을 지정한다. C 언어로 구현한 함수에서 사용된다. WINDOW 속성은 CREATE OR REPLACE 작업으로는 변경될 수 없다.

쿼리 최적화기가 이 함수를 사용하는 쿼리를 최적화 할 때 참조하는 속성값. 세 가지 중 하나를 선택한다. 지정하지 않으면 VOLATILE 함수로 간주한다.

IMMUTABLE 옵션은 한 입력값에 대해서는 항상 같은 반환값을 반환하는 함수임을 알린다. 즉, 이 옵션을 사용하는 함수는 데이터베이스 자료를 찾는 작업을 하지 않는 함수임을 뜻한다. 또는 this function use information not directly present in its argument list. (번역 불가) 이 옵션을 사용하는 함수에 상수값 인자가 사용되면, 그 반환값을 구해서 그것을 기준으로 최적화기를 실행 계획을 짜는데 반영한다.

STABLE 옵션은 데이터베이스 자료 조작 작업은 하지 않는 함수임을 의미한다. 하나의 테이블 탐색에서 이 함수가 호출되면, 동일 입력 인자 값에 대해서는 동일 반환 값을 갖는다. 하지만, 각각 다른 SQL 명령에서는 입력 인자 값이 같더라도 반환 값이 다를 수 있다고 여긴다. 이 옵션은 해당 함수가 자료 조회용 작업이나, 매개 변수 값(예, timezone) 조회를 하는 등, 이런 작업을 하는 함수에 사용한다. (자료 조작 뒤에 실행 되는 AFTER 트리거용 함수에 이 옵션을 지정하면 위험하다.) current_timestamp 계열 값을 사용하는 경우도 사용할 수 있다. 이 계열 값들은 한 트랜잭션 내에서 그 값이 바뀌지 않기 때문이다.

VOLATILE 옵션은 그 함수의 반환 값이 상황에 따라 얼마든지 바뀔 수 있는 경우에 사용한다. 최적화기에서는 예상값 추정을 못하는 경우로 처리한다. 이런 이유로 기본으로 제공하는 내장 SQL 함수 중에는 이 속성이 있는 함수가 상대적으로 적다. random(), currval(), timeofday() 이런 종류의 함수들이다. 그러나, 그 반환값이 일정할지라도, 예측하지 못하는 부작용이 생길 수 있는 함수들은 이 휘발성 함수로 지정하는 것이 안전하다. 그래야 최적화 계산에서 빠지게 된다. 대표적인 함수가 setval() 함수다.

LEAKPROOF 옵션은 해당 함수 처리에서 의도하지 않은 결과 side effect 가 없다고 지정한다. 이 옵션이 지정된 함수는 입력 인자를 받아 반환 값을 반환 하는 것 외에는 어떠한 정보도 보여주지 않는 함수임을 뜻한다. 예를 들어, 같은 인자에 대해 그 인자값에 따라 어떤 경우는 오류 메시지를 보여주고, 어떤 경우는 정상 처리하는 함수나, 어떤 오류 메시지에서 그 인자값을 포함하는 함수가 NOT LEAKPROOF 함수다. security_barrier 옵션을 지정한 뷰 또는, 로우 단위 보안 정책이 있는 테이블을 사용하는 뷰를 사용하는데 이 옵션은 영향을 준다. 의도되지 않은 자료 누출 사고를 막기 위해, NOT LEAKPROOF 함수를 포함하는 뷰 쿼리의 사용자 지정 조건 보다 먼저, 보안 정책과 자료 보호 뷰(security_barrier 옵션이 있는 뷰)의 조건이 적용된다. 이 LEAKPROOF 옵션을 지정한 함수나, 그 함수를 사용하는 연산자는 보안 정책이나, 자료 보호 뷰의 조건보다 먼저 실행 될 수도 있다. 추가로, 아무런 인자도 사용하지 않는 함수나, 자료 보호 뷰나, 테이블에서 어떤 인자도 전달하지 않는 함수는 보안 조건 전에 실행 될 수 있도록 이 옵션을 사용하지 말아야 한다. CREATE VIEW 명령 설명서와 40.5절 참조. 이 옵션은 슈퍼유저만 지정할 수 있다.

CALLED ON NULL INPUT (기본값) 옵션은 인자값으로 null 값을 사용해도 해당 함수 본문을 실행하도록 지정한다. 즉, 인자값 유효성 검사는 함수 본문에서 진행되며, 이 부분에 대한 책임은 사용자 몫이다.

RETURNS NULL ON NULL INPUT 또는 STRICT 옵션은 입력 인자 가운데 하나라도 null 값이 있으면, 함수 본문을 실행하지 않고, 무조건 null 값을 반환하도록 지정한다.

SECURITY INVOKER 옵션은 함수 본문을 실행할 때 그 실행 권한이 그 실행자의 권한을 사용한다. 이것이 기본값이다. 반면 SECURITY DEFINER 옵션은 함수 본문 실행 권한이 해당 함수 소유주의 권한을 사용한다.

EXTERNAL 옵션은 SQL 호환성 때문에 허용한다. 표준과 달리 이 옵션을 사용해도 모든 함수가 그 대상이 된다.

PARALLEL UNSAFE 옵션은 해당 함수가 병렬 쿼리 작업에서 안전하지 않다고 지정한다. 이것이 기본값이다. PARALLEL RESTRICTED 옵션은 병렬 쿼리 작업에서 사용될 수 있지만, 이 함수는 반드시 병렬 그룹 리더 작업자만 실행해야 하는 함수로 지정한다. PARALLEL SAFE 옵션은 해당 함수가 병렬 쿼리 작업에서 어떤 제한도 없이 안전하다고 지정한다.

데이터베이스 상태를 변경하거나, 서브 트랜잭션 같은 것을 사용해서 트랜잭션에 변경 사항을 만들거나, 시쿼스를 사용하거나, setval 같이 값을 고정하거나 하는 함수는 UNSAFE로 지정해야 한다. 임시 테이블을 사용하거나, 클라이언트 접속 상태를 조회하거나, 커서, 미리 준비된 구문, setseed 같이 하나의 작업에서는 일관성을 유지해야 하는 일을 하는 함수는 RESTRICTED로 지정해야 한다. 일반적으로, RESTRICTED나, UNSAFE 함수를 SAFE 함수로 지정하거나, UNSAFE 함수를 RESTRICTED 함수로 지정하면, 그 함수를 사용하는 쿼리는 병렬 쿼리로 처리된다. 이렇게 되면, 그 쿼리가 오류로 처리되든가, 잘못된 결과를 보여 줄 수 있다. 서버는 임의 C 코드에 대항해서 자신을 지킬 방법이 없어, 이론적으로, 이런 잘못된 속성을 지정한 C 언어로 만든 함수는 충분히 오동작을 할 수 있다. 하지만 그 오동작 결과가 다른 언어로 만든 함수들 보다는 더 나쁘지는 않다. 그 함수가 하는 일을 정확히 몰라 오동작이 우려되면, 기본값인 UNSAFE 옵션을 사용하는 것이 안전하다.

해당 함수의 cpu_operator_cost 값. 이 값은 양수여야 하며, 실행계획기가 이 값을 사용한다. 해당 함수가 다중 로우를 반환한다면, 이 비용은 한 로우를 반환하는데 드는 비용이다. 이 옵션을 사용하지 않으면, C 언어 함수와 내장 함수는 1, 그외 함수는 100이 기본값이다. 이 값이 크면, 실행계획기는 최대한 이 함수를 자주 사용하지 않도록 계획을 짠다.

함수가 레코드 반환 또는 테이블 반환하는 경우에, 그 예상 자료 수를 지정한다. 이 값은 실행계획기에서 사용한다. 이 옵션은 다중 로우를 반환하는 함수에서만 쓸 수 있다. 기본 값은 1000 개의 로우다.

The name (optionally schema-qualified) of a planner support function to use for this function. See 37.11절 for details. You must be superuser to use this option.

SET 옵션은 해당 함수가 실행 될 때 사용할 환경 설정 매개 변수를 설정한다. 기존 환경 설정 매개 변수값은 따로 보관해 두고, 함수가 실행 될 때는 이 설정 값을 사용하고, 함수 실행이 끝나면 설정값을 자동으로 사용한다. SET FROM CURRENT 옵션은 CREATE FUNCTION 명령을 실행할 때 그 세션이 사용하고 있는 해당 환경 설정 매개 변수의 값을 지정한다.

SET 옵션을 추가해서 함수를 만들면, 내부적으로 그 함수 본문이 실행 되기 전에, SET LOCAL 명령이 먼저 실행 되는 것과 같은 기능을 한다: 이것은 함수 실행 전 설정 값은 보관하고, 지정한 매개 변수 값으로 지정한 값을 사용하고, 함수가 끝날 때 이전 값으로 다시 설정 한다. 반면, 함수 본문 내, LOCAL 옵션이 없는 SET 명령을 사용하면 그 설정값은 함수가 실패로 끝나지 않는 한, 해당 세션이 종료되기 전까지 유지된다.

여기서 사용할 수 있는 매개 변수 이름과 값에 대한 설명은 SET 명령 설명서와 See SET에서 보다 자세히 다룬다.

LANGUAGE 옵션에서 지정한 언어와 관계된 해당 함수가 하는 일을 문자열로 지정한다. 여기에 내장 함수 이름, 오브젝트 파일 경로, SQL 명령어, 또는 프로시져 언어 문법으로 작성된 코드들을 지정한다.

함수 정의 문자열을 지정할 때는 일반 작은 따옴표 인용법 보다, 때로는 달러 인용법이 유용하게 쓰인다(4.1.2.4절 참조). 달러 인용법을 사용하지 않으면, 이 함수 정의 안에 작은 따옴표는 모두 두 개로 표기해야 하기 때문이다.

C 언어 소스 코드 안에 있는 함수 이름이 만들고자 하는 SQL 함수 이름과 다를 때, 이 구문을 이용해서 동적 불러오기 가능한 C 언어 함수를 지정한다. 오브젝트파일은 컴파일된 C 함수를 포함하고 있는 공유 라이브러리 파일 이름이다. 이 함수를 서버로 불러오려면, LOAD 명령을 사용한다. 링크_심벌은 그 라이브러리 파일에 있는 C 함수 이름이다. 링크 심벌이 빠지면, SQL 함수 이름과 같은 함수로 간주한다. SQL 함수 이름은 오버로드되지만, C 함수 이름은 그렇게 사용할 수 없기 때문에, C 함수 이름은 모두 달라야 한다(예, C 함수 이름으로 함수 이름과 인자 자료형 이름을 함께 사용한다).

세션이 해당 함수가 처음 한 번 사용하면, 이 때 해당 공유 라이브러리를 자동으로 서버로 불러온다. 이 상황에서 개발 중에, 다시 만든 같은 공유 라이브러리를 이용해서 CREATE FUNCTION 작업을 하는 경우는 먼저 불러온 공유 라이브러리를 다시 불러오고, 세션을 다시 시작 한 다음 작업해야 한다.