다음을 통해 공유

.create-or-alter function 명령

  • 아티클

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

저장된 함수를 만들거나 기존 함수를 변경하여 데이터베이스 메타데이터 내에 저장합니다.

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

사용 권한

이 명령을 사용하려면 새 함수를 만들기 위한 데이터베이스 사용자 권한과 기존 함수를 변경하기 위한 함수 관리자 권한이 필요합니다.

구문

.create-or-alterfunction [ with (propertyName = propertyValue [, ...])] functionName( 매개 변수 {)본문 }

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

매개 변수

이름 Type 필수 설명
functionName string ✔️ 만들거나 변경할 함수의 이름입니다.
propertyName, propertyValue string 키-값 속성 쌍의 쉼표로 구분된 목록입니다. 지원되는 속성을 참조하세요.
parameters string 함수에 필요한 매개 변수의 쉼표로 구분된 목록입니다. 각 매개 변수의 형식은 ParameterName:ParameterDataType이어야 합니다.
body string ✔️ 0개 이상의 let 문 뒤에 함수 호출 시 평가되는 유효한 CSL 식이 잇습니다.

참고 항목

데이터베이스 메타데이터에 제공된 functionName 이 없으신 경우에 명령은 새로운 함수를 만들게 됩니다. 그렇지 않으면 해당 함수가 변경됩니다.

지원되는 속성

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

예시

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

.create-or-alter function with (docstring = 'Demo function with parameter', folder='MyFolder')
TestFunction(myLimit:int)
{ StormEvents | take myLimit}

출력

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