Freigeben über


Database Advisors - Get

Ruft einen Datenbankratgeber ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
advisorName
path True

string

Der Name des Datenbankratgebers.

databaseName
path True

string

Der Name der Datenbank.

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True

string

Name des Servers

subscriptionId
path True

string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True

string

API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name Typ Beschreibung
200 OK

Advisor

Die Details des angegebenen Datenbankratgebers wurden erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

  • 400 FeatureDisabledOnSelectedEdition: Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist.

  • 400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen.

  • 400 DataWarehouseNotSupported: Die automatische Optimierung wird für SQL-Data Warehouse nicht unterstützt.

  • 404 DatabaseDoesNotExist: Die angeforderte Datenbank wurde nicht gefunden.

  • 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.

  • 404 SubscriptionDoesNotHaveElasticPool: Der angeforderte Pool für elastische Datenbanken wurde nicht gefunden.

  • 404 AdvisorNotFound: Der angeforderte Advisor wurde nicht gefunden.

  • 405 Nicht Unterstützt: Diese Funktionalität wird nicht unterstützt.

  • 409 Konflikt: Die Anforderung konnte aufgrund eines Konflikts in der Anforderung nicht verarbeitet werden.

  • 503 ServiceTemporarilyUnavailable: Feature vorübergehend nicht verfügbar.

Beispiele

Get database advisor

Beispielanforderung

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

Beispiel für eine Antwort

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/databases/IndexAdvisor_test_3/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/databases/advisors",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "recommendationsStatus": "Ok",
    "lastChecked": "2017-06-20T00:24:39Z"
  }
}

Definitionen

Name Beschreibung
Advisor

Datenbank-, Server- oder Poolratgeber für elastische Datenbanken.

AdvisorStatus

Ruft die status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview".

AutoExecuteStatus

Ruft die automatische Ausführung status ab (ob das System die Empfehlungen ausführen lassen soll) dieses Advisor. Mögliche Werte sind "Aktiviert" und "Deaktiviert".

AutoExecuteStatusInheritedFrom

Ruft die Ressource ab, von der der aktuelle Wert der automatischen Ausführung status geerbt wird. Die automatische Ausführung status kann auf verschiedenen Ebenen in der Ressourcenhierarchie festgelegt (und von diesen geerbt werden). Mögliche Werte sind "Subscription", "Server", "ElasticPool", "Database" und "Default" (wenn status nicht explizit auf einer Ebene festgelegt ist).

ImplementationMethod

Ruft die Methode ab, in der diese empfohlene Aktion manuell implementiert werden kann. z.B. TSql, AzurePowerShell.

IsRetryable

Ruft ab, ob der Fehler ignoriert und die empfohlene Aktion wiederholt werden kann. Mögliche Werte sind: Ja/Nein

RecommendedAction

Empfohlene Datenbank-, Server- oder Elastische Poolaktion.

RecommendedActionCurrentState

Aktueller Zustand, in dem sich die empfohlene Aktion befindet. Einige häufig verwendete Zustände sind: Aktiv –> die empfohlene Aktion ist aktiv, und es wurde noch keine Aktion ausgeführt. Ausstehend:> Die empfohlene Aktion wird für genehmigt und wartet auf die Ausführung. Ausführen:> Die empfohlene Aktion wird auf die Benutzerdatenbank angewendet. Überprüfen:> Die empfohlene Aktion wurde angewendet und wird vom System auf ihre Nützlichkeit überprüft. Erfolg:> Die empfohlene Aktion wurde angewendet, und während der Überprüfung wurde eine Verbesserung gefunden. Ausstehende Wiederherstellung:> Die Überprüfung wurde nur wenig oder keine Verbesserung gefunden, sodass die empfohlene Aktion für rückgängig machen in die Warteschlange eingereiht wird oder der Benutzer manuell rückgängig macht. Wiederherstellen:> Änderungen, die beim Anwenden der empfohlenen Aktion vorgenommen wurden, werden für die Benutzerdatenbank wiederhergestellt. Zurückgesetzt:> Die Änderungen, die von der empfohlenen Aktion für die Benutzerdatenbank vorgenommen wurden, wurden erfolgreich zurückgesetzt. Ignoriert:> Der Benutzer hat die empfohlene Aktion explizit ignoriert/verworfen.

