함수 생성

적용 대상:Microsoft Fabric의 SQL 분석 엔드포인트 및 웨어하우스

CREATE FUNCTION 는 인라인 테이블 값 함수 및 스칼라 함수를 만들 수 있습니다.

사용자 정의 함수는 매개 변수를 허용하고 복잡한 계산 등의 동작을 수행하며 해당 동작의 결과를 값으로 반환하는 Transact-SQL 루틴입니다. 스칼라 함수는 숫자 또는 문자열과 같은 스칼라 값을 반환합니다. TVF(사용자 정의 테이블 반환 함수)는 테이블을 반환합니다.

다음과 같은 방법으로 사용할 수 있는 재사용 가능한 T-SQL 루틴을 만드는 데 사용합니다 CREATE FUNCTION .

• Transact-SQL 문에서 SELECT
• Transact-SQL DML(데이터 조작 문)에서 UPDATEINSERT, 및DELETE
• 함수를 호출하는 애플리케이션
• 다른 사용자 정의 함수의 정의
• 저장 프로시저 바꾸기

Transact-SQL 구문 표기 규칙

구문

스칼라 함수 구문

CREATE FUNCTION [ schema_name. ] function_name   
( [ { @parameter_name [ AS ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
  ]  
)  
RETURNS return_data_type  
    [ WITH <function_option> [ ,...n ] ]  
    [ AS ]  
    BEGIN   
        function_body   
        RETURN scalar_expression  
    END  
[ ; ]  

<function_option>::=   
{  
    [ SCHEMABINDING ]  
  | [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]  
}  

인라인 테이블 반환 함수 구문

CREATE FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] parameter_data_type
    [ = default ] }
    [ ,...n ]
  ]
)
RETURNS TABLE
    [ WITH SCHEMABINDING ]
    [ AS ]
    RETURN [ ( ] select_stmt [ ) ]
[ ; ]

인수

schema_name

사용자 정의 함수가 속한 스키마의 이름입니다.

function_name

사용자 정의 함수의 이름입니다. 함수 이름은 식별자에 대한 규칙을 따라야 하며 데이터베이스에서 각 스키마별로 고유해야 합니다.

@ parameter_name

사용자 정의 함수(UDF)의 매개 변수입니다. 하나 이상의 매개 변수를 선언할 수 있습니다.

하나의 함수에 최대 2,100개의 매개 변수를 지정할 수 있습니다. 매개 변수에 기본값이 정의되지 않은 경우 함수를 실행할 때 사용자가 선언된 각 매개 변수의 값을 지정해야 합니다.

"at" 기호( @ )를 첫 번째 문자로 사용하여 매개 변수 이름을 지정하십시오. 매개 변수 이름은 식별자에 대한 규칙을 따라야 합니다. 매개 변수는 함수에서 로컬로 사용되므로 다른 함수에서 동일한 매개 변수 이름을 사용할 수 있습니다. 매개 변수는 상수 대신 사용할 수 있지만 테이블 이름, 열 이름 또는 다른 데이터베이스 개체의 이름 대신 사용할 수는 없습니다.

parameter_data_type

매개 변수 데이터 형식입니다. Transact-SQL 함수의 경우 지원되는 모든 스칼라 데이터 형식 이 허용됩니다.

[ = 기본값 ]

매개 변수의 기본값입니다. 기본 값이 정의되어 있으면 해당 매개 변수 값을 지정하지 않아도 함수를 실행할 수 있습니다.

함수의 매개변수에 기본값이 있는 경우, 기본값을 검색하기 위해 함수가 호출될 때 키워드 DEFAULT 를 지정해야 합니다. 이 동작은 매개 변수를 생략할 경우 자동으로 기본값이 사용되는 저장 프로시저에서 기본값이 있는 매개 변수를 사용하는 것과는 다릅니다.

return_data_type

스칼라 사용자 정의 함수의 반환 값입니다.

Fabric Data Warehouse의 함수의 경우 rowversion/타임스탬프를 제외한 모든 데이터 형식이 허용됩니다. 테이블과 같은 비칼라 형식은 허용되지 않습니다.

function_body

일련의 Transact-SQL 문입니다.

스칼라 함수에서 function_body 함께 스칼라 값으로 계산되는 일련의 Transact-SQL 문입니다. 여기에는 다음이 포함될 수 있습니다.

