你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Database Recommended Actions - Get

参考

服务:: SQL Database

API 版本:: 2021-11-01

获取数据库建议的操作。

GET 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 参数

名称	在	必需	类型	说明
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 版本。

响应

名称	类型	说明
200 OK	RecommendedAction	已成功检索指定数据库建议操作的详细信息。
Other Status Codes		错误响应：*** 400 FeatureDisabledOnSelectedEdition - 用户尝试使用在当前数据库版本上禁用的功能。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 404 DatabaseDoesNotExist - 找不到请求的数据库 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 SubscriptionDoesNotHaveElasticPool - 找不到请求的弹性池 404 AdvisorNotFound - 找不到请求的顾问。 404 RecommendedActionNotFound - 找不到请求的建议操作。 404 AdvisorNotFound - 找不到请求的顾问。 404 RecommendedActionNotFound - 找不到请求的建议操作。 405 NotSupported - 不支持此功能。 409 冲突 - 由于请求中的冲突，无法处理请求。 503 ServiceTemporarilyUnavailable - 功能暂时不可用。

名称

类型

说明

200 OK

RecommendedAction

已成功检索指定数据库建议操作的详细信息。

Other Status Codes

错误响应：***

400 FeatureDisabledOnSelectedEdition - 用户尝试使用在当前数据库版本上禁用的功能。
400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。
404 DatabaseDoesNotExist - 找不到请求的数据库
404 SubscriptionDoesNotHaveServer - 找不到请求的服务器
404 SubscriptionDoesNotHaveElasticPool - 找不到请求的弹性池
404 AdvisorNotFound - 找不到请求的顾问。
404 RecommendedActionNotFound - 找不到请求的建议操作。
404 AdvisorNotFound - 找不到请求的顾问。
404 RecommendedActionNotFound - 找不到请求的建议操作。
405 NotSupported - 不支持此功能。
409 冲突 - 由于请求中的冲突，无法处理请求。
503 ServiceTemporarilyUnavailable - 功能暂时不可用。

示例

Get database recommended action

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/recommendedActions/IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB?api-version=2021-11-01


/**
 * Samples for DatabaseRecommendedActions Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseRecommendedActionGet.json
     */
    /**
     * Sample code: Get database recommended action.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getDatabaseRecommendedAction(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseRecommendedActions().getWithResponse(
            "workloadinsight-demos", "misosisvr", "IndexAdvisor_test_3", "CreateIndex",
            "IR_[CRM]_[DataPoints]_4821CD2F9510D98184BB", 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": "Active",
      "lastModified": "2017-03-01T14:38:05Z"
    },
    "isExecutableAction": true,
    "isRevertableAction": true,
    "isArchivedAction": false,
    "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]"
    }
  }
}

定义

名称	说明
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。

名称	类型	说明
AzurePowerShell	string
TSql	string

IsRetryable

获取是否可以忽略错误以及是否可以重试建议的操作。可能的值为：是/否

名称	类型	说明
No	string
Yes	string

RecommendedAction

数据库、服务器或弹性池建议的操作。

名称	类型	说明
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

建议操作处于的当前状态。一些常用的状态为：活动 -> 建议的操作处于活动状态，尚未执行任何操作。挂起 -> 建议的操作已批准，正在等待执行。正在执行 -> 正在对用户数据库应用建议的操作。正在验证 -> 建议的操作已应用，并且系统正在验证其有用性。成功 -> 验证期间应用了建议的操作并发现了改进。挂起还原 -> 验证发现很少或没有改进，因此建议的操作会排队等待还原或用户已手动还原。还原 -> 在用户数据库上还原应用建议操作时所做的更改。已还原 -> 成功还原了对用户数据库的建议操作所做的更改。忽略 -> 用户显式忽略/放弃建议的操作。

名称	类型	说明
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数据库、服务器或弹性池建议操作的错误信息。

名称	类型	说明
errorCode	string	获取将建议的操作置于错误状态的原因。例如，DatabaseHasQdsOff、IndexAlreadyExists
isRetryable	IsRetryable	获取是否可以忽略错误以及是否可以重试建议的操作。可能的值为：是/否

RecommendedActionImpactRecord

包含Azure SQL数据库、服务器或弹性池建议操作对各种指标的估计或观察到的影响的信息。

名称	类型	说明
absoluteValue	number	获取此维度的绝对值（如果适用）。例如，受影响的查询数
changeValueAbsolute	number	获取此维度的值的绝对变化。例如，绝对磁盘空间更改（以兆字节为单位）
changeValueRelative	number	获取此维度的值的相对变化。例如，相对磁盘空间更改百分比
dimensionName	string	获取影响维度的名称。例如，CPUChange、DiskSpaceChange、NumberOfQueriesAffected。
unit	string	获取影响维度的名称。例如，CPUChange、DiskSpaceChange、NumberOfQueriesAffected。

RecommendedActionImplementationInfo

包含有关Azure SQL数据库、服务器或弹性池建议操作的手动实现的信息。

名称	类型	说明
method	ImplementationMethod	获取可手动实现此建议操作的方法。例如 TSql、AzurePowerShell。
script	string	获取手动实现脚本。例如，可在数据库上执行的 T-SQL 脚本。

RecommendedActionInitiatedBy

获取发起执行此建议操作的人员。可能的值是：用户 -> 当用户显式通知系统应用建议的操作时。系统 -> 当此顾问的自动执行状态设置为“已启用”时，系统应用了它。

名称	类型	说明
System	string
User	string

RecommendedActionMetricInfo

包含Azure SQL数据库、服务器或弹性池建议操作的各种受影响指标的时序。

名称	类型	说明
metricName	string	获取指标的名称。例如 CPU、查询数。
startTime	string	获取此 MetricInfo 给定的时间间隔的开始时间。
timeGrain	string	获取此 MetricInfo 给定值的时间间隔持续时间。例如，PT1H (1 小时)
unit	string	获取度量指标的单位。例如，DTU、频率
value	number	获取此 MetricInfo 给定的时间间隔内指标的值。

RecommendedActionStateInfo

包含Azure SQL数据库、服务器或弹性池建议操作的当前状态信息。

名称	类型	说明
actionInitiatedBy	RecommendedActionInitiatedBy	获取发起执行此建议操作的人员。可能的值是：用户 -> 当用户显式通知系统应用建议的操作时。系统 -> 当此顾问的自动执行状态设置为“已启用”时，系统应用了它。
currentValue	RecommendedActionCurrentState	建议操作处于的当前状态。一些常用的状态为：活动 -> 建议的操作处于活动状态，尚未执行任何操作。挂起 -> 建议的操作已批准，正在等待执行。正在执行 -> 正在对用户数据库应用建议的操作。正在验证 -> 建议的操作已应用，并且系统正在验证其有用性。成功 -> 验证期间应用了建议的操作并发现了改进。挂起还原 -> 验证发现很少或没有改进，因此建议的操作会排队等待还原或用户已手动还原。还原 -> 在用户数据库上还原应用建议操作时所做的更改。已还原 -> 成功还原了对用户数据库的建议操作所做的更改。忽略 -> 用户显式忽略/放弃建议的操作。
lastModified	string	获取上次修改状态的时间

通过

Database Recommended Actions - Get

URI 参数

响应

示例

Get database recommended action

示例请求

示例响应

定义

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

其他资源