Database Automatic Tuning - Get

服務:

SQL Database

API 版本:

2021-11-01

取得資料庫的自動調整。

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

URI 參數

名稱	位於	必要	類型	Description
databaseName	path	True	string	資料庫的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

回應

名稱	類型	Description
200 OK	DatabaseAutomaticTuning	已成功擷取資料庫自動調整屬性。
Other Status Codes		錯誤回應： *** 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本已停用的功能。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 SystemDatabasesNotSupported - 用戶嘗試取得系統資料庫的自動調整資訊。 400 DataWarehouseNotSupported - SQL 數據倉儲不支援自動調整。 404 DatabaseDoesNotExist - 找不到要求的資料庫 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 SubscriptionDoesNotHaveElasticPool - 找不到要求的彈性集區 404 OperationIdNotFound - 標識符為 的作業不存在。 405 NotSupported - 不支援此功能。 409 衝突 - 要求因要求衝突而無法處理。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。 請重試作業。 503 ServiceTemporarilyUnavailable - 功能暫時無法使用。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

範例

Get a database's automatic tuning settings

範例要求

HTTP

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=2021-11-01

Java

/**
 * Samples for DatabaseAutomaticTuning Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseAutomaticTuningGet.json
     */
    /**
     * Sample code: Get a database's automatic tuning settings.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getADatabaseSAutomaticTuningSettings(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabaseAutomaticTunings().getWithResponse("default-sql-onebox",
            "testsvr11", "db1", 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/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/databases/db1/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "createIndex": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

定義

名稱	Description
AutomaticTuningDisabledReason	如有需要和實際狀態，原因描述會有所不同。
AutomaticTuningMode	自動調整所需的狀態。
AutomaticTuningOptionModeActual	自動調整選項實際狀態。
AutomaticTuningOptionModeDesired	自動調整選項所需的狀態。
AutomaticTuningOptions	個別建議程序自動調整屬性。
DatabaseAutomaticTuning	資料庫層級的自動調整。

AutomaticTuningDisabledReason

列舉型別

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

值	Description
AutoConfigured
Default
Disabled
InheritedFromServer
NotSupported
QueryStoreOff
QueryStoreReadOnly

AutomaticTuningMode

列舉型別

自動調整所需的狀態。

值	Description
Auto
Custom
Inherit
Unspecified

AutomaticTuningOptionModeActual

列舉型別

自動調整選項實際狀態。

值	Description
Off
On

AutomaticTuningOptionModeDesired

列舉型別

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

值	Description
Default
Off
On

AutomaticTuningOptions

Object

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

名稱	類型	Description
actualState	AutomaticTuningOptionModeActual	自動調整選項實際狀態。
desiredState	AutomaticTuningOptionModeDesired	自動調整選項所需的狀態。
reasonCode	integer (int32)	如有需要且實際狀態不同，原因代碼。
reasonDesc	AutomaticTuningDisabledReason	如有需要和實際狀態，原因描述會有所不同。

DatabaseAutomaticTuning

Object

資料庫層級的自動調整。

名稱	類型	Description
id	string	資源標識碼。
name	string	資源名稱。
properties.actualState	AutomaticTuningMode	自動調整實際狀態。
properties.desiredState	AutomaticTuningMode	自動調整所需的狀態。
properties.options	<string,  AutomaticTuningOptions>	自動調整選項定義。
type	string	資源類型。