• 단일 문 식
• 다중 문 식(IF/THEN/ELSE 및 BEGIN/END 블록)
• 지역 변수
• 사용 가능한 기본 제공 SQL 함수에 대한 호출
• 다른 UDF에 대한 호출
• SELECT 테이블, 뷰 및 인라인 테이블 반환 함수에 대한 문 및 참조

scalar_expression

스칼라 함수가 반환하는 스칼라 값을 지정합니다.

select_stmt

인라인 테이블 반환 함수의 반환 값을 정의하는 단일 SELECT 문입니다. 인라인 테이블 반환 함수의 경우 함수 본문이 없습니다. 테이블은 단일 SELECT 문의 결과 집합입니다.

테이블

TVF(테이블 반환 함수)의 반환 값이 테이블임을 지정합니다. 상수 및 @local_variables만 TVF에 전달할 수 있습니다.

인라인 TVF(미리 보기)에서 TABLE 반환 값은 단일 SELECT 문을 통해 정의됩니다. 인라인 함수에는 연관된 반환 변수가 없습니다.

<function_option>

Fabric Data Warehouse INLINE에서는 , ENCRYPTION및 EXECUTE AS 키워드가 지원되지 않습니다.

지원되는 함수 옵션은 다음과 같습니다.

스키마바인딩

함수를 함수가 참조하는 데이터베이스 개체에 바인딩되도록 지정합니다. SCHEMABINDING을 지정하면 함수 정의에 영향을 미치는 방식으로 기본 개체를 수정할 수 없습니다. 함수 정의 자체를 먼저 수정하거나 삭제하여 수정할 개체에 대한 종속성을 제거해야 합니다.

다음 동작 중 하나만 발생해도 참조하는 개체에 대한 함수 바인딩이 제거됩니다.

• 함수가 삭제된 경우

• SCHEMABINDING 옵션을 지정하지 않은 상태에서 ALTER 문을 사용하여 함수를 수정한 경우

다음 조건을 만족하는 경우에만 함수가 스키마에 바인딩될 수 있습니다.

• 함수가 참조하는 사용자 정의 함수도 스키마에 바인딩됩니다.

• 함수에서 참조하는 개체는 두 부분으로 구성된 이름을 사용하여 참조됩니다.

• 기본 제공 함수 및 동일한 데이터베이스의 다른 UDF만 UDF의 본문 내에서 참조할 수 있습니다.

• 문을 실행한 CREATE FUNCTION 사용자에게 함수가 참조하는 데이터베이스 개체에 대한 REFERENCES 권한이 있습니다.

SCHEMABINDING을 ALTER제거하려면 .

NULL 입력에서 NULL 반환 | NULL 입력에서 호출

스칼라 반환 함수의 특성을 지정 OnNULLCall 합니다. 지정 CALLED ON NULL INPUT 하지 않으면 기본적으로 암시되며 함수 본문은 인수로 전달되더라도 NULL 실행됩니다.

모범 사례

• 스키마바인딩을 사용하여 사용자 정의 함수를 만들지 않은 경우 기본 개체에 대한 변경 내용이 함수의 정의에 영향을 미치고 호출될 때 예기치 않은 결과를 생성할 수 있습니다. 함수를 만들 때 절을 WITH SCHEMABINDING 지정하는 것이 좋습니다. 이렇게 하면 함수도 수정되지 않는 한 함수 정의에서 참조된 개체를 수정할 수 없습니다.

• 인라인화할 수 있도록 사용자 정의 함수를 작성합니다. 자세한 내용은 스칼라 UDF 인라인 처리를 참조하세요.

상호 운용성

인라인 테이블 반환 사용자 정의 함수

인라인 테이블 반환 함수에서는 단일 select 문만 허용됩니다.

스칼라 사용자 정의 함수

• 스칼라 반환 함수에서 유효한 문은 다음과 같습니다.

  • 대입문
  • 문을 제외한 TRY...CATCH 흐름 제어 문
  • DECLARE 로컬 데이터 변수를 정의하는 문

• 다음 기본 제공 함수는 스칼라 반환 함수 본문에서 지원되지 않습니다.

  • NEWID()
  • RAND()
  • 구성 함수
  • DATABASEPROPERTYEX
  • OBJECTPROPERTYEX
  • SERVERPROPERTY
  • 다음 값:
  • COLLATIONPROPERTY
  • HAS_PERMS_BY_NAME
  • HAS_DBACCESS