RecommendedActionErrorInfo

Enthält Fehlerinformationen für eine Azure SQL Empfohlene Aktion für Datenbank, Server oder elastische Pools.

RecommendedActionImpactRecord

Enthält Informationen zu geschätzten oder beobachteten Auswirkungen auf verschiedene Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder elastische Pools.

RecommendedActionImplementationInfo

Enthält Informationen zur manuellen Implementierung einer Azure SQL empfohlenen Aktion Datenbank, Server oder Elastischer Pool.

RecommendedActionInitiatedBy

Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert sind: Benutzer:> Wenn das System vom Benutzer explizit benachrichtigt wurde, um die empfohlene Aktion anzuwenden. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde, wurde sie vom System angewendet.

RecommendedActionMetricInfo

Enthält Zeitreihen verschiedener betroffener Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder elastische Pools.

RecommendedActionStateInfo

Enthält Informationen zum aktuellen Zustand einer Azure SQL empfohlenen Aktion Datenbank, Server oder Elastischer Pool.

Advisor

Datenbank-, Server- oder Poolratgeber für elastische Datenbanken.

Name Typ Beschreibung
id

string

Ressourcen-ID

kind

string

Ressourcentyp.

location

string

Ressourcenspeicherort

name

string

Name der Ressource.

properties.advisorStatus

AdvisorStatus

Ruft die status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview".

properties.autoExecuteStatus

AutoExecuteStatus

Ruft die automatische Ausführung status ab (ob das System die Empfehlungen ausführen lassen soll) dieses Advisor. Mögliche Werte sind "Aktiviert" und "Deaktiviert".

properties.autoExecuteStatusInheritedFrom

AutoExecuteStatusInheritedFrom

Ruft die Ressource ab, von der der aktuelle Wert der automatischen Ausführung status geerbt wird. Die automatische Ausführung status kann auf verschiedenen Ebenen in der Ressourcenhierarchie festgelegt (und von diesen geerbt werden). Mögliche Werte sind "Subscription", "Server", "ElasticPool", "Database" und "Default" (wenn status nicht explizit auf einer Ebene festgelegt ist).

properties.lastChecked

string

Ruft den Zeitpunkt ab, zu dem die aktuelle Ressource von diesem Ratgeber auf Empfehlungen analysiert wurde.

properties.recommendationsStatus

string

Ruft diese status von Empfehlungen für diesen Ratgeber ab und grund, warum keine Empfehlungen vorliegen. Mögliche Werte sind u. a. "Ok" (Empfehlungen verfügbar), LowActivity (nicht genügend Workload für die Analyse), "DbSeemsTuned" (Datenbank funktioniert gut), usw.

properties.recommendedActions

RecommendedAction[]

Ruft die empfohlenen Aktionen für diesen Ratgeber ab.

type

string

Der Ressourcentyp.

AdvisorStatus

Ruft die status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview".

Name Typ Beschreibung
GA

string

LimitedPublicPreview

string

PrivatePreview

string

PublicPreview

string

AutoExecuteStatus

Ruft die automatische Ausführung status ab (ob das System die Empfehlungen ausführen lassen soll) dieses Advisor. Mögliche Werte sind "Aktiviert" und "Deaktiviert".

Name Typ Beschreibung
Default

string

Disabled

string

Enabled

string

AutoExecuteStatusInheritedFrom

Ruft die Ressource ab, von der der aktuelle Wert der automatischen Ausführung status geerbt wird. Die automatische Ausführung status kann auf verschiedenen Ebenen in der Ressourcenhierarchie festgelegt (und von diesen geerbt werden). Mögliche Werte sind "Subscription", "Server", "ElasticPool", "Database" und "Default" (wenn status nicht explizit auf einer Ebene festgelegt ist).

