Database Recommended Actions - Update

참조

서비스:: SQL Database

API 버전:: 2021-11-01

데이터베이스 권장 작업을 업데이트.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
advisorName	path	True	string	데이터베이스 관리자의 이름입니다.
databaseName	path	True	string	데이터베이스의 이름입니다.
recommendedActionName	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
properties.state	True	RecommendedActionStateInfo	권장 작업이 있는 현재 상태의 정보를 가져옵니다.

응답

Name	형식	Description
200 OK	RecommendedAction	지정된 데이터베이스 권장 작업을 업데이트했습니다.
Other Status Codes		오류 응답: *** 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 InvalidRecommendedActionUpsertRequest - 업데이트 권장 작업 요청 본문이 없거나 속성이나 상태 개체가 없습니다. 400 InvalidRecommendedActionState - 권장 작업에 대해 지정된 상태가 잘못되었습니다. 404 DatabaseDoesNotExist - 요청된 데이터베이스를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 SubscriptionDoesNotHaveElasticPool - 요청된 탄력적 풀을 찾을 수 없습니다. 404 AdvisorNotFound - 요청한 관리자를 찾을 수 없습니다. 404 RecommendedActionNotFound - 요청한 권장 작업을 찾을 수 없습니다. 404 AdvisorNotFound - 요청한 관리자를 찾을 수 없습니다. 404 RecommendedActionNotFound - 요청한 권장 작업을 찾을 수 없습니다. 405 NotSupported - 이 기능은 지원되지 않습니다. 409 충돌 - 요청의 충돌로 인해 요청을 처리할 수 없습니다. 503 ServiceTemporarilyUnavailable - 기능을 일시적으로 사용할 수 없습니다.

Name

형식

Description

200 OK

RecommendedAction

지정된 데이터베이스 권장 작업을 업데이트했습니다.

Other Status Codes

오류 응답: ***

400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 InvalidRecommendedActionUpsertRequest - 업데이트 권장 작업 요청 본문이 없거나 속성이나 상태 개체가 없습니다.
400 InvalidRecommendedActionState - 권장 작업에 대해 지정된 상태가 잘못되었습니다.
404 DatabaseDoesNotExist - 요청된 데이터베이스를 찾을 수 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 SubscriptionDoesNotHaveElasticPool - 요청된 탄력적 풀을 찾을 수 없습니다.
404 AdvisorNotFound - 요청한 관리자를 찾을 수 없습니다.
404 RecommendedActionNotFound - 요청한 권장 작업을 찾을 수 없습니다.
404 AdvisorNotFound - 요청한 관리자를 찾을 수 없습니다.
404 RecommendedActionNotFound - 요청한 권장 작업을 찾을 수 없습니다.
405 NotSupported - 이 기능은 지원되지 않습니다.
409 충돌 - 요청의 충돌로 인해 요청을 처리할 수 없습니다.
503 ServiceTemporarilyUnavailable - 기능을 일시적으로 사용할 수 없습니다.

예제

Update database recommended action

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB?api-version=2021-11-01

{
  "properties": {
    "state": {
      "currentValue": "Pending"
    }
  }
}


import com.azure.resourcemanager.sql.fluent.models.RecommendedActionInner;
import com.azure.resourcemanager.sql.models.RecommendedActionCurrentState;
import com.azure.resourcemanager.sql.models.RecommendedActionStateInfo;

