Database Automatic Tuning - Get

取得資料庫的自動調整。

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

URI 參數

名稱 位於 必要 類型 Description
databaseName
path True

string

資料庫的名稱。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

資源群組的名稱。 名稱不區分大小寫。

serverName
path True

string

伺服器的名稱。

subscriptionId
path True

string (uuid)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

回應

名稱 類型 Description
200 OK

DatabaseAutomaticTuning

Azure 運作順利完成。

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow.

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Get a database's automatic tuning settings

範例要求

GET https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current?api-version=2025-01-01

範例回覆

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

定義

名稱 Description
AutomaticTuningDisabledReason

如有需要和實際狀態,原因描述會有所不同。

AutomaticTuningMode

自動調整所需的狀態。

AutomaticTuningOptionModeActual

自動調整選項實際狀態。

AutomaticTuningOptionModeDesired

自動調整選項所需的狀態。

AutomaticTuningOptions

個別建議程序自動調整屬性。

createdByType

建立資源的身分識別類型。

DatabaseAutomaticTuning

資料庫層級的自動調整。

ErrorAdditionalInfo

資源管理錯誤附加資訊。

ErrorDetail

錯誤詳細資料。

ErrorResponse

錯誤回應

systemData

與建立和上次修改資源相關的元數據。

AutomaticTuningDisabledReason

如有需要和實際狀態,原因描述會有所不同。

值 Description
Default

預設值

Disabled

Disabled

AutoConfigured

自動配置

InheritedFromServer

繼承了FromServer。

QueryStoreOff

QueryStoreOff

QueryStoreReadOnly

QueryStoreReadOnly

NotSupported

不支持

AutomaticTuningMode

自動調整所需的狀態。

值 Description
Inherit

繼承

Custom

自定義

Auto

自動

Unspecified

未指定

AutomaticTuningOptionModeActual

自動調整選項實際狀態。

值 Description
Off

關閉

On

開啟

AutomaticTuningOptionModeDesired

自動調整選項所需的狀態。

值 Description
Off

關閉

On

開啟

Default

預設值

AutomaticTuningOptions

個別建議程序自動調整屬性。

名稱 類型 Description
actualState

AutomaticTuningOptionModeActual

自動調整選項實際狀態。

desiredState

AutomaticTuningOptionModeDesired

自動調整選項所需的狀態。

reasonCode

integer (int32)

如有需要且實際狀態不同,原因代碼。

reasonDesc

AutomaticTuningDisabledReason

如有需要和實際狀態,原因描述會有所不同。

createdByType

建立資源的身分識別類型。

值 Description
User
Application
ManagedIdentity
Key

DatabaseAutomaticTuning

資料庫層級的自動調整。

名稱 類型 Description
id

string (arm-id)

資源的完整資源標識碼。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

資源的名稱

properties.actualState

AutomaticTuningMode

自動調整實際狀態。

properties.desiredState

AutomaticTuningMode

自動調整所需的狀態。

properties.options

<string,  AutomaticTuningOptions>

自動調整選項定義。

systemData

systemData

Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。

type

string

資源的類型。 例如:「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」

ErrorAdditionalInfo

資源管理錯誤附加資訊。

名稱 類型 Description
info

object

附加資訊。

type

string

其他資訊類型。

ErrorDetail

錯誤詳細資料。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤附加資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳情

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string (date-time)

資源建立的時間戳(UTC)。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string (date-time)

資源上次修改的時間戳記 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。