• 다음과 같은 경우 사용자 테이블의 쿼리에서 SELECT ... FROM 스칼라 UDF를 사용할 수 없습니다.

  • UDF 본문에는 비결정적 기본 제공 함수에 대한 호출이 포함되어 있습니다. 결정적 함수 및 비결정적 함수를 참조하세요.
  • UDF 본문에는 CTE(공통 테이블 식)가 포함됩니다.
  • UDF 본문에는 6개 블록을 초과하는 다중 문 UDF 본문이 IF--THENELSE 포함되어 있습니다.
  • UDF 본문에 WHILE LOOP가 포함되어 있습니다.
  • 다른 이유로 인해 UDF 본문을 인라인할 수 없습니다. 자세한 내용은 스칼라 UDF 인라인 요구 사항을 참조하세요.

• 다음과 같은 경우 쿼리에서 스칼라 UDF를 사용할 수 없습니다.

  • UDF는 절에서 GROUP BY 직접 호출됩니다.
  • UDF는 절에서 직접 호출됩니다 ORDER BY .
  • 호출 쿼리에는 CTE(공통 테이블 식)가 있습니다.

• 재귀 스칼라 UDF는 지원되지 않습니다.

• 단일 쿼리에서 10개 이상의 UDF 호출이 수행되면 사용자 쿼리가 실패할 수 있습니다.

• 일부 에지의 경우 사용자 쿼리 및 UDF 본문의 복잡성으로 인라인 처리가 방지되며, 이 경우 스칼라 UDF가 인라인되지 않고 사용자 쿼리가 실패합니다.

• 지원되지 않는 시나리오에서 스칼라 UDF를 사용하는 경우 "Scalar UDF execution is currently unavailable in this context." 오류 메시지가 표시됩니다.

제한 사항

사용자 정의 함수는 데이터베이스 상태 수정 동작을 수행하는 데 사용할 수 없습니다.

사용자 정의 함수는 중첩될 수 있습니다. 즉, 하나의 사용자 정의 함수가 다른 사용자 정의 함수를 호출할 수 있습니다. 중첩 수준은 호출된 함수의 실행이 시작되면 늘어나고 호출된 함수의 실행이 끝나면 줄어듭니다. UDF 본문이 테이블/뷰/인라인 테이블 반환 함수를 참조할 때 패브릭 데이터 웨어하우스의 사용자 정의 함수를 최대 4개 수준까지 중첩하거나, 그렇지 않으면 최대 32개의 수준을 중첩할 수 있습니다. 최대 중첩 수준을 초과하면 호출 함수 체인이 실패합니다.

메타데이터

이 섹션에서는 사용자 정의 함수에 대한 메타데이터를 반환하는 데 사용할 수 있는 시스템 카탈로그 뷰를 나열합니다.

• sys.sql_modules: Transact-SQL 사용자 정의 함수의 정의를 표시합니다. 예를 들면 다음과 같습니다.

  SELECT definition, type   
  FROM sys.sql_modules AS m  
  JOIN sys.objects AS o   
      ON m.object_id = o.object_id   
      AND type = ('FN');
  

• sys.parameters: 사용자 정의 함수에 정의된 매개 변수에 대한 정보를 표시합니다.

• sys.sql_expression_dependencies: 함수에서 참조하는 기본 개체를 표시합니다.

사용 권한

패브릭 작업 영역 관리자, 멤버 및 기여자 역할의 멤버는 함수를 만들 수 있습니다.

스칼라 UDF 인라인 처리

Microsoft Fabric Data Warehouse는 스칼라 UDF 인라인을 사용하여 분산 방식으로 사용자 정의 코드를 컴파일하고 실행합니다. 스칼라 UDF 인라인 처리는 기본적으로 사용하도록 설정됩니다.

스칼라 UDF 인라인 처리는 Microsoft SQL Server 2019(15.0)에서 처음 도입된 성능 최적화 기술이지만 Fabric Data Warehouse에서는 지원되는 시나리오 집합을 결정합니다. Fabric Data Warehouse에서 스칼라 UDF는 UDF 연산자 대신 호출 쿼리에서 대체되는 스칼라 식 또는 스칼라 하위 쿼리로 자동으로 변환됩니다.

