사용자 정의 함수

적용 대상: SQL Server Azure SQL 데이터베이스Azure SQL Managed Instance

프로그래밍 언어의 함수와 마찬가지로 SQL Server 사용자 정의 함수는 매개 변수를 수락하고, 복잡한 계산과 같은 작업을 수행하고, 해당 작업의 결과를 값으로 반환하는 루틴입니다. 반환 값은 단일 스칼라 값이나 결과 집합일 수 있습니다.

사용자 정의 함수의 이점

UDF(사용자 정의 함수)를 사용하는 이유는 무엇인가요?

  • 모듈식 프로그래밍. 함수를 한 번 만들어 데이터베이스에 저장한 후에는 프로그램에서 여러 번 호출할 수 있습니다. 사용자 정의 함수는 프로그램 원본 코드에 관계없이 수정할 수 있습니다.

  • 더 빠른 실행. 저장 프로시저와 마찬가지로 Transact-SQL 사용자 정의 함수는 계획을 캐싱하고 반복 실행을 위해 다시 사용하여 Transact-SQL 코드의 컴파일 비용을 줄입니다. 즉, 사용자 정의 함수는 각 사용 시 재분석 및 다시 최적화할 필요가 없으므로 실행 시간이 훨씬 빨라집니다.

    CLR 함수는 계산 작업, 문자열 조작 및 비즈니스 논리에 대한 Transact-SQL 함수에 비해 상당한 성능 이점을 제공합니다. Transact-SQL 함수는 데이터 액세스 집약적 논리에 더 적합합니다.

  • 네트워크 트래픽을 줄입니다. 단일 스칼라 식에서 표현할 수 없는 일부 복잡한 제약 조건을 기반으로 데이터를 필터링하는 작업을 함수로 표현할 수 있습니다. 그런 다음 WHERE 절에서 이 함수를 호출하여 클라이언트에 전송되는 행 수를 줄일 수 있습니다.

중요

쿼리의 Transact-SQL UDF는 단일 스레드(직렬 실행 계획)에서만 실행할 수 있습니다. 따라서 UDF를 사용하여 병렬 쿼리 처리를 금지합니다. 병렬 쿼리 처리에 대한 자세한 내용은 쿼리 처리 아키텍처 가이드를 참조하세요.

함수 유형

스칼라 함수

사용자 정의 스칼라 함수는 RETURNS 절에 정의된 유형의 단일 데이터 값을 반환합니다. 인라인 스칼라 함수의 경우 반환된 스칼라 값이 단일 문의 결과입니다. 다중 상태 스칼라 함수의 경우 함수 본문에는 단일 값을 반환하는 일련의 Transact-SQL 문이 포함될 수 있습니다. 반환 유형은 text, ntext, image, cursortimestamp를 제외한 모든 데이터 형식일 수 있습니다. 예제는 사용자 정의 함수 만들기(데이터베이스 엔진)를 참조하세요.

테이블 반환 함수

사용자 정의 TVF(테이블 반환 함수)는 테이블 데이터 형식을 반환합니다. 인라인 테이블 반환 함수에는 함수 본문이 없으며 테이블이 단일 SELECT 문의 결과 집합입니다. 예제는 사용자 정의 함수 만들기(데이터베이스 엔진)를 참조하세요.

시스템 함수

SQL Server 다양한 작업을 수행하는 데 사용할 수 있는 많은 시스템 함수를 제공합니다. 수정할 수 없습니다. 자세한 내용은 기본 제공 함수(Transact-SQL), 시스템 저장된 함수(Transact-SQL)동적 관리 뷰 및 함수(Transact-SQL)를 참조하세요.

지침

문을 취소하고 모듈의 다음 문(예: 트리거 또는 저장 프로시저)을 계속 진행하는 Transact-SQL 오류는 함수 내에서 다르게 처리됩니다. 함수에서 그러한 오류가 발생하면 함수의 실행이 중단됩니다. 이에 따라 함수를 호출한 문도 취소됩니다.

블록의 BEGIN...END 문에는 부작용이 있을 수 없습니다. 함수의 부작용으로는 데이터베이스 테이블 수정과 같은 함수 외부 범위를 갖는 리소스 상태의 영구적인 변경을 들 수 있습니다. 함수의 문에서 변경할 수 있는 것은 로컬 커서나 변수와 같은 함수의 로컬 개체뿐입니다. 데이터베이스 테이블 수정, 함수에 로컬이 아닌 커서 작업, 전자 메일 보내기, 카탈로그 수정 시도 및 사용자에게 반환되는 결과 집합 생성은 함수에서 수행할 수 없는 작업의 예입니다.

CREATE FUNCTION 문이 실행되면 문이 존재하지 CREATE FUNCTION 않는 리소스에 대한 부작용이 발생하는 경우 SQL Server 문을 실행합니다. 그러나 SQL Server 호출될 때 함수를 실행하지 않습니다.

