다음을 통해 공유


Queries - List By Database

데이터베이스별 상위 쿼리 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/topQueries?api-version=2014-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
databaseName
path True

string

데이터베이스의 이름입니다.

resourceGroupName
path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

TopQueriesListResult

정상

예제

List top queries

샘플 요청

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/sqlcrudtest/databases/db1/topQueries?api-version=2014-04-01

샘플 응답

{
  "value": [
    {
      "type": "Microsoft.Sql/servers/databases/topQueries",
      "numberOfTopQueries": 1,
      "aggregationFunction": "sum",
      "executionType": "any",
      "observedMetric": "cpu",
      "observationStartTime": "2017-07-11T16:21:54.0916567Z",
      "observationEndTime": "2017-07-12T16:21:54.0916567Z",
      "intervalType": "PT1H",
      "queries": [
        {
          "queryId": "19",
          "intervals": [
            {
              "intervalStartTime": "2017-07-11T16:00:00",
              "executionCount": 12,
              "metrics": [
                {
                  "name": "cpu",
                  "displayName": "Cpu",
                  "unit": "percentage",
                  "value": 0.000763888888888889
                },
                {
                  "name": "io",
                  "displayName": "Physical Io Reads",
                  "unit": "percentage",
                  "value": 0
                },
                {
                  "name": "logIo",
                  "displayName": "Log Writes",
                  "unit": "percentage",
                  "value": 0
                },
                {
                  "name": "memory",
                  "displayName": "Memory consumption",
                  "unit": "KB",
                  "value": 0
                },
                {
                  "name": "duration",
                  "displayName": "Query duration",
                  "unit": "microseconds",
                  "value": 3308
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

정의

Name Description
QueryAggregationFunction

각 쿼리의 메트릭을 집계하는 데 사용되는 함수입니다.

QueryExecutionType

반환되는 쿼리 인스턴스를 필터링하는 데 사용되는 실행 형식입니다.

QueryInterval

데이터베이스 쿼리입니다.

QueryMetric

데이터베이스 쿼리입니다.

QueryMetricUnit

측정 단위

QueryObservedMetricType

상위 메트릭을 정렬하는 데 사용할 메트릭의 유형입니다.

QueryStatistic

데이터베이스 쿼리입니다.

TopQueries

데이터베이스 쿼리입니다.

TopQueriesListResult

상위 쿼리 가져오기 요청에 대한 응답을 나타냅니다.

QueryAggregationFunction

각 쿼리의 메트릭을 집계하는 데 사용되는 함수입니다.

Name 형식 Description
avg

string

max

string

min

string

sum

string

QueryExecutionType

반환되는 쿼리 인스턴스를 필터링하는 데 사용되는 실행 형식입니다.

Name 형식 Description
aborted

string

any

string

exception

string

irregular

string

regular

string

QueryInterval

데이터베이스 쿼리입니다.

Name 형식 Description
executionCount

number

이 간격 동안 쿼리가 실행된 횟수입니다.

intervalStartTime

string

측정 간격의 시작 시간(ISO8601 형식)입니다.

metrics

QueryMetric[]

이 간격 동안의 쿼리 메트릭 목록입니다.

QueryMetric

데이터베이스 쿼리입니다.

Name 형식 Description
displayName

string

사용자 인터페이스에 표시할 메트릭의 이름

name

string

메트릭의 이름

unit

QueryMetricUnit

측정 단위

value

number

측정된 값

QueryMetricUnit

측정 단위

Name 형식 Description
KB

string

microseconds

string

percentage

string

QueryObservedMetricType

상위 메트릭을 정렬하는 데 사용할 메트릭의 유형입니다.

Name 형식 Description
cpu

string

duration

string

executionCount

string

io

string

logio

string

QueryStatistic

데이터베이스 쿼리입니다.

Name 형식 Description
intervals

QueryInterval[]

쿼리 간격 목록입니다.

queryId

string

쿼리의 ID

TopQueries

데이터베이스 쿼리입니다.

Name 형식 Description
aggregationFunction

QueryAggregationFunction

각 쿼리의 메트릭을 집계하는 데 사용되는 함수입니다.

executionType

QueryExecutionType

반환되는 쿼리 인스턴스를 필터링하는 데 사용되는 실행 형식입니다.

intervalType

string

간격의 기간(ISO8601 기간 형식)입니다.

numberOfTopQueries

number

요청된 쿼리 수입니다.

observationEndTime

string

반환되는 쿼리의 종료 시간(ISO8601 형식)

observationStartTime

string

반환되는 쿼리의 시작 시간(ISO8601 형식)

observedMetric

QueryObservedMetricType

상위 메트릭을 정렬하는 데 사용할 메트릭의 유형입니다.

queries

QueryStatistic[]

쿼리 목록입니다.

TopQueriesListResult

상위 쿼리 가져오기 요청에 대한 응답을 나타냅니다.

Name 형식 Description
value

TopQueries[]

상위 쿼리 목록입니다.