지원되는 OData 함수 및 절

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

이 문서에서는 Analytics에서 여러 OData 함수를 지원하는 방법을 설명합니다. 지원되지 않는 함수도 나열됩니다. OData(Open Data Protocol)는 REST API를 빌드하고 사용하는 모범 사례를 정의하는 ISO/IEC 승인 OASIS 표준입니다. 자세한 내용은 OData 설명서를 참조 하세요.

참고 항목

Analytics 서비스는 모든 Azure DevOps Services에 대해 프로덕션에서 자동으로 사용하도록 설정되고 지원됩니다. Analytics Service의 OData 피드에 대한 Power BI 통합 및 액세스는 일반적으로 사용할 수 있습니다. 이를 사용하고 피드백을 제공하는 것이 좋습니다. 사용 가능한 데이터는 버전에 따라 다릅니다. 지원되는 최신 버전은 v2.0최신 미리 보기 버전입니다 v4.0-preview. 자세한 내용은 OData API 버전 관리를 참조 하세요.

지원되는 절

• $apply
• $compute
• $count
• $expand
• $filter
• $orderby
• $select
• $skip
• $top

쿼리에 여러 절이 사용되는 경우 위에서 지정한 순서대로 적용됩니다. 쿼리 문자열의 절 순서는 무시됩니다. 예를 들어 다음 쿼리에서 작업 항목은 먼저 그룹화되고 집계됩니다. 다음으로, 그룹이 필터링됩니다. 그런 다음 필터링된 그룹이 정렬됩니다. 마지막으로 처음 5개의 레코드가 반환됩니다. 쿼리는 100번 이상 사용된 상위 5개 작업 항목 유형을 반환합니다.

WorkItems?$filter=Count ge 100&$apply=groupby((WorkItemType), aggregate($count as Count))&$orderby=Count&top=5

집계 확장 지원

연속적으로 적용됨을 나타내려면 슬래시로 구분된 집합 변환 시퀀스가 필요합니다. 각 변환의 결과는 다음 변환에 대한 입력입니다. 예를 들어 다음 쿼리에서 작업 항목은 필터링된 다음 작업 항목 유형 및 상태에 따라 그룹화됩니다. 다음으로 그룹을 필터링하고 다시 그룹화합니다.

참고 항목

OData 집계 확장은 비교적 새로운 기능이며 일부 클라이언트 도구에서 아직 완전히 지원되지 않습니다.

Workitems?$apply=filter(State ne 'Closed')/groupby((WorkItemType, State), aggregate($count as Count))/filter(Count gt 100)/groupby((State),aggregate(Count with max as MaxCount))  

지원되는 변환은 다음과 같습니다.

변환	주의
aggregate	다음 방법 중 하나를 사용하여 집계를 허용합니다.$countaveragemaxminsum
compute	계산된 속성을 추가할 수 있습니다.
expand	지정된 속성으로 확장 허용
filter	입력 집합 필터링을 허용합니다. 와 동일한 식을 지원합니다. $filter
groupby	속성별로 그룹화 허용

자세한 내용은 집계 작업 추적 데이터를 참조 하세요.

지원되는 함수

정식 함수	설명
cast	지정된 형식으로 캐스팅된 현재 인스턴스의 식을 반환합니다.
contains	두 번째 매개 변수 문자열 값이 첫 번째 매개 변수 문자열 값의 부분 문자열이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
endswith	첫 번째 매개 변수 문자열 값이 두 번째 매개 변수 문자열 값으로 끝나면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
startswith	첫 번째 매개 변수 문자열 값이 두 번째 매개 변수 문자열 값으로 시작되면 true를 반환하고, 그렇지 않으면 false를 반환합니다.
length	매개 변수 값의 문자 수를 반환합니다.
indexof	첫 번째 매개 변수 값에서 두 번째 매개 변수 값이 처음 나타나는 0부터 시작하는 문자 위치를 반환하고, 첫 번째 매개 변수 값에서 두 번째 매개 변수 값이 발생하지 않으면 -1을 반환합니다.
substring	N번째 문자에서 시작하여 마지막 문자(여기서 N은 두 번째 매개 변수 정수 값)로 끝나는 첫 번째 매개 변수 문자열 값의 부분 문자열을 반환합니다.
tolower	모든 대문자가 소문자로 변환된 입력 매개 변수 문자열 값을 반환합니다.
toupper	모든 소문자가 대문자로 변환된 입력 매개 변수 문자열 값을 반환합니다.
trim	모든 선행 및 후행 공백 문자가 있는 입력 매개 변수 문자열 값을 반환합니다.
year	Date 또는 DateTimeOffset 매개 변수 값의 연도 구성 요소를 반환합니다.
month	Date 또는 DateTimeOffset 매개 변수 값의 월 구성 요소를 반환합니다.
day	Date 또는 DateTimeOffset 매개 변수 값의 일 구성 요소를 반환합니다.
date	DateTimeOffset 매개 변수 값의 날짜 부분을 반환합니다.
time	DateTimeOffset 매개 변수 값의 시간 부분을 반환합니다.
totaloffsetminutes	DateTimeOffset 매개 변수 값의 표준 시간대 오프셋 부분에서 부호 있는 분 수를 반환합니다.
now	현재 지정 시간(표준 시간대가 있는 날짜 및 시간)을 DateTimeOffset 값으로 반환합니다.
maxdatetime	가능한 최신 시점을 DateTimeOffset 값으로 반환합니다.
mindatetime	가능한 가장 빠른 시점을 DateTimeOffset 값으로 반환합니다.

OData 함수는 절에 $filter 사용되지만 절에서는 $select SQL 문에서 사용되는 방식이 아닙니다.

예를 들어 다음을 지정할 수 있습니다.

/WorkItems?$filter=toupper(Title) eq 'HELP' 

그러나 다음 문자열은 입력할 수 없습니다.

/WorkItems?$select=WorkItemId,State,toupper(Title)

지원되지 않는 기능

• bottomcount
• bottomsum
• bottompercent
• $crossjoin
• concat
• countdistinct
• from
• isdefined
• $rollup
• $search
• topcount
• topsum
• toppercent

관련된 문서

• 작업 추적 데이터 쿼리
• 데이터 집계
• OData v4.0 사양
• OData v4.0 Part 2: URL Conventions Plus Errata 02
• OData v4.0 집계 확장