일부 T-SQL 구문은 스칼라 UDF를 비인라인화할 수 없게 만듭니다. 루프, 여러 RETURN 문 또는 비결정적 SQL 기본 제공 함수(예: GETUTCDATE() 또는GETDATE())에 대한 호출을 포함하는 WHILE 함수는 인라인 처리할 수 없습니다. 자세한 내용은 스칼라 UDF 인라인 요구 사항을 참조하세요.

스칼라 UDF를 인라인 처리할 수 있는지 확인

카탈로그 뷰에는 sys.sql_modules UDF를 인라인화할 수 있는지 여부를 나타내는 열 is_inlineable이 포함됩니다.

이 is_inlineable 속성은 UDF 정의 내의 구문을 검사하여 파생됩니다. 스칼라 UDF는 컴파일 시간 전에 인라인되지 않습니다. 값 1 은 UDF가 인라인화할 수 있음을 나타내고 값 0 은 인라인화할 수 없음을 나타냅니다. 스칼라 UDF를 인라인화할 수 있는 경우 쿼리가 컴파일될 때 항상 인라인 처리되도록 보장하지는 않습니다.

패브릭 데이터 웨어하우스는 전체 쿼리 복잡성에 따라 UDF를 인라인할지 여부를 쿼리별로 결정합니다.

다음 샘플 쿼리를 사용하여 스칼라 UDF를 인라인화할 수 있는지 확인합니다.

SELECT 
SCHEMA_NAME(b.schema_id) as function_schema_name,
    b.name as function_name,
       b.type_desc as function_type,
       a.is_inlineable
FROM sys.sql_modules AS a
     INNER JOIN sys.objects AS b
         ON a.object_id = b.object_id
WHERE b.type IN ('FN');

스칼라 함수를 인라인화할 수 없는 sys.sql_modules.is_inlineable경우에도 쿼리를 독립 실행형 호출로 실행하여 변수를 설정할 수 있습니다. 그러나 스칼라 함수는 사용자 테이블의 SELECT ... FROM 쿼리에 속할 수 없습니다. 예를 들면 다음과 같습니다.

CREATE FUNCTION [dbo].[custom_SYSUTCDATETIME]()
  RETURNS datetime2(6)
  AS
  BEGIN
   RETURN SYSUTCDATETIME();
  END

샘플 dbo.custom_SYSUTCDATETIME 스칼라 사용자 정의 함수는 비결정 시스템 함수 SYSUTCDATETIME()를 사용하므로 인라인화할 수 없습니다. 사용자 테이블의 SELECT ... FROM 쿼리에서 사용하면 실패하지만 독립 실행형 호출로 성공합니다. 예를 들면 다음과 같습니다.

DECLARE @utcdate datetime2(7);
SET @utcdate = dbo.custom_SYSUTCDATETIME();
SELECT @utcdate as 'utc_date';

예시

A. 인라인 테이블 반환 함수 만들기

다음 예제에서는 objectType 매개 변수를 기준으로 필터링하여 모듈에 대한 일부 키 정보를 반환하는 인라인 테이블 반환 함수를 만듭니다. 매개 변수를 사용하여 함수를 호출할 때 모든 모듈을 반환하는 기본값이 DEFAULT 포함됩니다. 이 예제에서는 메타데이터에 설명된 일부 시스템 카탈로그 뷰를 사용합니다.

CREATE FUNCTION dbo.ModulesByType (@objectType CHAR(2) = '%%')
RETURNS TABLE
AS
RETURN (
        SELECT sm.object_id AS 'Object Id',
            o.create_date AS 'Date Created',
            OBJECT_NAME(sm.object_id) AS 'Name',
            o.type AS 'Type',
            o.type_desc AS 'Type Description',
            sm.DEFINITION AS 'Module Description',
            sm.is_inlineable AS 'Inlineable'
        FROM sys.sql_modules AS sm
        INNER JOIN sys.objects AS o ON sm.object_id = o.object_id
        WHERE o.type LIKE '%' + @objectType + '%'
        );
GO

그런 다음, 다음을 사용하여 모든 인라인 테이블 반환 함수(IF)를 반환하기 위해 함수를 호출할 수 있습니다.

SELECT * FROM dbo.ModulesByType('IF'); -- SQL_INLINE_TABLE_VALUED_FUNCTION

또는 모든 스칼라 함수(FN)를 찾습니다.

