Server Advisors - Get

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

サーバーアドバイザーを取得します。

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

URI パラメーター

名前	/	必須	型	説明
advisorName	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	Advisor	指定されたサーバーアドバイザーの詳細が正常に取得されました。
Other Status Codes		エラー応答: *** 400 FeatureDisabledOnSelectedEdition - ユーザーが現在のデータベースエディションで無効になっている機能を使用しようとしました。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 400 DataWarehouseNotSupported - SQL Data Warehouseでは自動チューニングはサポートされていません。 404 DatabaseDoesNotExist - 要求されたデータベースが見つかりませんでした 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SubscriptionDoesNotHaveElasticPool - 要求されたエラスティックプールが見つかりませんでした 404 AdvisorNotFound - 要求されたアドバイザーが見つかりませんでした。 405 NotSupported - この機能はサポートされていません。 409 競合 - 要求の競合が原因で要求を処理できませんでした。 503 ServiceTemporarilyUnavailable - 機能は一時的に使用できません。

名前

型

説明

200 OK

Advisor

指定されたサーバーアドバイザーの詳細が正常に取得されました。

Other Status Codes

エラー応答: ***

400 FeatureDisabledOnSelectedEdition - ユーザーが現在のデータベースエディションで無効になっている機能を使用しようとしました。
400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。
400 DataWarehouseNotSupported - SQL Data Warehouseでは自動チューニングはサポートされていません。
404 DatabaseDoesNotExist - 要求されたデータベースが見つかりませんでした
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 SubscriptionDoesNotHaveElasticPool - 要求されたエラスティックプールが見つかりませんでした
404 AdvisorNotFound - 要求されたアドバイザーが見つかりませんでした。
405 NotSupported - この機能はサポートされていません。
409 競合 - 要求の競合が原因で要求を処理できませんでした。
503 ServiceTemporarilyUnavailable - 機能は一時的に使用できません。

例

Get server advisor

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex?api-version=2021-11-01


