Database Advisors - Get

데이터베이스 관리자를 가져옵니다.

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

URI 매개 변수

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

string

데이터베이스 관리자의 이름입니다.

databaseName
path True

string

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

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

Advisor

Azure 운영이 성공적으로 완료되었습니다.

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Get database advisor

샘플 요청

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex?api-version=2025-01-01

샘플 응답

{
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/databases/advisors",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "lastChecked": "2017-06-20T00:24:39Z",
    "recommendationsStatus": "Ok"
  }
}

정의

Name Description
Advisor

데이터베이스, 서버 또는 탄력적 풀 관리자입니다.

AdvisorStatus

고객에게 이 관리자의 가용성 상태를 가져옵니다. 가능한 값은 'GA', 'PublicPreview', 'LimitedPublicPreview' 및 'PrivatePreview'입니다.

AutoExecuteStatus

이 관리자의 자동 실행 상태(시스템이 권장 사항을 실행할 수 있도록 할지 여부)를 가져옵니다. 가능한 값은 'Enabled' 및 'Disabled'입니다.

AutoExecuteStatusInheritedFrom

자동 실행 상태의 현재 값이 상속되는 리소스를 가져옵니다. 리소스 계층 구조의 여러 수준에서 자동 실행 상태를 설정하고 상속할 수 있습니다. 가능한 값은 'Subscription', 'Server', 'ElasticPool', 'Database' 및 'Default'입니다(상태가 어떤 수준에서도 명시적으로 설정되지 않은 경우).

createdByType

리소스를 만든 ID의 형식입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

ImplementationMethod

이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell.

IsRetryable

오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다.

RecommendedAction

데이터베이스, 서버 또는 탄력적 풀 권장 작업입니다.

RecommendedActionCurrentState

권장되는 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되고 실행을 기다리고 있습니다. 실행 중 -> 권장 작업이 사용자 데이터베이스에 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 해당 유용성을 확인합니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인에서 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 위해 권장 작업이 대기 중이거나 사용자가 수동으로 되돌렸습니다. 되돌리기 - 권장 작업을 적용하는 동안 수행된> 변경 내용이 사용자 데이터베이스에서 되돌리고 있습니다. 되돌리기 -> 사용자 데이터베이스에 대한 권장 작업으로 변경한 내용을 성공적으로 되돌려 줍니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다.

RecommendedActionErrorInfo

Azure SQL Database, 서버 또는 Elastic 풀 권장 행동에 대한 오류 정보를 포함합니다.

RecommendedActionImpactRecord

Azure SQL Database, 서버 또는 탄력적 풀 권장 조치에 대한 다양한 지표에 대한 추정 또는 관찰된 영향 정보를 포함합니다.

RecommendedActionImplementationInfo

Azure SQL Database, Server 또는 Elastic Pool 권장 행동에 대한 수동 구현 정보를 포함하고 있습니다.

RecommendedActionInitiatedBy

이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.

RecommendedActionMetricInfo

Azure SQL Database, 서버 또는 Elastic Pool 권장 조치에 대한 다양한 영향 지표의 시계열 데이터를 포함합니다.

RecommendedActionStateInfo

Azure SQL Database, 서버 또는 Elastic Pool 권장 조치의 현재 상태 정보를 포함합니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Advisor

데이터베이스, 서버 또는 탄력적 풀 관리자입니다.

Name 형식 Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

리소스 종류입니다.

location

string

리소스 위치입니다.

name

string

리소스의 이름

properties.advisorStatus

AdvisorStatus

고객에게 이 관리자의 가용성 상태를 가져옵니다. 가능한 값은 'GA', 'PublicPreview', 'LimitedPublicPreview' 및 'PrivatePreview'입니다.

properties.autoExecuteStatus

AutoExecuteStatus

이 관리자의 자동 실행 상태(시스템이 권장 사항을 실행할 수 있도록 할지 여부)를 가져옵니다. 가능한 값은 'Enabled' 및 'Disabled'입니다.

