Database Advisors - Update
Updates einen Datenbankratgeber.
PATCH 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. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
properties.autoExecuteStatus | True |
Ruft die automatische Ausführung status (ob das System die Empfehlungen ausführen soll) dieses Advisor ab. Mögliche Werte sind "Enabled" und "Disabled". |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der angegebene Datenbankratgeber wurde erfolgreich aktualisiert. |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Update database advisor
Beispielanforderung
PATCH 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
{
"properties": {
"autoExecuteStatus": "Disabled"
}
}
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 Advisor für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview". |
Auto |
Ruft die automatische Ausführung status (ob das System die Empfehlungen ausführen soll) dieses Advisor ab. Mögliche Werte sind "Enabled" und "Disabled". |
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 Poolaktion für elastische Datenbanken. |
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 Pool für elastische Datenbanken. |
Recommended |
Enthält Informationen zu den geschätzten oder beobachteten Auswirkungen auf verschiedene Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder Pool für elastische Datenbanken. |
Recommended |
Enthält Informationen zur manuellen Implementierung einer Azure SQL empfohlenen Aktion für Datenbank, Server oder Pool für elastische Datenbanken. |
Recommended |
Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert: Benutzer> : Wenn das vom Benutzer explizit benachrichtigte System die empfohlene Aktion anwenden soll. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde. In diesem Fall hat das System ihn angewendet. |
Recommended |
Enthält Eine Zeitreihe mit verschiedenen betroffenen Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder Pools für elastische Datenbanken. |
Recommended |
Enthält Informationen zum aktuellen Status einer Azure SQL empfohlenen Aktion Datenbank, Server oder Pool für elastische Datenbanken. |
Advisor
Datenbank-, Server- oder Poolratgeber für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
kind |
string |
Ressourcenart. |
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.advisorStatus |
Ruft die status der Verfügbarkeit dieses Advisor für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview". |
|
properties.autoExecuteStatus |
Ruft die automatische Ausführung status (ob das System die Empfehlungen ausführen soll) dieses Advisor ab. Mögliche Werte sind "Enabled" und "Disabled". |
|
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 Advisor auf Empfehlungen analysiert wurde. |
properties.recommendationsStatus |
string |
Ruft diesen status empfehlungen für diesen Advisor ab und grund, dass keine Empfehlungen vorhanden sind. 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 Advisor ab. |
|
type |
string |
Der Ressourcentyp. |
AdvisorStatus
Ruft die status der Verfügbarkeit dieses Advisor 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 (ob das System die Empfehlungen ausführen soll) dieses Advisor ab. Mögliche Werte sind "Enabled" und "Disabled".
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 Poolaktion für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
kind |
string |
Ressourcenart. |
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.details |
object |
Ruft zusätzliche Details ab, die speziell für diese empfohlene Aktion gelten. |
properties.errorDetails |
Ruft die Fehlerdetails ab, ob und warum diese empfohlene Aktion in den Fehlerzustand versetzt wird. |
|
properties.estimatedImpact |
Ruft die geschätzten Auswirkungsinformationen 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 zum Anwenden dieser empfohlenen Aktion für die Benutzerressource erforderlich ist. z. B. zeitaufwand für die Indexerstellung |
properties.executeActionInitiatedBy |
Ruft ab, ob 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 mit der Anwendung dieser empfohlenen Aktion auf die Benutzerressource begonnen hat. 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, ob diese empfohlene Aktion vor einiger Zeit vorgeschlagen wurde, aber der Benutzer dies ignoriert hat, und das System hat erneut eine neue empfohlene Aktion hinzugefügt. |
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 den Zeitpunkt ab, zu dem diese empfohlene Aktion zuletzt aktualisiert wurde. |
properties.linkedObjects |
string[] |
Ruft die verknüpften Objekte ab, falls vorhanden. |
properties.observedImpact |
Ruft die beobachteten/tatsächlichen Auswirkungsinformationen für diese empfohlene Aktion ab, z. B. Tatsächliche CPU-Verstärkung, Änderung des tatsächlichen Speicherplatzes |
|
properties.recommendationReason |
string |
Ruft den Grund für die Empfehlung dieser Aktion ab. z.B. DuplicateIndex |
properties.revertActionDuration |
string |
Ruft die Zeit ab, die zum Wiederherstellen von Änderungen dieser empfohlenen Aktion für die Benutzerressource erforderlich ist. z. B. die Zeit, die zum Löschen des erstellten Indexes gedauert hat. |
properties.revertActionInitiatedBy |
Ruft ab, ob 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 mit dem Zurücksetzen von Änderungen dieser empfohlenen Aktion für die Benutzerressource begonnen hat. z. B. der Zeitpunkt, zu dem das Löschen des Indexes ausgeführt wird. |
properties.score |
integer |
Ruft die Auswirkungen dieser empfohlenen Aktion ab. Mögliche Werte sind 1 – Low impact, 2 – Medium Impact und 3 – High Impact |
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 cpu-Verbrauch. |
|
properties.validSince |
string |
Ruft den Zeitpunkt ab, zu dem 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 Pool für elastische Datenbanken.
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 den geschätzten oder beobachteten Auswirkungen auf verschiedene Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder Pool für elastische Datenbanken.
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. Änderung des absoluten Speicherplatzes in Megabyte |
changeValueRelative |
number |
Ruft die relative Änderung des Werts dieser Dimension ab. z. B. Änderung des relativen Speicherplatzes 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 für Datenbank, Server oder Pool für elastische Datenbanken.
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 für die Datenbank ausgeführt werden könnte. |
RecommendedActionInitiatedBy
Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert: Benutzer> : Wenn das vom Benutzer explizit benachrichtigte System die empfohlene Aktion anwenden soll. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde. In diesem Fall hat das System ihn angewendet.
Name | Typ | Beschreibung |
---|---|---|
System |
string |
|
User |
string |
RecommendedActionMetricInfo
Enthält Eine Zeitreihe mit verschiedenen betroffenen Metriken für eine Azure SQL empfohlene Aktion für Datenbank, Server oder Pools für elastische Datenbanken.
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 Status einer Azure SQL empfohlenen Aktion Datenbank, Server oder Pool für elastische Datenbanken.
Name | Typ | Beschreibung |
---|---|---|
actionInitiatedBy |
Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Möglicher Wert: Benutzer> : Wenn das vom Benutzer explizit benachrichtigte System die empfohlene Aktion anwenden soll. System:> Wenn die automatische Ausführung status dieses Advisor auf "Aktiviert" festgelegt wurde. In diesem Fall hat das System ihn angewendet. |
|
currentValue |
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. |
|
lastModified |
string |
Ruft den Zeitpunkt ab, zu dem der Zustand zuletzt geändert wurde. |