Database Automatic Tuning - Get

リファレンス

Service:: SQL Database

API Version:: 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 パラメーター

名前	/	必須	型	説明
databaseName	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	DatabaseAutomaticTuning	データベースの自動チューニングプロパティが正常に取得されました。
Other Status Codes		エラー応答: *** 400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベースエディションで無効になっている機能を使用しようとしました。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 SystemDatabasesNotSupported - ユーザーがシステムデータベースの自動チューニング情報を取得しようとしました。 400 DataWarehouseNotSupported - SQL Data Warehouseでは自動チューニングはサポートされていません。 404 DatabaseDoesNotExist - 要求されたデータベースが見つかりませんでした 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SubscriptionDoesNotHaveElasticPool - 要求されたエラスティックプールが見つかりませんでした 404 OperationIdNotFound - Id を持つ操作が存在しません。 405 NotSupported - この機能はサポートされていません。 409 競合 - 要求の競合が原因で要求を処理できませんでした。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。 503 ServiceTemporarilyUnavailable - 機能を一時的に使用できません。 503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

名前

型

説明

200 OK

DatabaseAutomaticTuning

データベースの自動チューニングプロパティが正常に取得されました。

Other Status Codes

エラー応答: ***

400 FeatureDisabledOnSelectedEdition - ユーザーは、現在のデータベースエディションで無効になっている機能を使用しようとしました。
400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。
400 SystemDatabasesNotSupported - ユーザーがシステムデータベースの自動チューニング情報を取得しようとしました。
400 DataWarehouseNotSupported - SQL Data Warehouseでは自動チューニングはサポートされていません。
404 DatabaseDoesNotExist - 要求されたデータベースが見つかりませんでした
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 SubscriptionDoesNotHaveElasticPool - 要求されたエラスティックプールが見つかりませんでした
404 OperationIdNotFound - Id を持つ操作が存在しません。
405 NotSupported - この機能はサポートされていません。
409 競合 - 要求の競合が原因で要求を処理できませんでした。
409 OperationCancelled - 操作がユーザーによって取り消されました。
409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。
429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースで処理できる最大要求を超える要求。
429 SubscriptionTooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。
500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。操作をやり直してください。
503 ServiceTemporarilyUnavailable - 機能を一時的に使用できません。
503 TooManyRequests - 使用可能なリソースで処理できる最大要求を超える要求。

例

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


import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:: 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"
      }
    }
  }
}

定義

名前	説明
AutomaticTuningDisabledReason	必要に応じて理由の説明と実際の状態が異なります。
AutomaticTuningMode	目的の状態の自動チューニング。
AutomaticTuningOptionModeActual	自動チューニングオプションの実際の状態。
AutomaticTuningOptionModeDesired	自動チューニングオプションの目的の状態。
AutomaticTuningOptions	個々のアドバイザーの自動チューニングプロパティ。
DatabaseAutomaticTuning	データベースレベルの自動チューニング。

AutomaticTuningDisabledReason

必要に応じて理由の説明と実際の状態が異なります。

名前	型	説明
AutoConfigured	string
Default	string
Disabled	string
InheritedFromServer	string
NotSupported	string
QueryStoreOff	string
QueryStoreReadOnly	string

AutomaticTuningMode

目的の状態の自動チューニング。

名前	型	説明
Auto	string
Custom	string
Inherit	string
Unspecified	string

AutomaticTuningOptionModeActual

自動チューニングオプションの実際の状態。

名前	型	説明
Off	string
On	string

AutomaticTuningOptionModeDesired

自動チューニングオプションの目的の状態。

名前	型	説明
Default	string
Off	string
On	string

AutomaticTuningOptions

個々のアドバイザーの自動チューニングプロパティ。

名前	型	説明
actualState	AutomaticTuningOptionModeActual	自動チューニングオプションの実際の状態。
desiredState	AutomaticTuningOptionModeDesired	自動チューニングオプションの目的の状態。
reasonCode	integer	必要に応じて理由コードと実際の状態が異なります。
reasonDesc	AutomaticTuningDisabledReason	必要に応じて理由の説明と実際の状態が異なります。

DatabaseAutomaticTuning

データベースレベルの自動チューニング。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.actualState	AutomaticTuningMode	自動チューニングの実際の状態。
properties.desiredState	AutomaticTuningMode	目的の状態の自動チューニング。
properties.options	<string, AutomaticTuningOptions>	自動チューニングオプションの定義。
type	string	リソースの種類。

Database Automatic Tuning - Get

URI パラメーター

応答

例

Get a database's automatic tuning settings

Sample Request

Sample Response

定義

AutomaticTuningDisabledReason

AutomaticTuningMode

AutomaticTuningOptionModeActual

AutomaticTuningOptionModeDesired

AutomaticTuningOptions

DatabaseAutomaticTuning

その他のリソース