properties.autoExecuteStatusInheritedFrom

AutoExecuteStatusInheritedFrom

자동 실행 상태의 현재 값이 상속되는 리소스를 가져옵니다. 리소스 계층 구조의 여러 수준에서 자동 실행 상태를 설정하고 상속할 수 있습니다. 가능한 값은 'Subscription', 'Server', 'ElasticPool', 'Database' 및 'Default'입니다(상태가 어떤 수준에서도 명시적으로 설정되지 않은 경우).

properties.lastChecked

string (date-time)

이 관리자가 현재 리소스를 분석하여 권장 사항을 분석한 시간을 가져옵니다.

properties.recommendationsStatus

string

이 관리자에 대한 권장 사항의 상태와 권장 사항이 없는 이유를 가져옵니다. 가능한 값에는 '확인'(사용 가능한 권장 사항), LowActivity(분석할 워크로드가 충분하지 않음), 'DbSeemsTuned'(데이터베이스가 잘 작동 중) 등이 있습니다.

properties.recommendedActions

RecommendedAction[]

이 관리자에 대한 권장 작업을 가져옵니다.

systemData

systemData

Azure Resource Manager 메타데이터에 createdBy 및 modifiedBy 정보가 포함되어 있습니다.

type

string

리소스의 형식입니다. 예를 들어, "Microsoft. 컴퓨트/가상 머신" 또는 "Microsoft." 저장소/저장소 계정"

AdvisorStatus

고객에게 이 관리자의 가용성 상태를 가져옵니다. 가능한 값은 'GA', 'PublicPreview', 'LimitedPublicPreview' 및 'PrivatePreview'입니다.

값 Description
GA

GA

PublicPreview

PublicPreview

LimitedPublicPreview

한정 공개 미리보기

PrivatePreview

PrivatePreview

AutoExecuteStatus

이 관리자의 자동 실행 상태(시스템이 권장 사항을 실행할 수 있도록 할지 여부)를 가져옵니다. 가능한 값은 'Enabled' 및 'Disabled'입니다.

값 Description
Enabled

활성화됨

Disabled

비활성화

Default

기본값

AutoExecuteStatusInheritedFrom

자동 실행 상태의 현재 값이 상속되는 리소스를 가져옵니다. 리소스 계층 구조의 여러 수준에서 자동 실행 상태를 설정하고 상속할 수 있습니다. 가능한 값은 'Subscription', 'Server', 'ElasticPool', 'Database' 및 'Default'입니다(상태가 어떤 수준에서도 명시적으로 설정되지 않은 경우).

값 Description
Default

기본값

Subscription

Subscription

Server

서버

ElasticPool

엘라스틱풀

Database

데이터베이스

createdByType

리소스를 만든 ID의 형식입니다.

값 Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ImplementationMethod

이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell.

값 Description
TSql

TSql

AzurePowerShell

AzurePowerShell

IsRetryable

오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다.

값 Description
Yes

예

No

No

RecommendedAction

데이터베이스, 서버 또는 탄력적 풀 권장 작업입니다.

Name 형식 Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

kind

string

리소스 종류입니다.

location

string

리소스 위치입니다.

name

string

리소스의 이름

properties.details

object

이 권장 작업과 관련된 추가 세부 정보를 가져옵니다.

properties.errorDetails

RecommendedActionErrorInfo

이 권장 작업이 오류 상태에 놓이는 경우 및 그 이유에 대한 오류 세부 정보를 가져옵니다.

properties.estimatedImpact

RecommendedActionImpactRecord[]

이 권장 작업에 대한 예상 영향 정보(예: 예상 CPU 증가, 예상 디스크 공간 변경)를 가져옵니다.

properties.executeActionDuration

string (duration)

사용자 리소스에 이 권장 작업을 적용하는 데 걸린 시간을 가져옵니다. 예를 들어 인덱스 생성에 소요된 시간

properties.executeActionInitiatedBy

RecommendedActionInitiatedBy

이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.

properties.executeActionInitiatedTime

