Database Automatic Tuning - Get

サービス:: SQL Database

API バージョン:: 2025-01-01

データベースの自動チューニングを取得します。

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

URI パラメーター

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	DatabaseAutomaticTuning	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

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=2025-01-01

応答のサンプル

状態コード:: 200

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

定義

名前	説明
AutomaticTuningDisabledReason	必要な場合の理由の説明と実際の状態が異なります。
AutomaticTuningMode	必要な状態の自動チューニング。
AutomaticTuningOptionModeActual	自動チューニングオプションの実際の状態。
AutomaticTuningOptionModeDesired	自動チューニングオプションの必要な状態。
AutomaticTuningOptions	個々のアドバイザーの自動チューニングプロパティ。
createdByType	リソースを作成した ID の種類。
DatabaseAutomaticTuning	データベースレベルの自動チューニング。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
systemData	リソースの作成と最後の変更に関連するメタデータ。

AutomaticTuningDisabledReason

列挙

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

値	説明
Default	デフォルト
Disabled	Disabled
AutoConfigured	AutoConfigured
InheritedFromServer	InheritedFromServer
QueryStoreOff	QueryStoreOff
QueryStoreReadOnly	QueryStoreReadOnly
NotSupported	サポートされていません

AutomaticTuningMode

列挙

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

値	説明
Inherit	継承
Custom	カスタム
Auto	自動
Unspecified	指定されていません。

AutomaticTuningOptionModeActual

列挙

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

値	説明
Off	オフ
On	オン

AutomaticTuningOptionModeDesired

列挙

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

値	説明
Off	オフ
On	オン
Default	デフォルト

AutomaticTuningOptions

Object

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

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

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DatabaseAutomaticTuning

Object

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

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.actualState	AutomaticTuningMode	自動チューニングの実際の状態。
properties.desiredState	AutomaticTuningMode	必要な状態の自動チューニング。
properties.options	<string, AutomaticTuningOptions>	自動チューニングオプションの定義。
systemData	systemData	create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。