SELECT * FROM dbo.ModulesByType('FN'); -- SQL_SCALAR_FUNCTION

B. 인라인 테이블 반환 함수의 결과 결합

이 간단한 예제에서는 이전에 만든 인라인 TVF에서 cross apply를 사용하여 결과를 다른 테이블과 결합할 수 있는 방법을 보여 줍니다. 여기서는 열에서 일치하는 type 모든 행의 결과와 둘 다 sys.objects 에서 ModulesByType 모든 열을 선택합니다. apply 사용에 대한 자세한 내용은 FROM 절과 JOIN, APPLY, PIVOT(Transact-SQL)를 참조하세요.

SELECT * 
FROM sys.objects AS o
CROSS APPLY dbo.ModulesByType(o.type);
GO

C. 스칼라 UDF 함수 만들기

다음 예제에서는 입력 텍스트를 마스킹하는 인라인 가능한 스칼라 UDF를 만듭니다.

CREATE OR ALTER FUNCTION [dbo].[cleanInput] (@InputString VARCHAR(100))
    RETURNS VARCHAR(50)
    AS
    BEGIN
        DECLARE @Result VARCHAR(50)
        DECLARE @CleanedInput VARCHAR(50)

        -- Trim whitespace
        SET @CleanedInput = LTRIM(RTRIM(@InputString))

        -- Handle empty or null input
        IF @CleanedInput = '' OR @CleanedInput IS NULL
        BEGIN
            SET @Result = ''
        END
        ELSE IF LEN(@CleanedInput) <= 2
        BEGIN
            -- If string length is 1 or 2, just return the cleaned string
            SET @Result = @CleanedInput
        END
        ELSE
        BEGIN
            -- Construct the masked string
            SET @Result = 
                LEFT(@CleanedInput, 1) +
                REPLICATE('*', LEN(@CleanedInput) - 2) +
                RIGHT(@CleanedInput, 1)
        END

        RETURN @Result
    END

다음과 같이 함수를 호출할 수 있습니다.

DECLARE @input varchar(100) = '123456789'

SELECT dbo.cleanInput (@input) AS function_output;

패브릭 데이터 웨어하우스에서 스칼라 UDF를 사용하는 방법에 대한 추가 예제:

문에서 SELECT :

SELECT TOP 10 
t.id, t.name, 
dbo.cleanInput (t.name) AS function_output
FROM dbo.MyTable AS t;

절에서 다음을 수행합니다.WHERE

 SELECT t.id, t.name, dbo.cleanInput(t.name) AS function_output
FROM dbo.MyTable AS t
WHERE dbo.cleanInput(t.name)='myvalue'

절에서 다음을 수행합니다.JOIN

SELECT t1.id, t1.name, 
     dbo.cleanInput (t1.name) AS function_output, 
     dbo.cleanInput (t2.name) AS function_output_2
FROM dbo.MyTable1 AS t1
    INNER JOIN dbo.MyTable2 AS t2 
        ON dbo.cleanInput(t1.name)=dbo.cleanInput(t2.name);

절에서 다음을 수행합니다 ORDER BY .

SELECT  t.id, t.name, dbo.cleanInput (t.name) AS function_output
FROM dbo.MyTable AS t
ORDER BY function_output;

DML(데이터 조작 언어) 문에서 INSERT, UPDATE또는 DELETE:

SELECT t.id, t.name, dbo.cleanInput (t.name) AS function_output 
INTO dbo.MyTable_new
FROM dbo.MyTable AS t;

UPDATE t
SET t.mycolumn_new = dbo.cleanInput (t.name)
FROM dbo.MyTable AS t;

DELETE t
FROM dbo.MyTable AS t
WHERE dbo.cleanInput (t.name) ='myvalue';

관련 콘텐츠

• 스칼라 UDF 인라인 처리
• 패브릭 데이터 웨어하우스 마이그레이션 도우미

적용 대상:Azure Synapse AnalyticsAnalytics Platform System(PDW)

Azure Synapse Analytics 또는 PDW(Analytics Platform System)에서 UDF(사용자 정의 함수)를 만듭니다. 사용자 정의 함수는 매개 변수를 허용하고 복잡한 계산 등의 동작을 수행하며 해당 동작의 결과를 값으로 반환하는 Transact-SQL 루틴입니다. 사용자 정의 테이블 값 함수(TVF)는 테이블 데이터 형식을 반환합니다.