string (date-time)

이 권장 작업이 실행을 위해 승인된 시간을 가져옵니다.

properties.executeActionStartTime

string (date-time)

시스템이 사용자 리소스에 이 권장 작업을 적용하기 시작한 시간을 가져옵니다. 예: 인덱스 만들기 시작 시간

properties.implementationDetails

RecommendedActionImplementationInfo

사용자가 수동으로 적용할 수 있도록 이 권장 작업의 구현 세부 정보를 가져옵니다.

properties.isArchivedAction

boolean

이 권장 작업이 얼마 전에 제안되었지만 사용자가 이를 무시하도록 선택했고 시스템에서 새 권장 작업을 다시 추가했는지를 가져옵니다.

properties.isExecutableAction

boolean

사용자가 이 권장 작업을 수행할 수 있는지를 가져옵니다.

properties.isRevertableAction

boolean

이 권장 작업에 의해 적용된 변경 내용을 사용자가 되돌릴 수 있는지를 가져옵니다.

properties.lastRefresh

string (date-time)

이 권장 작업을 마지막으로 새로 고친 시간을 가져옵니다.

properties.linkedObjects

string[]

연결된 개체(있는 경우)를 가져옵니다.

properties.observedImpact

RecommendedActionImpactRecord[]

이 권장 작업에 대한 관찰된/실제 영향 정보(예: 실제 CPU 게인, 실제 디스크 공간 변경)를 가져옵니다.

properties.recommendationReason

string

이 작업을 권장하는 이유를 가져옵니다. 예: DuplicateIndex

properties.revertActionDuration

string (duration)

사용자 리소스에서 이 권장 작업의 변경 내용을 되돌리는 데 걸린 시간을 가져옵니다. 예를 들어 생성된 인덱스 삭제에 소요된 시간입니다.

properties.revertActionInitiatedBy

RecommendedActionInitiatedBy

이 권장 작업을 되돌리기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.

properties.revertActionInitiatedTime

string (date-time)

이 권장 작업이 되돌리기 위해 승인된 시간을 가져옵니다.

properties.revertActionStartTime

string (date-time)

시스템이 사용자 리소스에서 이 권장 작업의 변경 내용을 되돌리기 시작한 시간을 가져옵니다. 예를 들어 인덱스 삭제가 실행되는 시간입니다.

properties.score

integer (int32)

이 권장 작업의 영향을 가져옵니다. 가능한 값은 1 - 낮은 영향, 2 - 중간 영향 및 3 - 높은 영향

properties.state

RecommendedActionStateInfo

권장 작업이 있는 현재 상태의 정보를 가져옵니다.

properties.timeSeries

RecommendedActionMetricInfo[]

이 권장 작업에 대한 메트릭의 시계열 정보(예: CPU 사용량 시계열)를 가져옵니다.

properties.validSince

string (date-time)

이 권장 작업이 유효한 시점 이후의 시간을 가져옵니다.

systemData

systemData

Azure Resource Manager 메타데이터에 createdBy 및 modifiedBy 정보가 포함되어 있습니다.

type

string

리소스의 형식입니다. 예를 들어, "Microsoft. 컴퓨트/가상 머신" 또는 "Microsoft." 저장소/저장소 계정"

RecommendedActionCurrentState

권장되는 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되고 실행을 기다리고 있습니다. 실행 중 -> 권장 작업이 사용자 데이터베이스에 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 해당 유용성을 확인합니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인에서 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 위해 권장 작업이 대기 중이거나 사용자가 수동으로 되돌렸습니다. 되돌리기 - 권장 작업을 적용하는 동안 수행된> 변경 내용이 사용자 데이터베이스에서 되돌리고 있습니다. 되돌리기 -> 사용자 데이터베이스에 대한 권장 작업으로 변경한 내용을 성공적으로 되돌려 줍니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다.

값 Description
Active

진행 중

Pending

보류 중

Executing

실행 중

Verifying

검증

PendingRevert

PendingRevert

