Freigeben über


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
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.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.autoExecuteStatus True

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".

Antworten

Name Typ Beschreibung
200 OK

Advisor

Der angegebene Datenbankratgeber wurde erfolgreich aktualisiert.

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.

  • 400 InvalidAdvisorUpsertRequest: Der Anforderungstext des Update advisor ist nicht vorhanden oder weist kein properties-Objekt auf.

  • 400 InvalidAdvisorAutoExecuteStatus: Die angegebene status für die automatische Ausführung für den Advisor ist nicht zulässig.

  • 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.

  • 404 AutomaticTuningOptionNotFound: Die angeforderte automatische Optimierungsoption 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.

  • 409 DisabledBySystem: Diese Option ist vom System deaktiviert.

  • 409 DefaultAdvisorStateNotAllowedInCustomDbMode – DEFAULT advisor state is not allowed in CUSTOM mode

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

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.

AdvisorStatus

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

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".

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 Poolaktion für elastische Datenbanken.

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 Pool für elastische Datenbanken.

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.

RecommendedActionImplementationInfo

Enthält Informationen zur manuellen Implementierung einer Azure SQL empfohlenen Aktion für Datenbank, Server oder Pool für elastische Datenbanken.

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.

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.

RecommendedActionStateInfo

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

AdvisorStatus

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

properties.autoExecuteStatus

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

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

RecommendedAction[]

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

RecommendedActionErrorInfo

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

properties.estimatedImpact

RecommendedActionImpactRecord[]

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

RecommendedActionInitiatedBy

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

RecommendedActionImplementationInfo

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

RecommendedActionImpactRecord[]

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

RecommendedActionInitiatedBy

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

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 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

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

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 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

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.

currentValue

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.

lastModified

string

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