• 분석 플랫폼 시스템(PDW)에서 반환 값은 스칼라(단일) 값이어야 합니다.

• Azure Synapse Analytics CREATE FUNCTION 에서 인라인 테이블 반환 함수(미리 보기)의 구문을 사용하여 테이블을 반환하거나 스칼라 함수 구문을 사용하여 단일 값을 반환할 수 있습니다.

• Azure Synapse Analytics CREATE FUNCTION 의 서버리스 SQL 풀에서는 스칼라 함수가 아닌 인라인 테이블 값 함수를 만들 수 있습니다.

  이 문을 사용하여 다음과 같은 상황에서 다시 사용할 수 있는 루틴을 만들 수 있습니다.

• Transact-SQL 문에서 SELECT

• 함수를 호출하는 애플리케이션

• 다른 사용자 정의 함수의 정의

• 열에 CHECK 제약 조건 정의

• 저장 프로시저 바꾸기

• 인라인 함수를 보안 정책의 필터 조건자로 사용

Transact-SQL 구문 표기 규칙

구문

스칼라 함수 구문

-- Transact-SQL Scalar Function Syntax (in dedicated pools in Azure Synapse Analytics and Parallel Data Warehouse)
-- Not available in the serverless SQL pools in Azure Synapse Analytics

CREATE FUNCTION [ schema_name. ] function_name   
( [ { @parameter_name [ AS ] parameter_data_type   
    [ = default ] }   
    [ ,...n ]  
  ]  
)  
RETURNS return_data_type  
    [ WITH <function_option> [ ,...n ] ]  
    [ AS ]  
    BEGIN   
        function_body   
        RETURN scalar_expression  
    END  
[ ; ]  

<function_option>::=   
{  
    [ SCHEMABINDING ]  
  | [ RETURNS NULL ON NULL INPUT | CALLED ON NULL INPUT ]  
}  

인라인 테이블 반환 함수 구문

-- Transact-SQL Inline Table-Valued Function Syntax
-- Preview in dedicated SQL pools in Azure Synapse Analytics
-- Available in the serverless SQL pools in Azure Synapse Analytics
CREATE FUNCTION [ schema_name. ] function_name
( [ { @parameter_name [ AS ] parameter_data_type
    [ = default ] }
    [ ,...n ]
  ]
)
RETURNS TABLE
    [ WITH SCHEMABINDING ]
    [ AS ]
    RETURN [ ( ] select_stmt [ ) ]
[ ; ]

인수

schema_name

사용자 정의 함수가 속한 스키마의 이름입니다.

function_name

사용자 정의 함수의 이름입니다. 함수 이름은 식별자에 대한 규칙을 따라야 하며 데이터베이스에서 각 스키마별로 고유해야 합니다.

@ parameter_name

사용자 정의 함수(UDF)의 매개 변수입니다. 하나 이상의 매개 변수를 선언할 수 있습니다.

하나의 함수에 최대 2,100개의 매개 변수를 지정할 수 있습니다. 매개 변수에 기본값이 정의되지 않은 경우 함수를 실행할 때 사용자가 선언된 각 매개 변수의 값을 지정해야 합니다.

"at" 기호( @ )를 첫 번째 문자로 사용하여 매개 변수 이름을 지정하십시오. 매개 변수 이름은 식별자에 대한 규칙을 따라야 합니다. 매개 변수는 함수에서 로컬로 사용되므로 다른 함수에서 동일한 매개 변수 이름을 사용할 수 있습니다. 매개 변수는 상수 대신 사용할 수 있지만 테이블 이름, 열 이름 또는 다른 데이터베이스 개체의 이름 대신 사용할 수는 없습니다.

parameter_data_type

매개 변수 데이터 형식입니다. Transact-SQL 함수의 경우 Azure Synapse Analytics에서 지원되는 모든 스칼라 데이터 형식이 허용됩니다. 타임스탬프(rowversion) 데이터 형식은 지원되는 형식이 아닙니다.

[ = 기본값 ]

매개 변수의 기본값입니다. 기본 값이 정의되어 있으면 해당 매개 변수 값을 지정하지 않아도 함수를 실행할 수 있습니다.

