CREATE FUNCTION

CREATE FUNCTION

카탈로그에 사용자 정의 함수(UDF, user-defined function)를 만들거나 교체할 때 쓰는 명령어예요. 반복되는 로직을 SQL 함수로 정의해 재사용할 수 있어요.

출처: 문서

본문

Synopsis

CREATE [OR REPLACE] FUNCTION
  udf_definition

Description

카탈로그 사용자 정의 함수를 생성하거나 교체해요. udf_definition은 FUNCTION의 사용과 중첩된 문장들로 구성돼요. 기본 UDF 저장 카탈로그와 스키마가 설정되어 있지 않다면 UDF의 이름은 카탈로그와 스키마 위치로 완전히 한정(fully qualified)해야 해요. 카탈로그에서 사용하는 커넥터는 UDF 저장을 지원해야 해요.

선택적인 OR REPLACE 절은 UDF가 이미 존재할 때 오류를 내는 대신 기존 UDF를 교체해요.

Examples

example 카탈로그의 기본 스키마에 meaning_of_life UDF를 만들려면:

CREATE FUNCTION example.default.meaning_of_life()
  RETURNS bigint
  BEGIN
    RETURN 42;
  END;

UDF 저장용 기본 카탈로그와 스키마가 설정되어 있다면 더 간결한 문법을 사용할 수 있어요:

CREATE FUNCTION meaning_of_life() RETURNS bigint RETURN 42;

FUNCTION 문장을 다른 문장과 조합해 사용하는 다양한 난이도의 더 많은 예시는 SQL UDF 예시 문서에서 확인할 수 있어요.

See also

DROP FUNCTION, SHOW CREATE FUNCTION, SHOW FUNCTIONS 명령과 사용자 정의 함수·SQL 환경 속성 문서를 함께 참고하세요.

더 알아보기 (Learn more)

사용자 정의 함수를 제거하는 DROP FUNCTION과 Trino의 SQL UDF 예시 모음, User-defined functions 문서를 함께 살펴보세요.