다음을 통해 공유

.create function 명령

  • 아티클

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

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

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

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

사용 권한

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

구문

.create function [ ifnotexists ] [ with(propertyName=propertyValue [, ...]) ] functionName(본문)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

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

지원되는 속성

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

팁

함수에 클러스터 간 쿼리가 포함되고 Kusto 쿼리 언어 스크립트를 사용하여 함수를 다시 만들려는 경우 />skipvalidation로 설정합니다true.

반품

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

참고 항목

예제

단순 함수

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

.create function 
with (docstring = 'Simple demo function', folder='Demo')
MyFunction1()
{StormEvents | take 100}
이름 매개 변수 본문 폴더 DocString
MyFunction1 () {StormEvents | take 100} 데모 간단한 데모 함수

매개 변수가 있는 함수

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

.create function with (docstring = "Demo function with date parameter",folder = "Demo") 
 MyFunction2(Mytimestamp:datetime) {
    StormEvents
    | where EndTime <= Mytimestamp
 }
이름 매개 변수 본문 폴더 DocString
MyFunction2 (Mytimestamp:datetime) {StormEvents | where EndTime <= Mytimestamp} 데모 날짜 매개 변수가 있는 데모 함수

관련 콘텐츠

  • .create-or-alter 함수