사용자 정의 함수

아티클
08/23/2023

적용 대상: Microsoft Fabric의 Microsoft Fabric Warehouse에 있는 SQL Server Azure SQL Database Azure SQL Managed InstanceSQL 분석 엔드포인트

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

사용자 정의 함수의 이점

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

모듈식 프로그래밍. 함수를 한 번 만들고, 데이터베이스에 저장하고, 프로그램에서 여러 번 호출할 수 있습니다. 사용자 정의 함수는 프로그램 소스 코드와 독립적으로 수정할 수 있습니다.
더 빠른 실행. 저장 프로시저와 마찬가지로 Transact-SQL 사용자 정의 함수는 계획을 캐싱하고 반복 실행을 위해 다시 사용하여 Transact-SQL 코드의 컴파일 비용을 줄입니다. 즉, 사용자 정의 함수는 각 사용 시 재문 분석 및 다시 운용할 필요가 없으므로 실행 시간이 훨씬 빨라집니다.

CLR 함수는 계산 작업, 문자열 조작 및 비즈니스 논리에 대해 Transact-SQL 함수에 비해 상당한 성능 이점을 제공합니다. Transact-SQL 함수는 데이터 액세스 집약적 논리에 더 적합합니다.
네트워크 트래픽을 줄입니다. 단일 스칼라 식으로 표현할 수 없는 일부 복잡한 제약 조건을 기반으로 데이터를 필터링하는 작업은 함수로 표현될 수 있습니다. 그런 다음 WHERE 절에서 이 함수를 호출하여 클라이언트에 전송되는 행 수를 줄일 수 있습니다.

Important

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

함수 유형

스칼라 함수

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

테이블 반환 함수

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 함수에 로컬인 변수에 값을 할당하는 식이 있는 select 목록을 포함하는 문입니다.
UPDATE, INSERT및 DELETE 함수에 로컬인 테이블 변수를 수정하는 문입니다.
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개 입력 매개 변수가 있을 수 있습니다. 함수의 매개 변수에 기본값이 있는 경우 기본값을 가져오기 위해 함수를 호출할 때 키워드(keyword) DEFAULT를 지정해야 합니다. 이 동작은 매개 변수를 생략하면 기본값을 의미하는 사용자 정의 저장 프로시저의 기본값이 있는 매개 변수와 다릅니다. 사용자 정의 함수는 출력 매개 변수를 지원하지 않습니다.