/**
 * Samples for ServerAdvisors Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAdvisorGet.json
     */
    /**
     * Sample code: Get server advisor.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getServerAdvisor(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvisors().getWithResponse("workloadinsight-demos",
            "misosisvr", "CreateIndex", 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/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/advisors",
  "location": "East Asia",
  "kind": "",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "autoExecuteStatusInheritedFrom": "Default"
  }
}

定義

名前	説明
Advisor	データベース、サーバー、またはエラスティックプールアドバイザー。
AdvisorStatus	顧客に対するこのアドバイザーの可用性の状態を取得します。使用できる値は、'GA'、'PublicPreview'、'LimitedPublicPreview' および 'PrivatePreview' です。
AutoExecuteStatus	このアドバイザーの自動実行状態 (システムに推奨事項を実行させるかどうか) を取得します。使用可能な値は、'Enabled' と 'Disabled' です
AutoExecuteStatusInheritedFrom	自動実行状態の現在の値が継承されるリソースを取得します。自動実行の状態は、リソース階層内のさまざまなレベルで設定 (および継承) できます。使用できる値は、'Subscription'、'Server'、'ElasticPool'、'Database' 、および 'Default' です (状態がどのレベルでも明示的に設定されていない場合)。
ImplementationMethod	この推奨されるアクションを手動で実装できるメソッドを取得します。たとえば、TSql、AzurePowerShell などです。
IsRetryable	エラーを無視し、推奨されるアクションを再試行できるかどうかを取得します。使用可能な値は次のとおりです。はい/いいえ
RecommendedAction	データベース、サーバー、またはエラスティックプールの推奨アクション。
RecommendedActionCurrentState	推奨されるアクションの現在の状態。一般的に使用される状態の一部は次のとおりです。アクティブ -> 推奨されるアクションはアクティブであり、アクションはまだ実行されていません。保留中 -> 推奨されるアクションはに対して承認され、実行を待機しています。実行中 -> 推奨されるアクションがユーザーデータベースに適用されています。検証 -> 推奨されるアクションが適用され、システムによってその有用性が検証されています。成功 -> 推奨されるアクションが適用され、検証中に改善が見つかりました。保留中の元に戻す -> 検証でほとんどまたはまったく改善が見つからなかったため、推奨されるアクションは元に戻すか、ユーザーが手動で元に戻しました。元に戻す -> 推奨されるアクションの適用中に行われた変更は、ユーザーデータベースで元に戻されます。元に戻す -> ユーザーデータベースで推奨されるアクションによって行われた変更が正常に元に戻されました。無視 -> ユーザーは推奨されるアクションを明示的に無視または破棄しました。
RecommendedActionErrorInfo	Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに関するエラー情報が含まれます。
RecommendedActionImpactRecord	Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに対するさまざまなメトリックに対する推定または観察された影響の情報が含まれます。
RecommendedActionImplementationInfo	Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションの手動実装に関する情報が含まれます。
RecommendedActionInitiatedBy	この推奨されるアクションの実行を開始したユーザーを取得します。使用できる値は、ユーザー -> 推奨されるアクションを適用するようにユーザーが明示的にシステムに通知した場合です。システム -> このアドバイザーの自動実行状態が "有効" に設定されている場合、システムによって適用されました。
RecommendedActionMetricInfo	Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに対して、影響を受けたさまざまなメトリックの時系列が含まれます。
RecommendedActionStateInfo	Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションの現在の状態の情報が含まれます。

Advisor

データベース、サーバー、またはエラスティックプールアドバイザー。

名前	型	説明
id	string	リソースの ID
kind	string	リソースの種類。
location	string	リソースの場所。
name	string	リソース名。
properties.advisorStatus	AdvisorStatus	顧客に対するこのアドバイザーの可用性の状態を取得します。使用できる値は、'GA'、'PublicPreview'、'LimitedPublicPreview' および 'PrivatePreview' です。
properties.autoExecuteStatus	AutoExecuteStatus	このアドバイザーの自動実行状態 (システムに推奨事項を実行させるかどうか) を取得します。使用可能な値は、'Enabled' と 'Disabled' です
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	自動実行状態の現在の値が継承されるリソースを取得します。自動実行の状態は、リソース階層内のさまざまなレベルで設定 (および継承) できます。使用できる値は、'Subscription'、'Server'、'ElasticPool'、'Database' 、および 'Default' です (状態がどのレベルでも明示的に設定されていない場合)。
properties.lastChecked	string	このアドバイザーによって現在のリソースが推奨事項について分析された時刻を取得します。
properties.recommendationsStatus	string	このアドバイザーの推奨事項の状態と、推奨事項がない理由を取得します。使用可能な値には、'OK' (使用可能な推奨事項)、LowActivity (分析するのに十分なワークロードがありません)、'DbSeemsTuned' (データベースがうまくいっています) などがありますが、これらに限定されません。
properties.recommendedActions	RecommendedAction[]	このアドバイザーに推奨されるアクションを取得します。
type	string	リソースの種類。

AdvisorStatus

顧客に対するこのアドバイザーの可用性の状態を取得します。使用できる値は、'GA'、'PublicPreview'、'LimitedPublicPreview' および 'PrivatePreview' です。

名前	型	説明
GA	string
LimitedPublicPreview	string
PrivatePreview	string
PublicPreview	string

AutoExecuteStatus

このアドバイザーの自動実行状態 (システムに推奨事項を実行させるかどうか) を取得します。使用可能な値は、'Enabled' と 'Disabled' です

名前	型	説明
Default	string
Disabled	string
Enabled	string

AutoExecuteStatusInheritedFrom

自動実行状態の現在の値が継承されるリソースを取得します。自動実行の状態は、リソース階層内のさまざまなレベルで設定 (および継承) できます。使用できる値は、'Subscription'、'Server'、'ElasticPool'、'Database' 、および 'Default' です (状態がどのレベルでも明示的に設定されていない場合)。

名前	型	説明
Database	string
Default	string
ElasticPool	string
Server	string
Subscription	string

ImplementationMethod

この推奨されるアクションを手動で実装できるメソッドを取得します。たとえば、TSql、AzurePowerShell などです。

名前	型	説明
AzurePowerShell	string
TSql	string

IsRetryable

エラーを無視し、推奨されるアクションを再試行できるかどうかを取得します。使用可能な値は次のとおりです。はい/いいえ

名前	型	説明
No	string
Yes	string

RecommendedAction

データベース、サーバー、またはエラスティックプールの推奨アクション。

名前	型	説明
id	string	リソースの ID
kind	string	リソースの種類。
location	string	リソースの場所。
name	string	リソース名。
properties.details	object	この推奨されるアクションに固有の追加の詳細を取得します。
properties.errorDetails	RecommendedActionErrorInfo	この推奨されるアクションがエラー状態に設定された場合とその理由について、エラーの詳細を取得します。
properties.estimatedImpact	RecommendedActionImpactRecord[]	この推奨されるアクションの推定影響情報 (推定 CPU ゲイン、推定ディスク領域の変更など) を取得します
properties.executeActionDuration	string	この推奨されるアクションをユーザーリソースに適用するためにかかった時間を取得します。たとえば、インデックスの作成にかかる時間
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	この推奨されるアクションの適用の承認がユーザーまたはシステムによって与えられたかどうかを取得します。
properties.executeActionInitiatedTime	string	この推奨アクションの実行が承認された時刻を取得します。
properties.executeActionStartTime	string	システムがユーザーリソースにこの推奨アクションの適用を開始した時刻を取得します。インデックス作成の開始時刻など
properties.implementationDetails	RecommendedActionImplementationInfo	ユーザーが手動で適用するために推奨されるこのアクションの実装の詳細を取得します。
properties.isArchivedAction	boolean	この推奨されるアクションがしばらく前に提案されたが、ユーザーがこのアクションを無視することを選択し、システムが新しい推奨アクションをもう一度追加したかどうかを取得します。
properties.isExecutableAction	boolean	この推奨されるアクションがユーザーが操作可能かどうかを取得します
properties.isRevertableAction	boolean	この推奨されるアクションによって適用された変更をユーザーが元に戻すことができるかどうかを取得します
properties.lastRefresh	string	この推奨アクションが最後に更新された時刻を取得します。
properties.linkedObjects	string[]	リンクされたオブジェクト (存在する場合) を取得します。
properties.observedImpact	RecommendedActionImpactRecord[]	この推奨されるアクション (実際の CPU ゲイン、実際のディスク領域の変更など) の観測/実際の影響情報を取得します
properties.recommendationReason	string	このアクションを推奨する理由を取得します。例: DuplicateIndex
properties.revertActionDuration	string	ユーザーリソースに対するこの推奨されるアクションの変更を元に戻すのにかかった時間を取得します。たとえば、作成されたインデックスを削除するためにかかった時間などです。
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	この推奨されるアクションを元に戻す承認がユーザーまたはシステムによって与えられたかどうかを取得します。
properties.revertActionInitiatedTime	string	この推奨アクションが元に戻すのが承認された時刻を取得します。
properties.revertActionStartTime	string	ユーザーリソースに対するこの推奨アクションの変更をシステムが元に戻し始めた時刻を取得します。たとえば、インデックスのドロップが実行された時刻などです。
properties.score	integer	この推奨されるアクションの影響を取得します。使用可能な値は、1 - 低影響、2 - 中程度の影響、3 - 高影響です
properties.state	RecommendedActionStateInfo	推奨されるアクションの現在の状態の情報を取得します。
properties.timeSeries	RecommendedActionMetricInfo[]	この推奨されるアクションのメトリックの時系列情報を取得します (CPU 消費量の時系列など)。
properties.validSince	string	この推奨アクションが有効な時刻を取得します。
type	string	リソースの種類。

RecommendedActionCurrentState

推奨されるアクションの現在の状態。一般的に使用される状態の一部は次のとおりです。アクティブ -> 推奨されるアクションはアクティブであり、アクションはまだ実行されていません。保留中 -> 推奨されるアクションはに対して承認され、実行を待機しています。実行中 -> 推奨されるアクションがユーザーデータベースに適用されています。検証 -> 推奨されるアクションが適用され、システムによってその有用性が検証されています。成功 -> 推奨されるアクションが適用され、検証中に改善が見つかりました。保留中の元に戻す -> 検証でほとんどまたはまったく改善が見つからなかったため、推奨されるアクションは元に戻すか、ユーザーが手動で元に戻しました。元に戻す -> 推奨されるアクションの適用中に行われた変更は、ユーザーデータベースで元に戻されます。元に戻す -> ユーザーデータベースで推奨されるアクションによって行われた変更が正常に元に戻されました。無視 -> ユーザーは推奨されるアクションを明示的に無視または破棄しました。

名前	型	説明
Active	string
Error	string
Executing	string
Expired	string
Ignored	string
Monitoring	string
Pending	string
PendingRevert	string
Resolved	string
RevertCancelled	string
Reverted	string
Reverting	string
Success	string
Verifying	string

RecommendedActionErrorInfo

Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに関するエラー情報が含まれます。

名前	型	説明
errorCode	string	推奨されるアクションがエラー状態になった理由を取得します。例: DatabaseHasQdsOff、IndexAlreadyExists
isRetryable	IsRetryable	エラーを無視し、推奨されるアクションを再試行できるかどうかを取得します。使用可能な値は次のとおりです。はい/いいえ

RecommendedActionImpactRecord

Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに対するさまざまなメトリックに対する推定または観察された影響の情報が含まれます。

名前	型	説明
absoluteValue	number	該当する場合は、このディメンションの絶対値を取得します。たとえば、影響を受けるクエリの数
changeValueAbsolute	number	このディメンションの値の絶対変更を取得します。たとえば、絶対ディスク領域の変更 (メガバイト単位)
changeValueRelative	number	このディメンションの値の相対的な変更を取得します。たとえば、相対的なディスク領域の変化 (パーセンテージ)
dimensionName	string	影響ディメンションの名前を取得します。たとえば、CPUChange、DiskSpaceChange、NumberOfQueriesAffected などです。
unit	string	影響ディメンションの名前を取得します。たとえば、CPUChange、DiskSpaceChange、NumberOfQueriesAffected などです。

RecommendedActionImplementationInfo

Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションの手動実装に関する情報が含まれます。

名前	型	説明
method	ImplementationMethod	この推奨されるアクションを手動で実装できるメソッドを取得します。たとえば、TSql、AzurePowerShell などです。
script	string	手動実装スクリプトを取得します。たとえば、データベースで実行できる T-SQL スクリプトなどです。

RecommendedActionInitiatedBy

この推奨されるアクションの実行を開始したユーザーを取得します。使用できる値は、ユーザー -> 推奨されるアクションを適用するようにユーザーが明示的にシステムに通知した場合です。システム -> このアドバイザーの自動実行状態が "有効" に設定されている場合、システムによって適用されました。

名前	型	説明
System	string
User	string

RecommendedActionMetricInfo

Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションに対して、影響を受けたさまざまなメトリックの時系列が含まれます。

名前	型	説明
metricName	string	メトリックの名前を取得します。たとえば、CPU、クエリの数などです。
startTime	string	この MetricInfo によって指定された時間間隔の開始時刻を取得します。
timeGrain	string	この MetricInfo によって指定された値の時間間隔の期間を取得します。例: PT1H (1 時間)
unit	string	メトリックが測定される単位を取得します。例: DTU、Frequency
value	number	この MetricInfo によって指定された時間間隔内のメトリックの値を取得します。

RecommendedActionStateInfo

Azure SQL データベース、サーバー、またはエラスティックプールの推奨アクションの現在の状態の情報が含まれます。

名前	型	説明
actionInitiatedBy	RecommendedActionInitiatedBy	この推奨されるアクションの実行を開始したユーザーを取得します。使用できる値は、ユーザー -> 推奨されるアクションを適用するようにユーザーが明示的にシステムに通知した場合です。システム -> このアドバイザーの自動実行状態が "有効" に設定されている場合、システムによって適用されました。
currentValue	RecommendedActionCurrentState	推奨されるアクションの現在の状態。一般的に使用される状態の一部は次のとおりです。アクティブ -> 推奨されるアクションはアクティブであり、アクションはまだ実行されていません。保留中 -> 推奨されるアクションはに対して承認され、実行を待機しています。実行中 -> 推奨されるアクションがユーザーデータベースに適用されています。検証 -> 推奨されるアクションが適用され、システムによってその有用性が検証されています。成功 -> 推奨されるアクションが適用され、検証中に改善が見つかりました。保留中の元に戻す -> 検証でほとんどまたはまったく改善が見つからなかったため、推奨されるアクションは元に戻すか、ユーザーが手動で元に戻しました。元に戻す -> 推奨されるアクションの適用中に行われた変更は、ユーザーデータベースで元に戻されます。元に戻す -> ユーザーデータベースで推奨されるアクションによって行われた変更が正常に元に戻されました。無視 -> ユーザーは推奨されるアクションを明示的に無視または破棄しました。
lastModified	string	状態が最後に変更された時刻を取得します

次の方法で共有

Server Advisors - Get

URI パラメーター

応答

例

Get server advisor

要求のサンプル

応答のサンプル

定義

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

その他のリソース