참조 설명서에 대한 구문 규칙

  • 아티클

이 문서에서는 Kusto 쿼리 언어(KQL) 및 관리 명령 참조 설명서에 이어지는 구문 규칙을 간략하게 설명합니다.

구문 표기 규칙

규칙 Description
Block 표시된 대로 정확하게 입력할 문자열 리터럴입니다.
기울임꼴 함수 또는 명령을 사용할 때 값을 제공할 매개 변수입니다.
[ ] 묶은 항목이 선택 사항임을 표시합니다.
( ) 묶은 항목 중 하나 이상이 필요하다는 것을 표시합니다.
| (파이프) 대괄호 또는 둥근 대괄호 내에서 파이프 문자로 구분된 항목 중 하나를 지정할 수 있음을 나타내는 데 사용됩니다. 이 형식에서 파이프는 논리 OR 연산자에 해당합니다. 블록(|)에 있는 경우 파이프는 KQL 쿼리 구문의 일부입니다.
[, ...] 앞의 매개 변수를 쉼표로 구분하여 여러 번 반복할 수 있음을 나타냅니다.
; 쿼리 문 종결자입니다.

예제

스칼라 함수

이 예제에서는 구문과 해시 함수의 사용 예제를 보여 줍니다. 그 다음 각 구문 구성 요소가 예제 사용법으로 변환되는 방법에 대한 설명이 뒤따릅니다.

Syntax

hash(source [,mod])

사용 예

hash("World")
  • 함수의 이름, hash및 여는 괄호는 표시된 대로 정확하게 입력됩니다.
  • "World"는 필수 소스 매개 변수에 대한 인수로 전달됩니다.
  • 대괄호로 표시된 대로 선택 사항인 mod 매개 변수에 대해 인수가 전달되지 않습니다.
  • 닫는 괄호는 표시된 대로 정확하게 입력됩니다.

테이블 형식 연산자

이 예제에서는 구문과 정렬 연산자의 사용 예제를 보여 줍니다. 그런 다음 각 구문 구성 요소가 예제 사용법으로 변환되는 방법에 대한 설명을 보여 줍니다.

Syntax

T| sort bycolumn [asc | desc] [nulls first | nulls last] [, ...]

사용 예

StormEvents
| sort by State asc, StartTime desc
  • StormEvents 테이블은 필요한 T 매개 변수에 대한 인수로 전달됩니다.
  • | sort by 은 표시된 대로 정확하게 입력됩니다. 이 경우 파이프 문자는 블록 텍스트로 표시되는 테이블 형식 식 문 구문의 일부입니다. 자세한 내용은 쿼리 문란?을 참조하세요.
  • 상태 열은 선택적 asc 플래그가 있는 필수 열 매개 변수에 대한 인수로 전달됩니다.
  • 쉼표 다음에는 선택적 desc 플래그가 있는 StartTime 열이라는 다른 인수 집합이 전달됩니다. [, ...] 구문은 더 많은 인수 집합이 전달될 수 있지만 필요하지 않음을 나타냅니다.

선택적 매개 변수 작업

다른 선택적 매개 변수 다음에 오는 선택적 매개 변수에 대한 인수를 제공하려면 이전 매개 변수에 대한 인수를 제공해야 합니다. 이 요구 사항은 인수가 구문에 지정된 순서를 따라야 하기 때문입니다. 매개 변수에 전달할 특정 값이 없는 경우 동일한 형식의 빈 값을 사용합니다.

순차적 선택적 매개 변수의 예

http_request 플러그 인의 구문을 고려합니다.

evaluatehttp_request(Uri [,RequestHeaders [,옵션]] )

RequestHeaders 및 Options 는 동적 형식의 선택적 매개 변수입니다. Options 매개 변수에 대한 인수를 제공하려면 RequestHeaders 매개 변수에 대한 인수도 제공해야 합니다. 다음 예제에서는 두 번째 선택적 매개 변수인 Options에 대한 값을 지정할 수 있도록 첫 번째 선택적 매개 변수인 RequestHeaders에 빈 값을 제공하는 방법을 보여 있습니다.

evaluate http_request ( "https://contoso.com/", dynamic({}), dynamic({ EmployeeName: Nicole }) )

관련 콘텐츠