RevertCancelled

RevertCancelled

Reverting

복귀

Reverted

복귀

Ignored

무시됨

Expired

만료됨

Monitoring

모니터링

Resolved

해결됨

Success

성공

Error

오류

RecommendedActionErrorInfo

Azure SQL Database, 서버 또는 Elastic 풀 권장 행동에 대한 오류 정보를 포함합니다.

Name 형식 Description
errorCode

string

권장 작업이 오류 상태에 놓인 이유를 가져옵니다. 예: DatabaseHasQdsOff, IndexAlreadyExists

isRetryable

IsRetryable

오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다.

RecommendedActionImpactRecord

Azure SQL Database, 서버 또는 탄력적 풀 권장 조치에 대한 다양한 지표에 대한 추정 또는 관찰된 영향 정보를 포함합니다.

Name 형식 Description
absoluteValue

number (double)

해당하는 경우 이 차원의 절대값을 가져옵니다. 예를 들어 영향을 받는 쿼리 수

changeValueAbsolute

number (double)

이 차원 값의 절대 변경 사항을 가져옵니다. 예: 절대 디스크 공간 변경(메가바이트)

changeValueRelative

number (double)

이 차원 값의 상대적인 변경 사항을 가져옵니다. 예: 상대 디스크 공간 변경 비율

dimensionName

string

영향 차원의 이름을 가져옵니다. 예: CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

unit

string

영향 차원의 이름을 가져옵니다. 예: CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Azure SQL Database, Server 또는 Elastic Pool 권장 행동에 대한 수동 구현 정보를 포함하고 있습니다.

Name 형식 Description
method

ImplementationMethod

이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell.

script

string

수동 구현 스크립트를 가져옵니다. 예를 들어 데이터베이스에서 실행할 수 있는 T-SQL 스크립트입니다.

RecommendedActionInitiatedBy

이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.

값 Description
User

사용자

System

시스템

RecommendedActionMetricInfo

Azure SQL Database, 서버 또는 Elastic Pool 권장 조치에 대한 다양한 영향 지표의 시계열 데이터를 포함합니다.

Name 형식 Description
metricName

string

메트릭의 이름을 가져옵니다. 예: CPU, 쿼리 수입니다.

startTime

string (date-time)

이 MetricInfo에서 지정한 시간 간격의 시작 시간을 가져옵니다.

timeGrain

string

이 MetricInfo에서 지정한 값의 시간 간격을 가져옵니다. 예: PT1H(1시간)

unit

string

메트릭이 측정되는 단위를 가져옵니다. 예: DTU, 빈도

value

number (double)

이 MetricInfo에서 지정한 시간 간격의 메트릭 값을 가져옵니다.

RecommendedActionStateInfo

Azure SQL Database, 서버 또는 Elastic Pool 권장 조치의 현재 상태 정보를 포함합니다.

Name 형식 Description
actionInitiatedBy

RecommendedActionInitiatedBy

이 권장 작업의 실행을 시작한 사용자를 가져옵니다. 가능한 값은 사용자 -> 사용자가 시스템에서 권장 작업을 적용하도록 명시적으로 통보한 경우입니다. 시스템 -> 이 관리자의 자동 실행 상태가 '사용'으로 설정된 경우 시스템이 이를 적용했습니다.

currentValue

RecommendedActionCurrentState

권장되는 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되고 실행을 기다리고 있습니다. 실행 중 -> 권장 작업이 사용자 데이터베이스에 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 해당 유용성을 확인합니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인에서 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 위해 권장 작업이 대기 중이거나 사용자가 수동으로 되돌렸습니다. 되돌리기 - 권장 작업을 적용하는 동안 수행된> 변경 내용이 사용자 데이터베이스에서 되돌리고 있습니다. 되돌리기 -> 사용자 데이터베이스에 대한 권장 작업으로 변경한 내용을 성공적으로 되돌려 줍니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다.

lastModified

string (date-time)

상태가 마지막으로 수정된 시간을 가져옵니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.