쿼리에 지정된 함수가 실행되는 횟수는 최적화 프로그램에서 빌드한 실행 계획마다 다를 수 있습니다. 예를 들면 WHERE 절의 하위 쿼리에서 호출하는 함수가 있습니다. 하위 쿼리 및 그 함수가 실행되는 횟수는 최적화 프로그램에서 선택한 액세스 경로에 따라 다릅니다.

결정적 함수는 스키마 바인딩되어야 합니다. 결정적 함수를 SCHEMABINDING 만들 때 절을 사용합니다.

사용자 정의 함수에 대한 자세한 내용 및 성능 고려 사항은 사용자 정의 함수 만들기(데이터베이스 엔진)를 참조하세요.

함수의 유효한 문

함수에서 사용할 수 있는 문의 유형은 다음과 같습니다.

  • 함수에서 로컬로 사용되는 데이터 변수와 커서를 정의하는 데 사용되는 DECLARE

  • SET를 사용하여 스칼라 및 테이블 지역 변수에 값을 할당하는 것과 같이 함수의 로컬 개체에 값 할당

  • 함수에서 커서 선언, 열기, 닫기, 할당 취소 등 로컬 커서를 참조하는 커서 작업. FETCH 클라이언트에 데이터를 반환하는 문은 허용되지 않습니다. INTO 절을 사용하여 지역 변수에 값을 할당하는 FETCH 문만 사용할 수 있습니다.

  • TRY...CATCH 문을 제외한 흐름 제어 명령문

  • 함수에서 로컬로 사용되는 변수에 값을 할당하는 식이 있는 선택 목록이 포함된 SELECT

  • 함수에서 로컬로 사용되는 테이블 변수를 수정하는 UPDATE, INSERTDELETE

  • 확장 저장 프로시저를 호출하는 EXECUTE

기본 제공 시스템 함수

다음과 같은 비결정적 기본 제공 함수는 Transact-SQL 사용자 정의 함수에 사용할 수 있습니다.

  • CURRENT_TIMESTAMP
  • GET_TRANSMISSION_STATUS
  • GETDATE
  • GETUTCDATE
  • @@CONNECTIONS
  • @@CPU_BUSY
  • @@DBTS
  • @@IDLE
  • @@IO_BUSY
  • @@MAX_CONNECTIONS
  • @@PACK_RECEIVED
  • @@PACK_SENT
  • @@PACKET_ERRORS
  • @@TIMETICKS
  • @@TOTAL_ERRORS
  • @@TOTAL_READ
  • @@TOTAL_WRITE

다음과 같은 비결정적 기본 제공 함수는 Transact-SQL 사용자 정의 함수에 사용할 수 없습니다.

  • NEWID
  • NEWSEQUENTIALID
  • RAND
  • TEXTPTR

결정적 및 비결정적 기본 제공 시스템 함수 목록은 결정적 함수 및 비결정적 함수를 참조하세요.

스키마 바운드 함수

CREATE FUNCTION에서는 테이블, 뷰, 다른 사용자 정의 함수와 같은 참조하는 개체의 스키마에 함수를 바인드하는 SCHEMABINDING 절을 지원합니다. 스키마 바운드 함수에서 참조하는 개체는 변경하거나 삭제할 수 없습니다.

CREATE FUNCTION에서 SCHEMABINDING 절을 지정하려면 먼저 다음 조건이 만족되어야 합니다.

  • 함수에서 참조하는 모든 뷰와 사용자 정의 함수도 스키마 바운드이어야 합니다.

  • 함수에서 참조하는 모든 개체가 함수와 같은 데이터베이스에 있어야 합니다. 개체는 한 부분 또는 두 부분으로 된 이름을 사용하여 참조해야 합니다.

  • 함수에서 참조하는 모든 개체(테이블, 뷰, 사용자 정의 함수)에 대해 REFERENCES 권한이 있어야 합니다.

ALTER FUNCTION을 사용하여 스키마 바인딩을 제거할 수 있습니다. ALTER FUNCTION 문에서 WITH SCHEMABINDING 절 없이 함수를 다시 정의해야 합니다.

매개 변수 지정

사용자 정의 함수에서는 0이나 더 많은 입력 매개 변수를 사용하고 스칼라 값 또는 테이블을 반환합니다. 하나의 함수에 최대 1024개의 입력 매개 변수를 지정할 수 있습니다. 함수의 매개 변수에 기본값이 지정되면 기본값을 가져오는 함수를 호출할 때 DEFAULT 키워드를 지정해야 합니다. 이 동작은 매개 변수 생략이 기본값을 의미하기도 하는 사용자 정의 저장 프로시저의 기본값이 있는 매개 변수와 다릅니다. 사용자 정의 함수는 출력 매개 변수를 지원하지 않습니다.

추가 정보