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

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string	リソースを含むリソース グループの名前。 この値は、Azure Resource Manager 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 - 使用可能なリソースによって処理できる最大要求を超える要求。

例

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"
      }
    }
  }
}

定義

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

AutomaticTuningDisabledReason

列挙

必要な場合の理由の説明と実際の状態が異なります。

値	説明
AutoConfigured
Default
Disabled
InheritedFromServer
NotSupported
QueryStoreOff
QueryStoreReadOnly

AutomaticTuningMode

列挙

必要な状態の自動チューニング。

値	説明
Auto
Custom
Inherit
Unspecified

AutomaticTuningOptionModeActual

列挙

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

値	説明
Off
On

AutomaticTuningOptionModeDesired

列挙

自動チューニング オプションの必要な状態。

値	説明
Default
Off
On

AutomaticTuningOptions

Object

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

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

DatabaseAutomaticTuning

Object

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

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