/**
 * Samples for DatabaseRecommendedActions Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseRecommendedActionUpdate.json
     */
    /**
     * Sample code: Update database recommended action.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateDatabaseRecommendedAction(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseRecommendedActions().updateWithResponse(
            "workloadinsight-demos", "misosisvr", "IndexAdvisor_test_3", "CreateIndex",
            "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
            new RecommendedActionInner()
                .withState(new RecommendedActionStateInfo().withCurrentValue(RecommendedActionCurrentState.PENDING)),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
  "name": "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB",
  "type": "Microsoft.Sql/servers/databases/advisors/recommendedActions",
  "location": "East Asia",
  "kind": "",
  "properties": {
    "recommendationReason": "",
    "validSince": "2017-03-01T14:38:04Z",
    "lastRefresh": "2017-03-01T14:38:04Z",
    "state": {
      "currentValue": "Pending",
      "actionInitiatedBy": "User",
      "lastModified": "2017-06-20T15:11:15Z"
    },
    "isExecutableAction": true,
    "isRevertableAction": true,
    "isArchivedAction": false,
    "executeActionInitiatedBy": "User",
    "executeActionInitiatedTime": "2017-06-20T15:11:15Z",
    "score": 1,
    "implementationDetails": {
      "method": "TSql",
      "script": "CREATE NONCLUSTERED INDEX [nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B] ON [CRM].[DataPoints] ([Name],[Money],[Power]) INCLUDE ([Hour], [System], [LastChanged]) WITH (ONLINE = ON)"
    },
    "errorDetails": {},
    "estimatedImpact": [
      {
        "dimensionName": "ActionDuration",
        "unit": "Seconds",
        "absoluteValue": 1440
      },
      {
        "dimensionName": "SpaceChange",
        "unit": "Megabytes",
        "absoluteValue": 209.3125
      }
    ],
    "observedImpact": [],
    "timeSeries": [],
    "details": {
      "indexName": "nci_wi_DataPoints_B892614093BAC56295EF6018BD4CB51B",
      "indexType": "NONCLUSTERED",
      "schema": "[CRM]",
      "table": "[DataPoints]",
      "indexColumns": "[Name],[Money],[Power]",
      "includedColumns": "[Hour], [System], [LastChanged]"
    }
  }
}

정의

Name	Description
ImplementationMethod	이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell.
IsRetryable	오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다.
RecommendedAction	데이터베이스, 서버 또는 탄력적 풀 권장 작업.
RecommendedActionCurrentState	권장 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되었으며 실행을 기다리고 있습니다. 실행 중 -> 사용자 데이터베이스에 권장 작업이 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 유용성을 확인하고 있습니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인이 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 또는 사용자가 수동으로 되돌리기 위해 권장 작업이 큐에 대기됩니다. 되돌리기 -> 권장 작업을 적용하는 동안 변경된 내용이 사용자 데이터베이스에서 되돌려집니다. 되돌리기 -> 사용자 데이터베이스에서 권장되는 작업으로 변경한 내용을 성공적으로 되돌려 했습니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다.
RecommendedActionErrorInfo	Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 오류 정보를 포함합니다.
RecommendedActionImpactRecord	Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 다양한 메트릭에 대한 예상 또는 관찰된 영향에 대한 정보를 포함합니다.
RecommendedActionImplementationInfo	Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 수동 구현에 대한 정보를 포함합니다.
RecommendedActionInitiatedBy	이 권장 작업의 실행을 시작한 사용자를 가져옵니다. 가능한 값: 사용자 -> 사용자가 권장 작업을 적용하도록 시스템에 명시적으로 통보한 경우입니다. 시스템 -> 이 관리자의 자동 실행 상태 '사용'으로 설정된 경우 시스템에서 적용했습니다.
RecommendedActionMetricInfo	Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 영향을 받은 다양한 메트릭의 시계열을 포함합니다.
RecommendedActionStateInfo	Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 현재 상태에 대한 정보를 포함합니다.

ImplementationMethod

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

Name	형식	Description
AzurePowerShell	string
TSql	string

IsRetryable

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

Name	형식	Description
No	string
Yes	string

RecommendedAction

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

Name	형식	Description
id	string	리소스 ID입니다.
kind	string	리소스 종류입니다.
location	string	리소스 위치.
name	string	리소스 이름입니다.
properties.details	object	이 권장 작업과 관련된 추가 세부 정보를 가져옵니다.
properties.errorDetails	RecommendedActionErrorInfo	이 권장 작업이 오류 상태에 놓이는 경우 오류 세부 정보를 가져옵니다.
properties.estimatedImpact	RecommendedActionImpactRecord[]	이 권장 작업에 대한 예상 영향 정보(예: 예상 CPU 증가, 예상 디스크 공간 변경)를 가져옵니다.
properties.executeActionDuration	string	사용자 리소스에 이 권장 작업을 적용하는 데 걸린 시간을 가져옵니다. 예를 들어 인덱스 만들기에 소요된 시간
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	이 권장 작업을 적용하기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.
properties.executeActionInitiatedTime	string	이 권장 작업이 실행되도록 승인된 시간을 가져옵니다.
properties.executeActionStartTime	string	시스템이 사용자 리소스에 이 권장 작업을 적용하기 시작한 시간을 가져옵니다. 예: 인덱스 만들기 시작 시간
properties.implementationDetails	RecommendedActionImplementationInfo	사용자가 수동으로 적용할 수 있도록 이 권장 작업의 구현 세부 정보를 가져옵니다.
properties.isArchivedAction	boolean	이 권장 작업이 얼마 전에 제안되었지만 사용자가 이를 무시하도록 선택했고 시스템에서 새 권장 작업을 다시 추가했는지를 가져옵니다.
properties.isExecutableAction	boolean	사용자가 이 권장 작업을 수행할 수 있는지를 가져옵니다.
properties.isRevertableAction	boolean	이 권장 작업에 적용된 변경 내용을 사용자가 되돌릴 수 있는지를 가져옵니다.
properties.lastRefresh	string	이 권장 작업을 마지막으로 새로 고친 시간을 가져옵니다.
properties.linkedObjects	string[]	연결된 개체(있는 경우)를 가져옵니다.
properties.observedImpact	RecommendedActionImpactRecord[]	이 권장 작업에 대한 관찰된/실제 영향 정보(예: 실제 CPU 게인, 실제 디스크 공간 변경)를 가져옵니다.
properties.recommendationReason	string	이 작업을 권장하는 이유를 가져옵니다. 예: DuplicateIndex
properties.revertActionDuration	string	사용자 리소스에서 이 권장 작업의 변경 내용을 되돌리는 데 걸린 시간을 가져옵니다. 예를 들어 생성된 인덱스 삭제에 걸린 시간입니다.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	이 권장 작업을 되돌리기 위한 승인이 사용자/시스템에서 제공되었는지를 가져옵니다.
properties.revertActionInitiatedTime	string	이 권장 작업이 되돌리기 승인된 시간을 가져옵니다.
properties.revertActionStartTime	string	시스템이 사용자 리소스에 대한 이 권장 작업의 변경 내용을 되돌리기 시작한 시간을 가져옵니다. 예를 들어 인덱스 삭제가 실행되는 시간입니다.
properties.score	integer	이 권장 작업의 영향을 가져옵니다. 가능한 값은 1 - 낮은 영향, 2 - 중간 영향 및 3 - 높은 영향입니다.
properties.state	RecommendedActionStateInfo	권장 작업이 있는 현재 상태의 정보를 가져옵니다.
properties.timeSeries	RecommendedActionMetricInfo[]	이 권장 작업에 대한 메트릭의 시계열 정보를 가져옵니다(예: CPU 사용량 시계열).
properties.validSince	string	이 권장 작업이 유효한 시점 이후의 시간을 가져옵니다.
type	string	리소스 종류.

RecommendedActionCurrentState

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

Name	형식	Description
Active	string
Error	string
Executing	string
Expired	string
Ignored	string
Monitoring	string
Pending	string
PendingRevert	string
Resolved	string
RevertCancelled	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedActionErrorInfo

Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 오류 정보를 포함합니다.

Name	형식	Description
errorCode	string	권장 작업이 오류 상태에 놓인 이유를 가져옵니다. 예: DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	오류를 무시할 수 있고 권장 작업을 다시 시도 할 수 있는지 여부를 가져옵니다. 가능한 값은 예/아니요입니다.

RecommendedActionImpactRecord

Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 다양한 메트릭에 대한 예상 또는 관찰된 영향에 대한 정보를 포함합니다.

Name	형식	Description
absoluteValue	number	해당하는 경우 이 차원의 절대값을 가져옵니다. 예를 들어 영향을 받는 쿼리 수
changeValueAbsolute	number	이 차원의 값에 대한 절대 변경 사항을 가져옵니다. 예를 들어 절대 디스크 공간 변경(메가바이트)
changeValueRelative	number	이 차원의 값에 대한 상대 변경 사항을 가져옵니다. 예: 상대 디스크 공간 변경(백분율)
dimensionName	string	영향 차원의 이름을 가져옵니다. 예: CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit	string	영향 차원의 이름을 가져옵니다. 예: CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 수동 구현에 대한 정보를 포함합니다.

Name	형식	Description
method	ImplementationMethod	이 권장 작업을 수동으로 구현할 수 있는 메서드를 가져옵니다. 예: TSql, AzurePowerShell.
script	string	수동 구현 스크립트를 가져옵니다. 예를 들어 데이터베이스에서 실행할 수 있는 T-SQL 스크립트입니다.

RecommendedActionInitiatedBy

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

Name	형식	Description
System	string
User	string

RecommendedActionMetricInfo

Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 영향을 받은 다양한 메트릭의 시계열을 포함합니다.

Name	형식	Description
metricName	string	메트릭의 이름을 가져옵니다. 예를 들어 CPU, 쿼리 수입니다.
startTime	string	이 MetricInfo에서 지정한 시간 간격의 시작 시간을 가져옵니다.
timeGrain	string	이 MetricInfo에서 지정한 값의 시간 간격을 가져옵니다. 예: PT1H(1시간)
unit	string	메트릭이 측정되는 단위를 가져옵니다. 예: DTU, 빈도
value	number	이 MetricInfo에서 지정한 시간 간격의 메트릭 값을 가져옵니다.

RecommendedActionStateInfo

Azure SQL 데이터베이스, 서버 또는 탄력적 풀 권장 작업에 대한 현재 상태에 대한 정보를 포함합니다.

Name	형식	Description
actionInitiatedBy	RecommendedActionInitiatedBy	이 권장 작업의 실행을 시작한 사용자를 가져옵니다. 가능한 값: 사용자 -> 사용자가 권장 작업을 적용하도록 시스템에 명시적으로 통보한 경우입니다. 시스템 -> 이 관리자의 자동 실행 상태 '사용'으로 설정된 경우 시스템에서 적용했습니다.
currentValue	RecommendedActionCurrentState	권장 작업이 있는 현재 상태입니다. 일반적으로 사용되는 몇 가지 상태는 활성 -> 권장 작업이 활성 상태이며 아직 아무 작업도 수행되지 않았습니다. 보류 중 -> 권장 작업이 승인되었으며 실행을 기다리고 있습니다. 실행 중 -> 사용자 데이터베이스에 권장 작업이 적용되고 있습니다. 확인 -> 권장 작업이 적용되었으며 시스템에서 유용성을 확인하고 있습니다. 성공 -> 권장 작업이 적용되었고 확인 중에 개선이 발견되었습니다. 되돌리기 보류 중 -> 확인이 거의 또는 전혀 개선되지 않았기 때문에 되돌리기 또는 사용자가 수동으로 되돌리기 위해 권장 작업이 큐에 대기됩니다. 되돌리기 -> 권장 작업을 적용하는 동안 변경된 내용이 사용자 데이터베이스에서 되돌려집니다. 되돌리기 -> 사용자 데이터베이스에서 권장되는 작업으로 변경한 내용을 성공적으로 되돌려 했습니다. 무시됨 -> 사용자가 권장 작업을 명시적으로 무시/삭제했습니다.
lastModified	string	상태가 마지막으로 수정된 시간을 가져옵니다.

다음을 통해 공유

Database Recommended Actions - Update

URI 매개 변수

요청 본문

응답

예제

Update database recommended action

샘플 요청

샘플 응답

정의

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

추가 리소스