Name Typ Beschreibung
Database

string

Default

string

ElasticPool

string

Server

string

Subscription

string

ImplementationMethod

Ruft die Methode ab, in der diese empfohlene Aktion manuell implementiert werden kann. z.B. TSql, AzurePowerShell.

Name Typ Beschreibung
AzurePowerShell

string

TSql

string

IsRetryable

Ruft ab, ob der Fehler ignoriert und die empfohlene Aktion wiederholt werden kann. Mögliche Werte sind: Ja/Nein

Name Typ Beschreibung
No

string

Yes

string

RecommendedAction

Empfohlene Datenbank-, Server- oder Elastische Poolaktion.

Name Typ Beschreibung
id

string

Ressourcen-ID

kind

string

Ressourcentyp.

location

string

Ressourcenspeicherort

name

string

Name der Ressource.

properties.details

object

Ruft zusätzliche Details ab, die für diese empfohlene Aktion spezifisch sind.

properties.errorDetails

RecommendedActionErrorInfo

Ruft die Fehlerdetails ab, wenn und warum diese empfohlene Aktion in den Fehlerzustand versetzt wird.

properties.estimatedImpact

RecommendedActionImpactRecord[]

Ruft die geschätzten Auswirkungeninformationen für diese empfohlene Aktion ab, z. B. Geschätzte CPU-Verstärkung, Änderung des geschätzten Datenträgerspeicherplatzes

properties.executeActionDuration

string

Ruft die Zeit ab, die für die Anwendung dieser empfohlenen Aktion auf eine Benutzerressource erforderlich ist. z. B. zeitaufwand für die Indexerstellung

properties.executeActionInitiatedBy

RecommendedActionInitiatedBy

Ruft ab, wenn die Genehmigung für die Anwendung dieser empfohlenen Aktion vom Benutzer/System erteilt wurde.

properties.executeActionInitiatedTime

string

Ruft den Zeitpunkt ab, zu dem diese empfohlene Aktion für die Ausführung genehmigt wurde.

properties.executeActionStartTime

string

Ruft den Zeitpunkt ab, zu dem das System begonnen hat, diese empfohlene Aktion auf die Benutzerressource anzuwenden. z. B. Startzeit der Indexerstellung

properties.implementationDetails

RecommendedActionImplementationInfo

Ruft die Implementierungsdetails dieser empfohlenen Aktion ab, die der Benutzer manuell anwenden kann.

properties.isArchivedAction

boolean

Ruft ab, wenn diese empfohlene Aktion vor einiger Zeit vorgeschlagen wurde, aber der Benutzer dies ignoriert hat, und das System erneut eine neue empfohlene Aktion hinzugefügt hat.

properties.isExecutableAction

boolean

Ruft ab, ob diese empfohlene Aktion vom Benutzer umsetzbar ist.

properties.isRevertableAction

boolean

Ruft ab, ob Änderungen, die von dieser empfohlenen Aktion angewendet werden, vom Benutzer wiederhergestellt werden können.

properties.lastRefresh

string

Ruft die Zeit ab, zu der diese empfohlene Aktion zuletzt aktualisiert wurde.

properties.linkedObjects

string[]

Ruft ggf. die verknüpften Objekte ab.

properties.observedImpact

RecommendedActionImpactRecord[]

Ruft die Informationen zu beobachteten/tatsächlichen Auswirkungen für diese empfohlene Aktion ab, z. B. Tatsächliche CPU-Verstärkung, Änderung des tatsächlichen Datenträgerspeicherplatzes

properties.recommendationReason

string

Ruft den Grund für die Empfehlung dieser Aktion ab. z.B. DuplicateIndex

properties.revertActionDuration

string

