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 |
|---|---|---|---|---|
|
advisor
|
path | True |
string |
데이터베이스 관리자의 이름입니다. |
|
database
|
path | True |
string |
데이터베이스의 이름입니다. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
server
|
path | True |
string |
서버의 이름입니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Azure 운영이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
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 |
데이터베이스, 서버 또는 탄력적 풀 관리자입니다. |
|
Advisor |
고객에게 이 관리자의 가용성 상태를 가져옵니다. 가능한 값은 'GA', 'PublicPreview', 'LimitedPublicPreview' 및 'PrivatePreview'입니다. |
|
Auto |
이 관리자의 자동 실행 상태(시스템이 권장 사항을 실행할 수 있도록 할지 여부)를 가져옵니다. 가능한 값은 'Enabled' 및 'Disabled'입니다. |
|
Auto |
자동 실행 상태의 현재 값이 상속되는 리소스를 가져옵니다. 리소스 계층 구조의 여러 수준에서 자동 실행 상태를 설정하고 상속할 수 있습니다. 가능한 값은 'Subscription', 'Server', 'ElasticPool', 'Database' 및 'Default'입니다(상태가 어떤 수준에서도 명시적으로 설정되지 않은 경우). |
|
created |
리소스를 만든 ID의 형식입니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Implementation |
이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell. |
|
Is |
오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다. |
|
Recommended |
데이터베이스, 서버 또는 탄력적 풀 권장 작업입니다. |
|
Recommended |
권장되는 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되고 실행을 기다리고 있습니다. 실행 중 -> 권장 작업이 사용자 데이터베이스에 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 해당 유용성을 확인합니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인에서 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 위해 권장 작업이 대기 중이거나 사용자가 수동으로 되돌렸습니다. 되돌리기 - 권장 작업을 적용하는 동안 수행된> 변경 내용이 사용자 데이터베이스에서 되돌리고 있습니다. 되돌리기 -> 사용자 데이터베이스에 대한 권장 작업으로 변경한 내용을 성공적으로 되돌려 줍니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다. |
|
Recommended |
Azure SQL Database, 서버 또는 Elastic 풀 권장 행동에 대한 오류 정보를 포함합니다. |
|
Recommended |
Azure SQL Database, 서버 또는 탄력적 풀 권장 조치에 대한 다양한 지표에 대한 추정 또는 관찰된 영향 정보를 포함합니다. |
|
Recommended |
Azure SQL Database, Server 또는 Elastic Pool 권장 행동에 대한 수동 구현 정보를 포함하고 있습니다. |
|
Recommended |
이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다. |
|
Recommended |
Azure SQL Database, 서버 또는 Elastic Pool 권장 조치에 대한 다양한 영향 지표의 시계열 데이터를 포함합니다. |
|
Recommended |
Azure SQL Database, 서버 또는 Elastic Pool 권장 조치의 현재 상태 정보를 포함합니다. |
|
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
Advisor
데이터베이스, 서버 또는 탄력적 풀 관리자입니다.
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
리소스 종류입니다. |
| location |
string |
리소스 위치입니다. |
| name |
string |
리소스의 이름 |
| properties.advisorStatus |
고객에게 이 관리자의 가용성 상태를 가져옵니다. 가능한 값은 'GA', 'PublicPreview', 'LimitedPublicPreview' 및 'PrivatePreview'입니다. |
|
| properties.autoExecuteStatus |
이 관리자의 자동 실행 상태(시스템이 권장 사항을 실행할 수 있도록 할지 여부)를 가져옵니다. 가능한 값은 'Enabled' 및 'Disabled'입니다. |
|
| properties.autoExecuteStatusInheritedFrom |
자동 실행 상태의 현재 값이 상속되는 리소스를 가져옵니다. 리소스 계층 구조의 여러 수준에서 자동 실행 상태를 설정하고 상속할 수 있습니다. 가능한 값은 'Subscription', 'Server', 'ElasticPool', 'Database' 및 'Default'입니다(상태가 어떤 수준에서도 명시적으로 설정되지 않은 경우). |
|
| properties.lastChecked |
string (date-time) |
이 관리자가 현재 리소스를 분석하여 권장 사항을 분석한 시간을 가져옵니다. |
| properties.recommendationsStatus |
string |
이 관리자에 대한 권장 사항의 상태와 권장 사항이 없는 이유를 가져옵니다. 가능한 값에는 '확인'(사용 가능한 권장 사항), LowActivity(분석할 워크로드가 충분하지 않음), 'DbSeemsTuned'(데이터베이스가 잘 작동 중) 등이 있습니다. |
| properties.recommendedActions |
이 관리자에 대한 권장 작업을 가져옵니다. |
|
| 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 |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
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 |
이 권장 작업이 오류 상태에 놓이는 경우 및 그 이유에 대한 오류 세부 정보를 가져옵니다. |
|
| properties.estimatedImpact |
이 권장 작업에 대한 예상 영향 정보(예: 예상 CPU 증가, 예상 디스크 공간 변경)를 가져옵니다. |
|
| properties.executeActionDuration |
string (duration) |
사용자 리소스에 이 권장 작업을 적용하는 데 걸린 시간을 가져옵니다. 예를 들어 인덱스 생성에 소요된 시간 |
| properties.executeActionInitiatedBy |
이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다. |
|
| properties.executeActionInitiatedTime |
string (date-time) |
이 권장 작업이 실행을 위해 승인된 시간을 가져옵니다. |
| properties.executeActionStartTime |
string (date-time) |
시스템이 사용자 리소스에 이 권장 작업을 적용하기 시작한 시간을 가져옵니다. 예: 인덱스 만들기 시작 시간 |
| properties.implementationDetails |
사용자가 수동으로 적용할 수 있도록 이 권장 작업의 구현 세부 정보를 가져옵니다. |
|
| properties.isArchivedAction |
boolean |
이 권장 작업이 얼마 전에 제안되었지만 사용자가 이를 무시하도록 선택했고 시스템에서 새 권장 작업을 다시 추가했는지를 가져옵니다. |
| properties.isExecutableAction |
boolean |
사용자가 이 권장 작업을 수행할 수 있는지를 가져옵니다. |
| properties.isRevertableAction |
boolean |
이 권장 작업에 의해 적용된 변경 내용을 사용자가 되돌릴 수 있는지를 가져옵니다. |
| properties.lastRefresh |
string (date-time) |
이 권장 작업을 마지막으로 새로 고친 시간을 가져옵니다. |
| properties.linkedObjects |
string[] |
연결된 개체(있는 경우)를 가져옵니다. |
| properties.observedImpact |
이 권장 작업에 대한 관찰된/실제 영향 정보(예: 실제 CPU 게인, 실제 디스크 공간 변경)를 가져옵니다. |
|
| properties.recommendationReason |
string |
이 작업을 권장하는 이유를 가져옵니다. 예: DuplicateIndex |
| properties.revertActionDuration |
string (duration) |
사용자 리소스에서 이 권장 작업의 변경 내용을 되돌리는 데 걸린 시간을 가져옵니다. 예를 들어 생성된 인덱스 삭제에 소요된 시간입니다. |
| properties.revertActionInitiatedBy |
이 권장 작업을 되돌리기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다. |
|
| properties.revertActionInitiatedTime |
string (date-time) |
이 권장 작업이 되돌리기 위해 승인된 시간을 가져옵니다. |
| properties.revertActionStartTime |
string (date-time) |
시스템이 사용자 리소스에서 이 권장 작업의 변경 내용을 되돌리기 시작한 시간을 가져옵니다. 예를 들어 인덱스 삭제가 실행되는 시간입니다. |
| properties.score |
integer (int32) |
이 권장 작업의 영향을 가져옵니다. 가능한 값은 1 - 낮은 영향, 2 - 중간 영향 및 3 - 높은 영향 |
| properties.state |
권장 작업이 있는 현재 상태의 정보를 가져옵니다. |
|
| properties.timeSeries |
이 권장 작업에 대한 메트릭의 시계열 정보(예: CPU 사용량 시계열)를 가져옵니다. |
|
| properties.validSince |
string (date-time) |
이 권장 작업이 유효한 시점 이후의 시간을 가져옵니다. |
| 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 |
오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다. |
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 |
이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: 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 |
이 권장 작업의 실행을 시작한 사용자를 가져옵니다. 가능한 값은 사용자 -> 사용자가 시스템에서 권장 작업을 적용하도록 명시적으로 통보한 경우입니다. 시스템 -> 이 관리자의 자동 실행 상태가 '사용'으로 설정된 경우 시스템이 이를 적용했습니다. |
|
| currentValue |
권장되는 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되고 실행을 기다리고 있습니다. 실행 중 -> 권장 작업이 사용자 데이터베이스에 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 해당 유용성을 확인합니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인에서 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 위해 권장 작업이 대기 중이거나 사용자가 수동으로 되돌렸습니다. 되돌리기 - 권장 작업을 적용하는 동안 수행된> 변경 내용이 사용자 데이터베이스에서 되돌리고 있습니다. 되돌리기 -> 사용자 데이터베이스에 대한 권장 작업으로 변경한 내용을 성공적으로 되돌려 줍니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다. |
|
| lastModified |
string (date-time) |
상태가 마지막으로 수정된 시간을 가져옵니다. |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
| createdBy |
string |
리소스를 만든 ID입니다. |
| createdByType |
리소스를 만든 ID의 형식입니다. |
|
| lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |