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

Server Automatic Tuning - Update

更新服务器上的自动优化选项。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/automaticTuning/current?api-version=2017-03-01-preview

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
properties.desiredState

自动优化所需状态。

properties.options

自动优化选项定义。

响应

Name Type Description
200 OK

已成功更新服务器级自动优化选项。

Other Status Codes

错误响应: ***

  • 400 InvalidIdentifier - 标识符包含 NULL 或无效 unicode 字符。

  • 400 InvalidAutomaticTuningUpsertRequest - 更新自动优化请求正文不存在或没有属性对象。

  • 400 InvalidAdvisorAutoExecuteStatus - 不允许为顾问指定自动执行状态。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 DatabaseDoesNotExist - 找不到请求的数据库

  • 404 SubscriptionDoesNotHaveElasticPool - 找不到请求的弹性池

  • 404 OperationIdNotFound - ID 的操作不存在。

  • 405 NotSupported - 此功能不受支持。

  • 409 冲突 - 由于请求中的冲突,无法处理请求。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 503 ServiceTemporarilyUnavailable - 功能暂时不可用。

示例

Updates server automatic tuning settings with all properties
Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

Sample Request

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2017-03-01-preview

{
  "properties": {
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off"
      },
      "dropIndex": {
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default"
      }
    }
  }
}

Sample Response

{
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off",
        "actualState": "Off"
      },
      "dropIndex": {
        "desiredState": "On",
        "actualState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Updates server automatic tuning settings with minimal properties

Sample Request

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2017-03-01-preview

{
  "properties": {
    "desiredState": "Auto"
  }
}

Sample Response

{
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

定义

AutomaticTuningOptionModeActual

自动优化选项实际状态。

AutomaticTuningOptionModeDesired

所需状态的自动优化选项。

AutomaticTuningServerMode

自动优化所需状态。

AutomaticTuningServerOptions

单个顾问的自动优化属性。

AutomaticTuningServerReason

如果需要且实际状态不同,原因说明。

ServerAutomaticTuning

服务器级自动优化。

AutomaticTuningOptionModeActual

自动优化选项实际状态。

Name Type Description
Off
  • string
On
  • string

AutomaticTuningOptionModeDesired

所需状态的自动优化选项。

Name Type Description
Default
  • string
Off
  • string
On
  • string

AutomaticTuningServerMode

自动优化所需状态。

Name Type Description
Auto
  • string
Custom
  • string
Unspecified
  • string

AutomaticTuningServerOptions

单个顾问的自动优化属性。

Name Type Description
actualState

自动优化选项实际状态。

desiredState

所需状态的自动优化选项。

reasonCode
  • integer

如果需要,原因代码和实际状态不同。

reasonDesc

如果需要且实际状态不同,原因说明。

AutomaticTuningServerReason

如果需要且实际状态不同,原因说明。

Name Type Description
AutoConfigured
  • string
Default
  • string
Disabled
  • string

ServerAutomaticTuning

服务器级自动优化。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.actualState

自动优化实际状态。

properties.desiredState

自动优化所需状态。

properties.options

自动优化选项定义。

type
  • string

资源类型。