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 |
---|---|---|---|---|
advisor
|
path | True |
string |
Der Name des Datenbankratgebers. |
database
|
path | True |
string |
Der Name der Datenbank. |
resource
|
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. |
server
|
path | True |
string |
Name des Servers |
subscription
|
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 |
Die Details des angegebenen Datenbankratgebers wurden erfolgreich abgerufen. |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Get database advisor
Beispielanforderung
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. |
Advisor |
Ruft die status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview". |
Auto |
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". |
Auto |
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). |
Implementation |
Ruft die Methode ab, in der diese empfohlene Aktion manuell implementiert werden kann. z.B. TSql, AzurePowerShell. |
Is |
Ruft ab, ob der Fehler ignoriert und die empfohlene Aktion wiederholt werden kann. Mögliche Werte sind: Ja/Nein |
Recommended |
Empfohlene Datenbank-, Server- oder Elastische Poolaktion. |
Recommended |
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. |
Recommended |
Enthält Fehlerinformationen für eine Azure SQL Empfohlene Aktion für Datenbank, Server oder elastische Pools. |
Recommended |
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. |
Recommended |
Enthält Informationen zur manuellen Implementierung einer Azure SQL empfohlenen Aktion Datenbank, Server oder Elastischer Pool. |
Recommended |
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. |
Recommended |
Enthält Zeitreihen verschiedener betroffener Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder elastische Pools. |
Recommended |
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 |
Ruft die status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview". |
|
properties.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 |
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 |
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 |
Ruft die Fehlerdetails ab, wenn und warum diese empfohlene Aktion in den Fehlerzustand versetzt wird. |
|
properties.estimatedImpact |
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 |
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 |
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 |
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 |
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 |
Ruft die Informationen zum aktuellen Zustand ab, in dem sich die empfohlene Aktion befindet. |
|
properties.timeSeries |
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 |
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 |
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 |
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 |
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. |