Server Advisors - Update

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

Mises à jour un conseiller de serveur.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
advisorName	path	True	string	Nom de l’Conseiller serveur.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
properties.autoExecuteStatus	True	AutoExecuteStatus	Obtient l’exécution automatique status (laisser le système exécuter les recommandations) de cet conseiller. Les valeurs possibles sont « Enabled » et « Disabled »

Réponses

Nom	Type	Description
200 OK	Advisor	Mise à jour réussie du conseiller de serveur spécifié.
Other Status Codes		Réponses d’erreur : *** 400 FeatureDisabledOnSelectedEdition : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée sur l’édition de base de données actuelle. 400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide. 400 DataWarehouseNotSupported : le paramétrage automatique n’est pas pris en charge pour sql Data Warehouse. 400 InvalidAdvisorUpsertRequest : le corps de la demande de conseiller de mise à jour n’existe pas ou n’a pas d’objet properties. 400 InvalidAdvisorAutoExecuteStatus : la status d’exécution automatique spécifiée pour le conseiller n’est pas autorisée. 404 DatabaseDoesNotExist : la base de données demandée est introuvable 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 SubscriptionDoesNotHaveElasticPool - Le pool élastique demandé est introuvable 404 AdvisorNotFound : le conseiller demandé est introuvable. 404 AutomaticTuningOptionNotFound : l’option de paramétrage automatique demandée est introuvable. 405 Non pris en charge : cette fonctionnalité n’est pas prise en charge. 409 Conflit : la demande n’a pas pu être traitée en raison d’un conflit dans la demande. 409 DefaultAdvisorStateNotAllowedInCustomServerMode - État du conseiller DEFAULT non autorisé en mode CUSTOM 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress : les paramètres de réglage automatique de la demande précédente n’ont pas été propagés à toutes les bases de données utilisateur. 503 ServiceTemporarilyUnavailable - Fonctionnalité temporairement indisponible.

Nom

Type

Description

200 OK

Advisor

Mise à jour réussie du conseiller de serveur spécifié.

Other Status Codes

Réponses d’erreur : ***

400 FeatureDisabledOnSelectedEdition : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée sur l’édition de base de données actuelle.
400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide.
400 DataWarehouseNotSupported : le paramétrage automatique n’est pas pris en charge pour sql Data Warehouse.
400 InvalidAdvisorUpsertRequest : le corps de la demande de conseiller de mise à jour n’existe pas ou n’a pas d’objet properties.
400 InvalidAdvisorAutoExecuteStatus : la status d’exécution automatique spécifiée pour le conseiller n’est pas autorisée.
404 DatabaseDoesNotExist : la base de données demandée est introuvable
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 SubscriptionDoesNotHaveElasticPool - Le pool élastique demandé est introuvable
404 AdvisorNotFound : le conseiller demandé est introuvable.
404 AutomaticTuningOptionNotFound : l’option de paramétrage automatique demandée est introuvable.
405 Non pris en charge : cette fonctionnalité n’est pas prise en charge.
409 Conflit : la demande n’a pas pu être traitée en raison d’un conflit dans la demande.
409 DefaultAdvisorStateNotAllowedInCustomServerMode - État du conseiller DEFAULT non autorisé en mode CUSTOM
409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress : les paramètres de réglage automatique de la demande précédente n’ont pas été propagés à toutes les bases de données utilisateur.
503 ServiceTemporarilyUnavailable - Fonctionnalité temporairement indisponible.

Exemples

Update server advisor

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

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


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

