.create function 명령

적용 대상: ✅Microsoft Fabric ✅Azure Data Explorer

지정된 이름을 사용하여 재사용 가능한 KQL 쿼리인 저장된 함수를 만듭니다. 함수 정의는 데이터베이스 메타데이터와 함께 유지됩니다.

함수는 다른 함수를 호출할 수 있습니다(재귀성은 지원되지 않음). let 또한 문은 함수 본문의 일부로 허용됩니다. 문을 참조 let 하세요.

매개 변수 형식 및 CSL 문에 대한 규칙은 문과 동일합니다let.

사용 권한

이 명령을 실행하려면 데이터베이스 사용자 이상의 권한이 있어야 합니다.

.createfunction [ ifnotexists ] [ with (propertyName = propertyValue [, ...]) ] functionName( 매개 변수 {)본문 }

이름	Type	필수	설명
`ifnotexists`	`string`		지정한 경우 함수가 아직 없는 경우에만 함수가 만들어집니다.
functionName	`string`	✔️	만들거나 변경할 함수의 이름입니다.
propertyName, propertyValue	`string`		키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.
parameters	`string`		함수에 필요한 매개 변수의 쉼표로 구분된 목록입니다. 각 매개 변수의 형식은 ParameterName`:`ParameterDataType이어야 합니다.
body	`string`	✔️	사용자 정의 함수 식입니다.

속성	형식	설명
`docstring`	`string`	UI용 함수에 대한 설명입니다.
`folder`	`string`	UI 함수 분류에 사용되는 폴더의 이름입니다.
`view`	`bool`	이 함수를 저장된 보기로 지정합니다. 저장된 뷰는 검색 및 공용 구조체 * 시나리오에 참여할 수 있습니다. 자세한 내용은 보기를 참조 하세요.
`skipvalidation`	`bool`	함수에 대한 유효성 검사 논리를 실행할지 여부를 결정하고 함수가 유효하지 않은 경우 프로세스를 실패합니다. 기본값은 `false`입니다.

팁

출력 매개 변수	Type	Description
이름	`string`	함수의 이름.
매개 변수	`string`	함수에 필요한 매개 변수입니다.
본문	`string`	(0개 이상) `let` 문 다음에 함수 호출 시 평가되는 유효한 CSL 식이 잇습니다.
폴더	`string`	UI 함수 분류에 사용되는 폴더입니다. 이 매개 변수는 함수가 호출되는 방식을 변경하지 않습니다.
DocString	`string`	UI용 함수에 대한 설명입니다.

참고 항목

함수가 이미 있는 경우:
- 기존 함수를 변경하려면 다음을 참조하세요. .alter function
문에서 let 모든 데이터 형식이 지원되는 것은 아닙니다. 지원되는 형식은 부울, 문자열, long, datetime, timespan, double 및 dynamic입니다.
함수의 의미 체계 유효성 검사를 건너뛰는 데 사용합니다 skipvalidation . 이는 함수가 잘못된 순서로 생성되고 F2를 사용하는 F1이 이전에 만들어지는 경우에 유용합니다.

다음 예제에서는 설명(docstring), 폴더를 Demo사용하여 함수를 만들고 MyFunction1 함수를 정의합니다.

.create function 
with (docstring = 'Simple demo function', folder='Demo')
MyFunction1()
{StormEvents | take 100}

Name	매개 변수	본문	폴더	DocString
MyFunction1	()	{StormEvents \| take 100}	데모	간단한 데모 함수

다음 예제에서는 설명(docstring), 폴더 이름이 지정된 DemoMyFunction2 함수를 만들고 매개 변수를 MyLimit 정의합니다.

.create function
with (docstring = 'Demo function with parameter', folder='Demo')
 MyFunction2(myLimit: long)
{StormEvents | take myLimit}

Name	매개 변수	본문	폴더	DocString
MyFunction2	(myLimit:long)	{StormEvents \| take myLimit}	데모	매개 변수가 있는 데모 함수