함수의 매개 변수에 기본값을 지정한 경우 기본값을 가져오는 함수를 호출할 때 DEFAULT 키워드를 지정해야 합니다. 이 동작은 매개 변수를 생략할 경우 자동으로 기본값이 사용되는 저장 프로시저에서 기본값이 있는 매개 변수를 사용하는 것과는 다릅니다.

return_data_type

스칼라 사용자 정의 함수의 반환 값입니다. Transact-SQL 함수의 경우 Azure Synapse Analytics에서 지원되는 모든 스칼라 데이터 형식이 허용됩니다. rowversion/타임스탬프 데이터 형식은 지원되는 형식이 아닙니다. 커서 및 테이블 스칼라가 아닌 형식은 허용되지 않습니다.

function_body

일련의 TransactSQL 문입니다. function_body 문을 포함 SELECT 할 수 없으며 데이터베이스 데이터를 참조할 수 없습니다. function_body 테이블이나 뷰를 참조할 수 없습니다. 함수 본문은 다른 결정적인 함수를 호출할 수 있지만 비결정적 함수는 호출할 수 없습니다.

스칼라 함수에서 function_body는 함께 계산되어 스칼라 값을 반환하는 일련의 Transact-SQL 문입니다.

scalar_expression

스칼라 함수가 반환하는 스칼라 값을 지정합니다.

select_stmt

인라인 테이블 반환 함수의 반환 값을 정의하는 단일 SELECT 문입니다. 인라인 테이블 반환 함수의 경우 함수 본문이 없습니다. 테이블은 단일 SELECT 문의 결과 집합입니다.

테이블

TVF(테이블 반환 함수)의 반환 값이 테이블임을 지정합니다. 상수 및 @local_variables만 TVF에 전달할 수 있습니다.

인라인 TVF(미리 보기)에서 TABLE 반환 값은 단일 SELECT 문을 통해 정의됩니다. 인라인 함수에는 연관된 반환 변수가 없습니다.

<function_option>

함수에 다음 옵션 중 하나 이상이 있음을 지정합니다.

스키마바인딩

함수를 함수가 참조하는 데이터베이스 개체에 바인딩되도록 지정합니다. SCHEMABINDING을 지정하면 함수 정의에 영향을 미치는 방식으로 기본 개체를 수정할 수 없습니다. 함수 정의 자체를 먼저 수정하거나 삭제하여 수정할 개체에 대한 종속성을 제거해야 합니다.

다음 동작 중 하나만 발생해도 참조하는 개체에 대한 함수 바인딩이 제거됩니다.

• 함수가 삭제된 경우

• SCHEMABINDING 옵션을 지정하지 않은 상태에서 ALTER 문을 사용하여 함수를 수정한 경우

다음 조건을 만족하는 경우에만 함수가 스키마에 바인딩될 수 있습니다.

• 함수가 참조하는 사용자 정의 함수도 스키마에 바인딩됩니다.

• 함수가 참조하는 함수 및 다른 UDF 함수는 부분 또는 두 부분으로 이루어진 이름을 사용하여 참조됩니다.

• 기본 제공 함수 및 동일한 데이터베이스의 다른 UDF만 UDF의 본문 내에서 참조할 수 있습니다.

• 문을 실행한 CREATE FUNCTION 사용자에게 함수가 참조하는 데이터베이스 개체에 대한 REFERENCES 권한이 있습니다.

SCHEMABINDING을 ALTER제거하려면 .

NULL 입력에서 NULL 반환 | NULL 입력에서 호출

스칼라 반환 함수의 특성을 지정 OnNULLCall 합니다. 지정 CALLED ON NULL INPUT 하지 않으면 기본적으로 암시되며 함수 본문은 인수로 전달되더라도 NULL 실행됩니다.

모범 사례

SCHEMABINDING 절을 사용하여 사용자 정의 함수를 만들지 않은 경우 기본 개체에 대한 변경 내용이 함수의 정의에 영향을 주어 함수가 호출될 대 예기치 않은 결과를 초래할 수 있습니다. 함수를 만들 때 절을 WITH SCHEMABINDING 지정하는 것이 좋습니다. 이렇게 하면 함수도 수정되지 않는 한 함수 정의에서 참조된 개체를 수정할 수 없습니다.

상호 운용성

스칼라 반환 함수에서 유효한 문은 다음과 같습니다.

• 대입 문

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

• 로컬 데이터 변수를 정의하는 DECLARE 문

인라인 테이블 반환 함수(미리 보기)에서는 단일 select 문만 사용할 수 있습니다.