/**
 * Samples for ServerAdvisors Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAdvisorUpdate.json
     */
    /**
     * Sample code: Update server advisor.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateServerAdvisor(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAdvisors().updateWithResponse("workloadinsight-demos",
            "misosisvr", "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

Exemple de réponse

Code d’état:: 200

{
  "kind": "",
  "properties": {
    "advisorStatus": "GA",
    "autoExecuteStatus": "Disabled",
    "autoExecuteStatusInheritedFrom": "Server"
  },
  "location": "East Asia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex",
  "name": "CreateIndex",
  "type": "Microsoft.Sql/servers/advisors"
}

Définitions

Nom	Description
Advisor	Database, Server ou Elastic Pool Advisor.
AdvisorStatus	Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ».
AutoExecuteStatus	Obtient l’exécution automatique status (laisser le système exécuter les recommandations) de cet conseiller. Les valeurs possibles sont « Enabled » et « Disabled »
AutoExecuteStatusInheritedFrom	Obtient la ressource à partir de laquelle la valeur actuelle de status d’exécution automatique est héritée. L’exécution automatique des status peut être définie sur (et héritée à partir) de différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque status n’est défini explicitement à aucun niveau).
ImplementationMethod	Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. par exemple, TSql, AzurePowerShell.
IsRetryable	Obtient si l’erreur peut être ignorée et si l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non
RecommendedAction	Action recommandée pour la base de données, le serveur ou le pool élastique.
RecommendedActionCurrentState	État actuel de l’action recommandée. Certains états couramment utilisés sont : Actif :> l’action recommandée est active et aucune action n’a encore été effectuée. En attente :> l’action recommandée est approuvée pour et est en attente d’exécution. Exécution :> l’action recommandée est appliquée à la base de données utilisateur. Vérification :> l’action recommandée a été appliquée et est en cours de vérification de son utilité par le système. Réussite :> l’action recommandée a été appliquée et l’amélioration a été trouvée lors de la vérification. Restauration en attente :> la vérification a trouvé peu ou pas d’amélioration, donc l’action recommandée est mise en file d’attente pour rétablir ou l’utilisateur a rétabli manuellement. Restauration :> les modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> restauration réussie des modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :> l’utilisateur a explicitement ignoré/ignoré l’action recommandée.
RecommendedActionErrorInfo	Contient des informations d’erreur pour une action recommandée pour une base de données Azure SQL, un serveur ou un pool élastique.
RecommendedActionImpactRecord	Contient des informations sur l’impact estimé ou observé sur différentes métriques pour une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.
RecommendedActionImplementationInfo	Contient des informations pour l’implémentation manuelle d’une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.
RecommendedActionInitiatedBy	Obtient qui a initié l’exécution de cette action recommandée. La valeur possible est : Utilisateur -> Lorsque l’utilisateur avertit explicitement le système d’appliquer l’action recommandée. Système :> lorsque l’exécution automatique status de cet conseiller a été défini sur « Activé », auquel cas le système l’a appliqué.
RecommendedActionMetricInfo	Contient des séries chronologiques de différentes métriques impactées pour une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.
RecommendedActionStateInfo	Contient des informations sur l’état actuel d’une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.

Advisor

Object

Database, Server ou Elastic Pool Advisor.

Nom	Type	Description
id	string	ID de la ressource
kind	string	Type de ressource.
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.advisorStatus	AdvisorStatus	Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ».
properties.autoExecuteStatus	AutoExecuteStatus	Obtient l’exécution automatique status (laisser le système exécuter les recommandations) de cet conseiller. Les valeurs possibles sont « Enabled » et « Disabled »
properties.autoExecuteStatusInheritedFrom	AutoExecuteStatusInheritedFrom	Obtient la ressource à partir de laquelle la valeur actuelle de status d’exécution automatique est héritée. L’exécution automatique des status peut être définie sur (et héritée à partir) de différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque status n’est défini explicitement à aucun niveau).
properties.lastChecked	string	Obtient l’heure à laquelle la ressource actuelle a été analysée pour les recommandations par cet conseiller.
properties.recommendationsStatus	string	Obtient cette status de recommandations pour ce conseiller et la raison de ne pas en avoir. Les valeurs possibles incluent, sans s’y limiter, « Ok » (Recommandations disponibles), LowActivity (charge de travail insuffisante pour analyser), « DbSeemsTuned » (la base de données se porte bien), etc.
properties.recommendedActions	RecommendedAction[]	Obtient les actions recommandées pour cet conseiller.
type	string	Type de ressource.

AdvisorStatus

Enumeration

Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ».

Valeur	Description
GA
LimitedPublicPreview
PrivatePreview
PublicPreview

AutoExecuteStatus

Enumeration

Obtient l’exécution automatique status (laisser le système exécuter les recommandations) de cet conseiller. Les valeurs possibles sont « Enabled » et « Disabled »

Valeur	Description
Default
Disabled
Enabled

AutoExecuteStatusInheritedFrom

Enumeration

Obtient la ressource à partir de laquelle la valeur actuelle de status d’exécution automatique est héritée. L’exécution automatique des status peut être définie sur (et héritée à partir) de différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque status n’est défini explicitement à aucun niveau).

Valeur	Description
Database
Default
ElasticPool
Server
Subscription

ImplementationMethod

Enumeration

Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. par exemple, TSql, AzurePowerShell.

Valeur	Description
AzurePowerShell
TSql

IsRetryable

Enumeration

Obtient si l’erreur peut être ignorée et si l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non

Valeur	Description
No
Yes

RecommendedAction

Object

Action recommandée pour la base de données, le serveur ou le pool élastique.

Nom	Type	Description
id	string	ID de la ressource
kind	string	Type de ressource.
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.details	object	Obtient des détails supplémentaires spécifiques à cette action recommandée.
properties.errorDetails	RecommendedActionErrorInfo	Obtient les détails de l’erreur si et pourquoi cette action recommandée est placée à l’état d’erreur.
properties.estimatedImpact	RecommendedActionImpactRecord[]	Obtient les informations d’impact estimé pour cette action recommandée, par exemple, Gain de processeur estimé, Changement d’espace disque estimé
properties.executeActionDuration	string	Obtient le temps nécessaire pour appliquer cette action recommandée sur la ressource utilisateur. par exemple, le temps nécessaire à la création d’index
properties.executeActionInitiatedBy	RecommendedActionInitiatedBy	Obtient si l’approbation de l’application de cette action recommandée a été donnée par l’utilisateur/système.
properties.executeActionInitiatedTime	string	Obtient l’heure à laquelle cette action recommandée a été approuvée pour l’exécution.
properties.executeActionStartTime	string	Obtient l’heure à laquelle le système a commencé à appliquer cette action recommandée sur la ressource utilisateur. par exemple, heure de début de la création d’index
properties.implementationDetails	RecommendedActionImplementationInfo	Obtient les détails d’implémentation de cette action recommandée pour que l’utilisateur l’applique manuellement.
properties.isArchivedAction	boolean	Obtient si cette action recommandée a été suggérée il y a un certain temps, mais que l’utilisateur a choisi d’ignorer cette action et que le système a ajouté à nouveau une nouvelle action recommandée.
properties.isExecutableAction	boolean	Obtient si cette action recommandée peut être actionnable par l’utilisateur
properties.isRevertableAction	boolean	Obtient si les modifications appliquées par cette action recommandée peuvent être annulées par l’utilisateur
properties.lastRefresh	string	Obtient l’heure à laquelle cette action recommandée a été actualisée pour la dernière fois.
properties.linkedObjects	string[]	Obtient les objets liés, le cas échéant.
properties.observedImpact	RecommendedActionImpactRecord[]	Obtient les informations d’impact observé/réel pour cette action recommandée, par exemple, Gain réel du processeur, Modification réelle de l’espace disque
properties.recommendationReason	string	Obtient la raison pour laquelle vous recommandez cette action. par exemple, DuplicateIndex
properties.revertActionDuration	string	Obtient le temps nécessaire pour rétablir les modifications de cette action recommandée sur la ressource utilisateur. par exemple, le temps nécessaire à la suppression de l’index créé.
properties.revertActionInitiatedBy	RecommendedActionInitiatedBy	Obtient si l’approbation de la restauration de cette action recommandée a été donnée par l’utilisateur/système.
properties.revertActionInitiatedTime	string	Obtient l’heure à laquelle cette action recommandée a été approuvée pour la restauration.
properties.revertActionStartTime	string	Obtient l’heure à laquelle le système a commencé à rétablir les modifications de cette action recommandée sur la ressource utilisateur. par exemple, heure d’exécution de la suppression d’index.
properties.score	integer	Obtient l’impact de cette action recommandée. Les valeurs possibles sont 1 - Impact faible, 2 - Impact moyen et 3 - Impact élevé
properties.state	RecommendedActionStateInfo	Obtient les informations de l’état actuel dans lequel se trouve l’action recommandée.
properties.timeSeries	RecommendedActionMetricInfo[]	Obtient les informations de série chronologique des métriques pour cette action recommandée, par exemple, la série chronologique de consommation du processeur
properties.validSince	string	Obtient l’heure depuis laquelle cette action recommandée est valide.
type	string	Type de ressource.

RecommendedActionCurrentState

Enumeration

État actuel de l’action recommandée. Certains états couramment utilisés sont : Actif :> l’action recommandée est active et aucune action n’a encore été effectuée. En attente :> l’action recommandée est approuvée pour et est en attente d’exécution. Exécution :> l’action recommandée est appliquée à la base de données utilisateur. Vérification :> l’action recommandée a été appliquée et est en cours de vérification de son utilité par le système. Réussite :> l’action recommandée a été appliquée et l’amélioration a été trouvée lors de la vérification. Restauration en attente :> la vérification a trouvé peu ou pas d’amélioration, donc l’action recommandée est mise en file d’attente pour rétablir ou l’utilisateur a rétabli manuellement. Restauration :> les modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> restauration réussie des modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :> l’utilisateur a explicitement ignoré/ignoré l’action recommandée.

Valeur	Description
Active
Error
Executing
Expired
Ignored
Monitoring
Pending
PendingRevert
Resolved
RevertCancelled
Reverted
Reverting
Success
Verifying

RecommendedActionErrorInfo

Object

Contient des informations d’erreur pour une action recommandée pour une base de données Azure SQL, un serveur ou un pool élastique.

Nom	Type	Description
errorCode	string	Obtient la raison pour laquelle l’action recommandée a été placée à l’état d’erreur. par exemple, DatabaseHasQdsOff, IndexAlreadyExists
isRetryable	IsRetryable	Obtient si l’erreur peut être ignorée et si l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non

RecommendedActionImpactRecord

Object

Contient des informations sur l’impact estimé ou observé sur différentes métriques pour une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.

Nom	Type	Description
absoluteValue	number	Obtient la valeur absolue de cette dimension, le cas échéant. par exemple, nombre de requêtes affectées
changeValueAbsolute	number	Obtient la modification absolue de la valeur de cette dimension. par exemple, modification de l’espace disque absolu en mégaoctets
changeValueRelative	number	Obtient la modification relative de la valeur de cette dimension. par exemple, modification de l’espace disque relatif en pourcentage
dimensionName	string	Obtient le nom de la dimension d’impact. par exemple, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.
unit	string	Obtient le nom de la dimension d’impact. par exemple, CPUChange, DiskSpaceChange, NumberOfQueriesAffected.

RecommendedActionImplementationInfo

Object

Contient des informations pour l’implémentation manuelle d’une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.

Nom	Type	Description
method	ImplementationMethod	Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. par exemple, TSql, AzurePowerShell.
script	string	Obtient le script d’implémentation manuelle. par exemple, un script T-SQL qui peut être exécuté sur la base de données.

RecommendedActionInitiatedBy

Enumeration

Obtient qui a initié l’exécution de cette action recommandée. La valeur possible est : Utilisateur -> Lorsque l’utilisateur avertit explicitement le système d’appliquer l’action recommandée. Système :> lorsque l’exécution automatique status de cet conseiller a été défini sur « Activé », auquel cas le système l’a appliqué.

Valeur	Description
System
User

RecommendedActionMetricInfo

Object

Contient des séries chronologiques de différentes métriques impactées pour une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.

Nom	Type	Description
metricName	string	Obtient le nom de la métrique. par exemple, processeur, nombre de requêtes.
startTime	string	Obtient l’heure de début de l’intervalle de temps donné par ce MetricInfo.
timeGrain	string	Obtient la durée de l’intervalle de temps pour la valeur donnée par ce MetricInfo. par exemple, PT1H (1 heure)
unit	string	Obtient l’unité dans laquelle la métrique est mesurée. par exemple, DTU, Fréquence
value	number	Obtient la valeur de la métrique dans l’intervalle de temps donné par ce MetricInfo.

RecommendedActionStateInfo

Object

Contient des informations sur l’état actuel d’une action recommandée de base de données, de serveur ou de pool élastique Azure SQL.

Nom	Type	Description
actionInitiatedBy	RecommendedActionInitiatedBy	Obtient qui a initié l’exécution de cette action recommandée. La valeur possible est : Utilisateur -> Lorsque l’utilisateur avertit explicitement le système d’appliquer l’action recommandée. Système :> lorsque l’exécution automatique status de cet conseiller a été défini sur « Activé », auquel cas le système l’a appliqué.
currentValue	RecommendedActionCurrentState	État actuel de l’action recommandée. Certains états couramment utilisés sont : Actif :> l’action recommandée est active et aucune action n’a encore été effectuée. En attente :> l’action recommandée est approuvée pour et est en attente d’exécution. Exécution :> l’action recommandée est appliquée à la base de données utilisateur. Vérification :> l’action recommandée a été appliquée et est en cours de vérification de son utilité par le système. Réussite :> l’action recommandée a été appliquée et l’amélioration a été trouvée lors de la vérification. Restauration en attente :> la vérification a trouvé peu ou pas d’amélioration, donc l’action recommandée est mise en file d’attente pour rétablir ou l’utilisateur a rétabli manuellement. Restauration :> les modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> restauration réussie des modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :> l’utilisateur a explicitement ignoré/ignoré l’action recommandée.
lastModified	string	Obtient l’heure à laquelle l’état a été modifié pour la dernière fois

Partager via

Server Advisors - Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Update server advisor

Exemple de requête

Exemple de réponse

Définitions

Advisor

AdvisorStatus

AutoExecuteStatus

AutoExecuteStatusInheritedFrom

ImplementationMethod

IsRetryable

RecommendedAction

RecommendedActionCurrentState

RecommendedActionErrorInfo

RecommendedActionImpactRecord

RecommendedActionImplementationInfo

RecommendedActionInitiatedBy

RecommendedActionMetricInfo

RecommendedActionStateInfo

Ressources supplémentaires