Database Advisors - Update

Dienst:: SQL Database

API-Version:: 2025-01-01

Aktualisiert einen Datenbankratgeber.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/advisors/{advisorName}?api-version=2025-01-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 minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.autoExecuteStatus	True	AutoExecuteStatus	Ruft den Status der automatischen Ausführung (ob das System die Empfehlungen ausführen zu lassen) dieses Beraters ab. Mögliche Werte sind "Enabled" und "Disabled"

Antworten

Name	Typ	Beschreibung
200 OK	Advisor	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

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=2025-01-01

{
  "properties": {
    "autoExecuteStatus": "Disabled"
  }
}


import com.azure.resourcemanager.sql.fluent.models.AdvisorInner;
import com.azure.resourcemanager.sql.models.AutoExecuteStatus;

/**
 * Samples for DatabaseAdvisors Update.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-01-01/DatabaseAdvisorUpdate.json
     */
    /**
     * Sample code: Update database advisor.
     * 
     * @param manager Entry point to SqlServerManager.
     */
    public static void updateDatabaseAdvisor(com.azure.resourcemanager.sql.SqlServerManager manager) {
        manager.serviceClient().getDatabaseAdvisors().updateWithResponse("workloadinsight-demos", "misosisvr",
            "IndexAdvisor_test_3", "CreateIndex", new AdvisorInner().withAutoExecuteStatus(AutoExecuteStatus.DISABLED),
            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

from azure.identity import DefaultAzureCredential

from azure.mgmt.sql import SqlManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-sql
# USAGE
    python database_advisor_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SqlManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.database_advisors.update(
        resource_group_name="workloadinsight-demos",
        server_name="misosisvr",
        database_name="IndexAdvisor_test_3",
        advisor_name="CreateIndex",
        parameters={"properties": {"autoExecuteStatus": "Disabled"}},
    )
    print(response)


# x-ms-original-file: 2025-01-01/DatabaseAdvisorUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { SqlManagementClient } = require("@azure/arm-sql");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to updates a database advisor.
 *
 * @summary updates a database advisor.
 * x-ms-original-file: 2025-01-01/DatabaseAdvisorUpdate.json
 */
async function updateDatabaseAdvisor() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-1111-2222-3333-444444444444";
  const client = new SqlManagementClient(credential, subscriptionId);
  const result = await client.databaseAdvisors.update(
    "workloadinsight-demos",
    "misosisvr",
    "IndexAdvisor_test_3",
    "CreateIndex",
    { autoExecuteStatus: "Disabled" },
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/DatabaseAdvisorUpdate.json
// this example is just showing the usage of "DatabaseAdvisors_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseAdvisorResource created on azure
// for more information of creating SqlDatabaseAdvisorResource, please refer to the document of SqlDatabaseAdvisorResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "workloadinsight-demos";
string serverName = "misosisvr";
string databaseName = "IndexAdvisor_test_3";
string advisorName = "CreateIndex";
ResourceIdentifier sqlDatabaseAdvisorResourceId = SqlDatabaseAdvisorResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, advisorName);
SqlDatabaseAdvisorResource sqlDatabaseAdvisor = client.GetSqlDatabaseAdvisorResource(sqlDatabaseAdvisorResourceId);

// invoke the operation
SqlAdvisorData data = new SqlAdvisorData
{
    AutoExecuteStatus = AutoExecuteStatus.Disabled,
};
SqlDatabaseAdvisorResource result = await sqlDatabaseAdvisor.UpdateAsync(data);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlAdvisorData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
Advisor	Datenbank-, Server- oder Elastic Pool Advisor.
AdvisorStatus	Ruft den Status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview".
AutoExecuteStatus	Ruft den Status der automatischen Ausführung (ob das System die Empfehlungen ausführen zu lassen) dieses Beraters ab. Mögliche Werte sind "Enabled" und "Disabled"
AutoExecuteStatusInheritedFrom	Ruft die Ressource ab, von der der aktuelle Wert des Status der automatischen Ausführung geerbt wird. Der Status der automatischen Ausführung kann auf verschiedenen Ebenen in der Ressourcenhierarchie festgelegt (und von diesen geerbt werden). Mögliche Werte sind "Subscription", "Server", "ElasticPool", "Database" und "Default" (wenn der Status nicht explizit auf einer Ebene festgelegt ist).
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
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 werden kann und die empfohlene Aktion erneut ausgeführt werden kann. Mögliche Werte sind: Ja/Nein
RecommendedAction	Empfohlene Aktion für Datenbank, Server oder Elastic Pool.
RecommendedActionCurrentState	Aktueller Zustand, in dem die empfohlene Aktion aktiviert ist. Einige häufig verwendete Zustände sind: Aktiv -> empfohlene Aktion aktiv ist und noch keine Aktion ausgeführt wurde. Ausstehend –> empfohlene Aktion wird genehmigt und wartet auf die Ausführung. Ausführen –> empfohlene Aktion wird auf die Benutzerdatenbank angewendet. Überprüfen –> empfohlene Aktion wurde angewendet und wird vom System auf ihre Nützlichkeit überprüft. Erfolg –> empfohlene Aktion wurde während der Überprüfung angewendet und verbessert. Ausstehende Wiederherstellung –> Überprüfung wenig oder keine Verbesserung gefunden hat, sodass die empfohlene Aktion für die Wiederherstellung in die Warteschlange gestellt wird oder der Benutzer manuell zurückgesetzt wurde. Wiederherstellen –> Änderungen, die beim Anwenden empfohlener Aktionen vorgenommen wurden, werden in der Benutzerdatenbank wiederhergestellt. Wiederherstellen :> die änderungen, die von empfohlener Aktion in der Benutzerdatenbank vorgenommen wurden, erfolgreich zurückgesetzt. Ignoriert –> Benutzer die empfohlene Aktion explizit ignoriert/verworfen hat.
RecommendedActionErrorInfo	Enthält Fehlerinformationen für eine empfohlene Aktion der Azure SQL-Datenbank, eines Servers oder eines Elastic Pools.
RecommendedActionImpactRecord	Enthält Informationen über geschätzte oder beobachtete Auswirkungen auf verschiedene Metriken für eine empfohlene Maßnahme für eine Azure SQL-Datenbank, Server oder Elastic Pool.
RecommendedActionImplementationInfo	Enthält Informationen zur manuellen Implementierung einer empfohlenen Maßnahme für eine Azure SQL-Datenbank, Server oder Elastic Pool.
RecommendedActionInitiatedBy	Ruft ab, wenn die Genehmigung für die Anwendung dieser empfohlenen Aktion von Benutzer/System gegeben wurde.
RecommendedActionMetricInfo	Enthält Zeitreihen verschiedener betroffener Metriken für eine empfohlene Aktion der Azure SQL-Datenbank, eines Servers oder eines Elastic Pools.
RecommendedActionStateInfo	Enthält Informationen zum aktuellen Zustand einer empfohlenen Aktion für eine Azure SQL-Datenbank, Server oder Elastic Pool.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Advisor

Objekt

Datenbank-, Server- oder Elastic Pool Advisor.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Ressourcentyp.
location	string	Ressourcenspeicherort.
name	string	Der Name der Ressource
properties.advisorStatus	AdvisorStatus	Ruft den Status der Verfügbarkeit dieses Beraters für Kunden ab. Mögliche Werte sind "GA", "PublicPreview", "LimitedPublicPreview" und "PrivatePreview".
properties.autoExecuteStatus	AutoExecuteStatus	Ruft den Status der automatischen Ausführung (ob das System die Empfehlungen ausführen zu lassen) dieses Beraters ab. Mögliche Werte sind "Enabled" und "Disabled"
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Ruft die Ressource ab, von der der aktuelle Wert des Status der automatischen Ausführung geerbt wird. Der Status der automatischen Ausführung kann auf verschiedenen Ebenen in der Ressourcenhierarchie festgelegt (und von diesen geerbt werden). Mögliche Werte sind "Subscription", "Server", "ElasticPool", "Database" und "Default" (wenn der Status nicht explizit auf einer Ebene festgelegt ist).
properties.lastChecked	string (date-time)	Ruft den Zeitpunkt ab, zu dem die aktuelle Ressource von diesem Ratgeber auf Empfehlungen analysiert wurde.
properties.recommendationsStatus	string	Ruft diesen Status von Empfehlungen für diesen Ratgeber und Grund für keine Empfehlungen ab. Mögliche Werte umfassen, aber nicht beschränkt auf "Ok" (Empfehlungen verfügbar), LowActivity (nicht genügend Workload zu analysieren), "DbSeemsTuned" (Datenbank ist gut) usw.
properties.recommendedActions	RecommendedAction[]	Ruft die empfohlenen Aktionen für diesen Ratgeber ab.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten"

AdvisorStatus

Enumeration

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

Wert	Beschreibung
GA	GA
PublicPreview	PublicPreview
LimitedPublicPreview	LimitedPublicPreview
PrivatePreview	PrivatePreview

AutoExecuteStatus

Enumeration

Ruft den Status der automatischen Ausführung (ob das System die Empfehlungen ausführen zu lassen) dieses Beraters ab. Mögliche Werte sind "Enabled" und "Disabled"

Wert	Beschreibung
Enabled	Aktiviert
Disabled	Deaktiviert
Default	Vorgabe

AutoExecuteStatusInheritedFrom

Enumeration

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

Wert	Beschreibung
Default	Vorgabe
Subscription	Subscription
Server	Server
ElasticPool	ElasticPool (Englisch)
Database	Datenbank

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ImplementationMethod

Enumeration

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

Wert	Beschreibung
TSql	TSql
AzurePowerShell	AzurePowerShell

IsRetryable

Enumeration

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

Wert	Beschreibung
Yes	Ja
No	No

RecommendedAction

Objekt

Empfohlene Aktion für Datenbank, Server oder Elastic Pool.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Ressourcentyp.
location	string	Ressourcenspeicherort.
name	string	Der 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 Auswirkungsinformationen für diese empfohlene Aktion ab, z. B. geschätzte CPU-Verstärkung, Änderung des geschätzten Speicherplatzes
properties.executeActionDuration	string (duration)	Ruft die Zeit für die Anwendung dieser empfohlenen Aktion für die Benutzerressource ab. z. B. Zeitaufwand für die Indexerstellung
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Ruft ab, wenn die Genehmigung für die Anwendung dieser empfohlenen Aktion von Benutzer/System gegeben wurde.
properties.executeActionInitiatedTime	string (date-time)	Ruft die Zeit ab, zu der diese empfohlene Aktion für die Ausführung genehmigt wurde.
properties.executeActionStartTime	string (date-time)	Ruft die Zeit ab, zu der das System mit der Anwendung dieser empfohlenen Aktion auf die Benutzerressource begonnen hat. z. B. Startzeit für die Indexerstellung
properties.implementationDetails	RecommendedActionImplementationInfo	Ruft die Implementierungsdetails dieser empfohlenen Aktion ab, damit benutzer sie manuell anwenden können.
properties.isArchivedAction	boolean	Ruft ab, wenn diese empfohlene Aktion vor einiger Zeit vorgeschlagen wurde, aber der Benutzer hat dies ignoriert und das System eine neue empfohlene Aktion erneut hinzugefügt.
properties.isExecutableAction	boolean	Ruft ab, wenn diese empfohlene Aktion vom Benutzer umsetzbar ist.
properties.isRevertableAction	boolean	Ruft ab, wenn Änderungen, die von dieser empfohlenen Aktion angewendet werden, vom Benutzer wiederhergestellt werden können.
properties.lastRefresh	string (date-time)	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 beobachteten/tatsächlichen Auswirkungsinformationen für diese empfohlene Aktion ab, z. B. Tatsächliche CPU-Verstärkung, Tatsächliche Speicherplatzänderung
properties.recommendationReason	string	Ruft den Grund für die Empfehlung dieser Aktion ab. z.B. DuplicateIndex
properties.revertActionDuration	string (duration)	Ruft die Zeit für die Wiederherstellung von Änderungen dieser empfohlenen Aktion für die Benutzerressource ab. z. B. zeitaufwand für das Ablegen des erstellten Indexes.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Ruft ab, wenn die Genehmigung für die Wiederherstellung dieser empfohlenen Aktion von Benutzer/System gegeben wurde.
properties.revertActionInitiatedTime	string (date-time)	Ruft den Zeitpunkt ab, zu dem diese empfohlene Aktion für die Wiederherstellung genehmigt wurde.
properties.revertActionStartTime	string (date-time)	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. Die Uhrzeit, zu der die Indexablage ausgeführt wird.
properties.score	integer (int32)	Ruft die Auswirkungen dieser empfohlenen Aktion ab. Mögliche Werte sind 1 - Niedrige Auswirkungen, 2 - Mittlere Auswirkung und 3 - Hohe Auswirkung
properties.state	RecommendedActionStateInfo	Ruft die Informationen des aktuellen Zustands ab, in dem die empfohlene Aktion enthalten ist.
properties.timeSeries	RecommendedActionMetricInfo[]	Ruft die Zeitreiheninformationen der Metriken für diese empfohlene Aktion ab, z. B. CPU-Verbrauchszeitreihe
properties.validSince	string (date-time)	Ruft den Zeitpunkt ab, zu dem diese empfohlene Aktion gültig ist.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten"

RecommendedActionCurrentState

Enumeration

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

Wert	Beschreibung
Active	Aktiv
Pending	Ausstehend
Executing	Wird ausgeführt
Verifying	Verifizierung
PendingRevert	PendingRevert
RevertCancelled	RevertCancelled
Reverting	Rückgängig machen
Reverted	Zurückgesetzt
Ignored	Ignoriert
Expired	Abgelaufen
Monitoring	Überwachung
Resolved	Gelöst
Success	Success
Error	Fehler

RecommendedActionErrorInfo

Objekt

Enthält Fehlerinformationen für eine empfohlene Aktion der Azure SQL-Datenbank, eines Servers oder eines Elastic Pools.

Name	Typ	Beschreibung
errorCode	string	Ruft den Grund ab, warum die empfohlene Aktion auf den Fehlerzustand gesetzt wurde. z.B. DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Ruft ab, ob der Fehler ignoriert werden kann und die empfohlene Aktion erneut ausgeführt werden kann. Mögliche Werte sind: Ja/Nein

RecommendedActionImpactRecord

Objekt

Enthält Informationen über geschätzte oder beobachtete Auswirkungen auf verschiedene Metriken für eine empfohlene Maßnahme für eine Azure SQL-Datenbank, Server oder Elastic Pool.

Name	Typ	Beschreibung
absoluteValue	number (double)	Ruft den absoluten Wert dieser Dimension ab, falls zutreffend. z. B. Anzahl betroffener Abfragen
changeValueAbsolute	number (double)	Ruft die absolute Änderung des Werts dieser Dimension ab. z. B. absoluter Speicherplatzwechsel in Megabyte
changeValueRelative	number (double)	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

Objekt

Enthält Informationen zur manuellen Implementierung einer empfohlenen Maßnahme für eine Azure SQL-Datenbank, Server oder Elastic 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 kann.

RecommendedActionInitiatedBy

Enumeration

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

Wert	Beschreibung
User	Benutzer
System	System

RecommendedActionMetricInfo

Objekt

Enthält Zeitreihen verschiedener betroffener Metriken für eine empfohlene Aktion der Azure SQL-Datenbank, eines Servers oder eines Elastic Pools.

Name	Typ	Beschreibung
metricName	string	Ruft den Namen der Metrik ab. z. B. CPU, Anzahl der Abfragen.
startTime	string (date-time)	Ruft die Startzeit des Zeitintervalls ab, das von dieser MetricInfo angegeben wird.
timeGrain	string	Ruft die Dauer des Zeitintervalls für den von dieser MetricInfo angegebenen Wert ab. z.B. PT1H (1 Stunde)
unit	string	Ruft die Einheit ab, in der die Metrik gemessen wird. z.B. DTU, Frequenz
value	number (double)	Ruft den Wert der Metrik im von dieser MetricInfo angegebenen Zeitintervall ab.

RecommendedActionStateInfo

Objekt

Enthält Informationen zum aktuellen Zustand einer empfohlenen Aktion für eine Azure SQL-Datenbank, Server oder Elastic Pool.

Name	Typ	Beschreibung
actionInitiatedBy	RecommendedActionInitiatedBy	Ruft ab, wer die Ausführung dieser empfohlenen Aktion initiiert hat. Mögliche Werte sind: Benutzer -> Wenn das vom Benutzer explizit benachrichtigte System, um die empfohlene Aktion anzuwenden. System –> Wenn der Status der automatischen Ausführung dieses Beraters auf "Aktiviert" festgelegt wurde, in diesem Fall wurde es vom System angewendet.
currentValue	RecommendedActionCurrentState	Aktueller Zustand, in dem die empfohlene Aktion aktiviert ist. Einige häufig verwendete Zustände sind: Aktiv -> empfohlene Aktion aktiv ist und noch keine Aktion ausgeführt wurde. Ausstehend –> empfohlene Aktion wird genehmigt und wartet auf die Ausführung. Ausführen –> empfohlene Aktion wird auf die Benutzerdatenbank angewendet. Überprüfen –> empfohlene Aktion wurde angewendet und wird vom System auf ihre Nützlichkeit überprüft. Erfolg –> empfohlene Aktion wurde während der Überprüfung angewendet und verbessert. Ausstehende Wiederherstellung –> Überprüfung wenig oder keine Verbesserung gefunden hat, sodass die empfohlene Aktion für die Wiederherstellung in die Warteschlange gestellt wird oder der Benutzer manuell zurückgesetzt wurde. Wiederherstellen –> Änderungen, die beim Anwenden empfohlener Aktionen vorgenommen wurden, werden in der Benutzerdatenbank wiederhergestellt. Wiederherstellen :> die änderungen, die von empfohlener Aktion in der Benutzerdatenbank vorgenommen wurden, erfolgreich zurückgesetzt. Ignoriert –> Benutzer die empfohlene Aktion explizit ignoriert/verworfen hat.
lastModified	string (date-time)	Ruft den Zeitpunkt der letzten Änderung des Zustands ab.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.