Ruft die Zeit ab, die für das Wiederherstellen von Änderungen dieser empfohlenen Aktion für die Benutzerressource erforderlich ist. z. B. die Zeit, die für das Löschen des erstellten Indexes gedauert hat.

properties.revertActionInitiatedBy

RecommendedActionInitiatedBy

Ruft ab, wenn die Genehmigung für die Wiederherstellung dieser empfohlenen Aktion vom Benutzer/System erteilt wurde.

properties.revertActionInitiatedTime

string

Ruft den Zeitpunkt ab, zu dem diese empfohlene Aktion für rückgängig machen genehmigt wurde.

properties.revertActionStartTime

string

Ruft den Zeitpunkt ab, zu dem das System damit begonnen hat, Änderungen dieser empfohlenen Aktion für die Benutzerressource wiederhergestellt zu haben. z. B. der Zeitpunkt, zu dem der Indexabbruch ausgeführt wird.

properties.score

integer

Ruft die Auswirkungen dieser empfohlenen Aktion ab. Mögliche Werte sind 1 – Geringer Aufprall, 2 – Mittlerer Aufprall und 3 – Hoher Einfluss

properties.state

RecommendedActionStateInfo

Ruft die Informationen zum aktuellen Zustand ab, in dem sich die empfohlene Aktion befindet.

properties.timeSeries

RecommendedActionMetricInfo[]

Ruft die Zeitreiheninformationen der Metriken für diese empfohlene Aktion ab, z. B. Zeitreihen für den CPU-Verbrauch

properties.validSince

string

Ruft die Zeit ab, ab der diese empfohlene Aktion gültig ist.

type

string

Der Ressourcentyp.

RecommendedActionCurrentState

Aktueller Zustand, in dem sich die empfohlene Aktion befindet. Einige häufig verwendete Zustände sind: Aktiv –> die empfohlene Aktion ist aktiv, und es wurde noch keine Aktion ausgeführt. Ausstehend:> Die empfohlene Aktion wird für genehmigt und wartet auf die Ausführung. Ausführen:> Die empfohlene Aktion wird auf die Benutzerdatenbank angewendet. Überprüfen:> Die empfohlene Aktion wurde angewendet und wird vom System auf ihre Nützlichkeit überprüft. Erfolg:> Die empfohlene Aktion wurde angewendet, und während der Überprüfung wurde eine Verbesserung gefunden. Ausstehende Wiederherstellung:> Die Überprüfung wurde nur wenig oder keine Verbesserung gefunden, sodass die empfohlene Aktion für rückgängig machen in die Warteschlange eingereiht wird oder der Benutzer manuell rückgängig macht. Wiederherstellen:> Änderungen, die beim Anwenden der empfohlenen Aktion vorgenommen wurden, werden für die Benutzerdatenbank wiederhergestellt. Zurückgesetzt:> Die Änderungen, die von der empfohlenen Aktion für die Benutzerdatenbank vorgenommen wurden, wurden erfolgreich zurückgesetzt. Ignoriert:> Der Benutzer hat die empfohlene Aktion explizit ignoriert/verworfen.

Name Typ Beschreibung
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

Enthält Fehlerinformationen für eine Azure SQL Empfohlene Aktion für Datenbank, Server oder elastische Pools.

Name Typ Beschreibung
errorCode

string

Ruft den Grund ab, warum die empfohlene Aktion in den Fehlerzustand versetzt wurde. z.B. DatabaseHasQdsOff, IndexAlreadyExists

isRetryable

IsRetryable

Ruft ab, ob der Fehler ignoriert und die empfohlene Aktion wiederholt werden kann. Mögliche Werte sind: Ja/Nein

RecommendedActionImpactRecord

Enthält Informationen zu geschätzten oder beobachteten Auswirkungen auf verschiedene Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder elastische Pools.

Name Typ Beschreibung
absoluteValue

number

Ruft ggf. den absoluten Wert dieser Dimension ab. z. B. Anzahl der betroffenen Abfragen

changeValueAbsolute

number