제한 사항

사용자 정의 함수는 데이터베이스 상태 수정 동작을 수행하는 데 사용할 수 없습니다.

사용자 정의 함수는 중첩될 수 있습니다. 즉, 하나의 사용자 정의 함수가 다른 사용자 정의 함수를 호출할 수 있습니다. 중첩 수준은 호출된 함수의 실행이 시작되면 늘어나고 호출된 함수의 실행이 끝나면 줄어듭니다. 최대 중첩 수준을 초과하면 전체 함수 호출 체인이 실패합니다. Microsoft Fabric Data Warehouse에서 사용자 정의 함수는 최대 5개 수준으로 중첩될 수 있습니다.

함수를 포함한 개체는 Azure Synapse Analytics의 서버리스 SQL 풀 데이터베이스에 만들 master 수 없습니다.

메타데이터

이 섹션에서는 사용자 정의 함수에 대한 메타데이터를 반환하는 데 사용할 수 있는 시스템 카탈로그 뷰를 나열합니다.

• sys.sql_modules: Transact-SQL 사용자 정의 함수의 정의를 표시합니다. 예를 들면 다음과 같습니다.

  SELECT definition, type   
  FROM sys.sql_modules AS m  
  JOIN sys.objects AS o   
      ON m.object_id = o.object_id   
      AND type = ('FN');
  

• sys.parameters: 사용자 정의 함수에 정의된 매개 변수에 대한 정보를 표시합니다.

• sys.sql_expression_dependencies: 함수에서 참조하는 기본 개체를 표시합니다.

사용 권한

데이터베이스에 대한 CREATE FUNCTION 권한과 함수가 생성되는 스키마에 대한 ALTER 권한이 필요합니다.

예시

A. 스칼라 반환 사용자 정의 함수를 사용하여 데이터 형식 변경

이 간단한 함수는 int 데이터 형식을 입력으로 사용하며 decimal(10,2) 데이터 형식으로 출력으로 반환합니다.

CREATE FUNCTION dbo.ConvertInput (@MyValueIn int)  
RETURNS decimal(10,2)  
AS  
BEGIN
    DECLARE @MyValueOut int;  
    SET @MyValueOut= CAST( @MyValueIn AS decimal(10,2));  
    RETURN(@MyValueOut);  
END;  
GO  

SELECT dbo.ConvertInput(15) AS 'ConvertedValue';  

B. 인라인 테이블 반환 함수 만들기

다음 예제에서는 objectType 매개 변수를 기준으로 필터링하여 모듈에 대한 일부 키 정보를 반환하는 인라인 테이블 반환 함수를 만듭니다. 매개 변수를 사용하여 함수를 호출할 때 모든 모듈을 반환하는 기본값이 DEFAULT 포함됩니다. 이 예제에서는 메타데이터에 설명된 일부 시스템 카탈로그 뷰를 사용합니다.

CREATE FUNCTION dbo.ModulesByType(@objectType CHAR(2) = '%%')
RETURNS TABLE
AS
RETURN
(
    SELECT 
        sm.object_id AS 'Object Id',
        o.create_date AS 'Date Created',
        OBJECT_NAME(sm.object_id) AS 'Name',
        o.type AS 'Type',
        o.type_desc AS 'Type Description', 
        sm.definition AS 'Module Description'
    FROM sys.sql_modules AS sm  
    JOIN sys.objects AS o ON sm.object_id = o.object_id
    WHERE o.type like '%' + @objectType + '%'
);
GO

그런 다음 함수를 호출하여 다음을 사용하여 모든 뷰(V) 개체를 반환할 수 있습니다.

select * from dbo.ModulesByType('V');

C. 인라인 테이블 반환 함수의 결과 결합

이 간단한 예제에서는 이전에 만든 인라인 TVF에서 cross apply를 사용하여 결과를 다른 테이블과 결합할 수 있는 방법을 보여 줍니다. 여기서는 열에서 일치하는 type 모든 행의 결과와 둘 다 sys.objects 에서 ModulesByType 모든 열을 선택합니다. apply 사용에 대한 자세한 내용은 FROM 절과 JOIN, APPLY, PIVOT(Transact-SQL)를 참조하세요.

SELECT * 
FROM sys.objects o
CROSS APPLY dbo.ModulesByType(o.type);
GO

다음 단계