Ruft die absolute Änderung im Wert dieser Dimension ab. z. B. Absoluter Speicherplatzwechsel in Megabyte

changeValueRelative

number

Ruft die relative Änderung im Wert dieser Dimension ab. z. B. Relative Speicherplatzänderung in Prozent

dimensionName

string

Ruft den Namen der Auswirkungsdimension ab. z.B. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

unit

string

Ruft den Namen der Auswirkungsdimension ab. z.B. CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Enthält Informationen zur manuellen Implementierung einer Azure SQL empfohlenen Aktion Datenbank, Server oder Elastischer Pool.

Name Typ Beschreibung
method

ImplementationMethod

Ruft die Methode ab, in der diese empfohlene Aktion manuell implementiert werden kann. z. B. TSql, AzurePowerShell.

script

string

Ruft das manuelle Implementierungsskript ab. Z. B. T-SQL-Skript, das in der Datenbank ausgeführt werden könnte.

RecommendedActionInitiatedBy

Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert sind: Benutzer:> Wenn das System vom Benutzer explizit benachrichtigt wurde, um die empfohlene Aktion anzuwenden. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde, wurde sie vom System angewendet.

Name Typ Beschreibung
System

string

User

string

RecommendedActionMetricInfo

Enthält Zeitreihen verschiedener betroffener Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder elastische Pools.

Name Typ Beschreibung
metricName

string

Ruft den Namen der Metrik ab. z.B. CPU, Anzahl der Abfragen.

startTime

string

Ruft die Startzeit des Zeitintervalls ab, das von dieser Metrikinfo angegeben wird.

timeGrain

string

Ruft die Dauer des Zeitintervalls für den wert ab, der von dieser MetricInfo angegeben wird. z.B. PT1H (1 Stunde)

unit

string

Ruft die Einheit ab, in der die Metrik gemessen wird. z.B. DTU, Frequency

value

number

Ruft den Wert der Metrik im Zeitintervall ab, das von dieser Metrikinfo angegeben wird.

RecommendedActionStateInfo

Enthält Informationen zum aktuellen Zustand einer Azure SQL empfohlenen Aktion Datenbank, Server oder Elastischer Pool.

Name Typ Beschreibung
actionInitiatedBy

RecommendedActionInitiatedBy

Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert sind: Benutzer:> Wenn das System vom Benutzer explizit benachrichtigt wurde, um die empfohlene Aktion anzuwenden. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde, wurde sie vom System angewendet.

currentValue

RecommendedActionCurrentState

Aktueller Zustand, in dem sich die empfohlene Aktion befindet. Einige häufig verwendete Zustände sind Aktiv :> Empfohlene Aktion ist aktiv, und es wurde noch keine Aktion ausgeführt. Ausstehend:> Die empfohlene Aktion wird für genehmigt und wartet auf die Ausführung. Ausführen:> Die empfohlene Aktion wird auf die Benutzerdatenbank angewendet. Überprüfung:> Die empfohlene Aktion wurde angewendet und wird vom System auf ihre Nützlichkeit überprüft. Erfolg:> Die empfohlene Aktion wurde angewendet, und während der Überprüfung wurde eine Verbesserung gefunden. Ausstehende Revertierung:> Die Überprüfung wurde nur wenig oder keine Verbesserung gefunden, sodass die empfohlene Aktion für rückgängig machen oder der Benutzer manuell revertiert wurde, in die Warteschlange gestellt wird. Wiederherstellen:> Änderungen, die beim Anwenden der empfohlenen Aktion vorgenommen wurden, werden in der Benutzerdatenbank wiederhergestellt. Reverted:> Die Änderungen, die von der empfohlenen Aktion für die Benutzerdatenbank vorgenommen wurden, wurden erfolgreich zurückgesetzt. Ignoriert:> Der Benutzer hat die empfohlene Aktion explizit ignoriert/verworfen.

lastModified

string

Ruft den Zeitpunkt ab, zu dem der Zustand zuletzt geändert wurde.