Database Advisors - Get
Obtient un conseiller de base de données.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/advisors/{advisorName}?api-version=2025-01-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
advisor
|
path | True |
string |
Nom de l’Assistant Base de données. |
|
database
|
path | True |
string |
Nom de la base de données. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
server
|
path | True |
string |
Le nom du serveur |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération Azure terminée avec succès. |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Get database advisor
Exemple de requête
GET 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
Exemple de réponse
{
"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"
}
}
Définitions
| Nom | Description |
|---|---|
| Advisor |
Assistant Base de données, serveur ou pool élastique. |
|
Advisor |
Obtient l’état de disponibilité de ce conseiller aux clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ». |
|
Auto |
Obtient l’état d’exécution automatique (s’il faut laisser le système exécuter les recommandations) de ce conseiller. Les valeurs possibles sont « Enabled » et « Disabled » |
|
Auto |
Obtient la ressource à partir de laquelle la valeur actuelle de l’état d’exécution automatique est héritée. L’état d’exécution automatique peut être défini sur (et hérité de) différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque l’état n’est pas défini explicitement sur n’importe quel niveau). |
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Implementation |
Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. Par exemple, TSql, AzurePowerShell. |
|
Is |
Obtient si l’erreur peut être ignorée et que l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non |
|
Recommended |
Action recommandée pour la base de données, le serveur ou le pool élastique. |
|
Recommended |
État actuel dans lequel se trouve l’action recommandée. Certains états couramment utilisés sont : Actif -> action recommandée est active et aucune action n’a encore été effectuée. En attente :> action recommandée est approuvée et attend l’exécution. Exécution :> action recommandée est appliquée à la base de données utilisateur. Vérification :> action recommandée a été appliquée et est vérifiée de son utilité par le système. Réussite :> action recommandée a été appliquée et une amélioration a été trouvée lors de la vérification. Restauration en attente :> vérification a trouvé peu ou pas d’amélioration afin que l’action recommandée soit mise en file d’attente pour le rétablissement ou l’utilisateur a rétabli manuellement. Restauration :> modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> a rétabli les modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :>'utilisateur a explicitement ignoré/ignoré l’action recommandée. |
|
Recommended |
Contient des informations d’erreur pour une action recommandée d’Azure SQL Database, Server ou Elastic Pool. |
|
Recommended |
Contient des informations sur l’impact estimé ou observé sur divers indicateurs pour une action recommandée de Azure SQL Database, Server ou Elastic Pool. |
|
Recommended |
Contient des informations pour l’implémentation manuelle d’une action recommandée Azure SQL Database, Server ou Elastic Pool. |
|
Recommended |
Obtient si l’approbation de l’application de cette action recommandée a été donnée par l’utilisateur/le système. |
|
Recommended |
Contient des séries temporelles de diverses métriques impactées pour une action recommandée dans Azure SQL Database, Server ou Elastic Pool. |
|
Recommended |
Contient des informations sur l’état actuel pour une action recommandée dans Azure SQL Database, Server ou Elastic Pool. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
Advisor
Assistant Base de données, serveur ou pool élastique.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| kind |
string |
Type de ressource. |
| location |
string |
Emplacement des ressources. |
| name |
string |
Nom de la ressource |
| properties.advisorStatus |
Obtient l’état de disponibilité de ce conseiller aux clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ». |
|
| properties.autoExecuteStatus |
Obtient l’état d’exécution automatique (s’il faut laisser le système exécuter les recommandations) de ce conseiller. Les valeurs possibles sont « Enabled » et « Disabled » |
|
| properties.autoExecuteStatusInheritedFrom |
Obtient la ressource à partir de laquelle la valeur actuelle de l’état d’exécution automatique est héritée. L’état d’exécution automatique peut être défini sur (et hérité de) différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque l’état n’est pas défini explicitement sur n’importe quel niveau). |
|
| properties.lastChecked |
string (date-time) |
Obtient l’heure à laquelle la ressource actuelle a été analysée pour les recommandations de ce conseiller. |
| properties.recommendationsStatus |
string |
Obtient cet état des recommandations pour ce conseiller et la raison de ne pas avoir de recommandations. Les valeurs possibles incluent, mais ne sont pas limitées à « Ok » (Recommandations disponibles), LowActivity (charge de travail insuffisante pour analyser), « DbSeemsTuned » (Base de données fait bien), etc. |
| properties.recommendedActions |
Obtient les actions recommandées pour ce conseiller. |
|
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
AdvisorStatus
Obtient l’état de disponibilité de ce conseiller aux clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ».
| Valeur | Description |
|---|---|
| GA |
GA |
| PublicPreview |
PublicPreview |
| LimitedPublicPreview |
Aperçu LimitedPublicPreview |
| PrivatePreview |
PrivatePreview |
AutoExecuteStatus
Obtient l’état d’exécution automatique (s’il faut laisser le système exécuter les recommandations) de ce conseiller. Les valeurs possibles sont « Enabled » et « Disabled »
| Valeur | Description |
|---|---|
| Enabled |
Activé |
| Disabled |
Désactivé |
| Default |
Par défaut |
AutoExecuteStatusInheritedFrom
Obtient la ressource à partir de laquelle la valeur actuelle de l’état d’exécution automatique est héritée. L’état d’exécution automatique peut être défini sur (et hérité de) différents niveaux dans la hiérarchie des ressources. Les valeurs possibles sont « Subscription », « Server », « ElasticPool », « Database » et « Default » (lorsque l’état n’est pas défini explicitement sur n’importe quel niveau).
| Valeur | Description |
|---|---|
| Default |
Par défaut |
| Subscription |
Subscription |
| Server |
Serveur |
| ElasticPool |
ElasticPool |
| Database |
Base de données |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom | Type | Description |
|---|---|---|
| info |
object |
Informations supplémentaires. |
| type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
ImplementationMethod
Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. Par exemple, TSql, AzurePowerShell.
| Valeur | Description |
|---|---|
| TSql |
TSql |
| AzurePowerShell |
AzurePowerShell |
IsRetryable
Obtient si l’erreur peut être ignorée et que l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non
| Valeur | Description |
|---|---|
| Yes |
Oui |
| No |
Non |
RecommendedAction
Action recommandée pour la base de données, le serveur ou le pool élastique.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| kind |
string |
Type de ressource. |
| location |
string |
Emplacement des ressources. |
| name |
string |
Nom de la ressource |
| properties.details |
object |
Obtient des détails supplémentaires spécifiques à cette action recommandée. |
| properties.errorDetails |
Obtient les détails de l’erreur si et pourquoi cette action recommandée est mise à l’état d’erreur. |
|
| properties.estimatedImpact |
Obtient les informations d’impact estimées pour cette action recommandée, par exemple, Gain estimé du processeur, Modification estimée de l’espace disque |
|
| properties.executeActionDuration |
string (duration) |
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 |
Obtient si l’approbation de l’application de cette action recommandée a été donnée par l’utilisateur/le système. |
|
| properties.executeActionInitiatedTime |
string (date-time) |
Obtient l’heure à laquelle cette action recommandée a été approuvée pour l’exécution. |
| properties.executeActionStartTime |
string (date-time) |
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 |
Obtient les détails de l’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 l’utilisateur a choisi d’ignorer cette action et le système a ajouté une nouvelle action recommandée à nouveau. |
| 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 (date-time) |
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 |
Obtient les informations d’impact observées/réelles pour cette action recommandée, par exemple, gain réel du processeur, modification de l’espace disque réel |
|
| properties.recommendationReason |
string |
Obtient la raison de recommander cette action. Par exemple, DuplicateIndex |
| properties.revertActionDuration |
string (duration) |
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 |
Obtient si l’approbation de la restauration de cette action recommandée a été donnée par l’utilisateur/le système. |
|
| properties.revertActionInitiatedTime |
string (date-time) |
Obtient l’heure à laquelle cette action recommandée a été approuvée pour restauration. |
| properties.revertActionStartTime |
string (date-time) |
Obtient l’heure à laquelle le système a commencé à rétablir les modifications de cette action recommandée sur la ressource utilisateur. Par exemple, l’heure d’exécution de la suppression d’index. |
| properties.score |
integer (int32) |
Obtient l’impact de cette action recommandée. Les valeurs possibles sont 1 - Impact faible, 2 - Impact moyen et 3 - Impact élevé |
| properties.state |
Obtient les informations de l’état actuel dans lequel se trouve l’action recommandée. |
|
| properties.timeSeries |
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 (date-time) |
Obtient l’heure depuis laquelle cette action recommandée est valide. |
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
RecommendedActionCurrentState
État actuel dans lequel se trouve l’action recommandée. Certains états couramment utilisés sont : Actif -> action recommandée est active et aucune action n’a encore été effectuée. En attente :> action recommandée est approuvée et attend l’exécution. Exécution :> action recommandée est appliquée à la base de données utilisateur. Vérification :> action recommandée a été appliquée et est vérifiée de son utilité par le système. Réussite :> action recommandée a été appliquée et une amélioration a été trouvée lors de la vérification. Restauration en attente :> vérification a trouvé peu ou pas d’amélioration afin que l’action recommandée soit mise en file d’attente pour le rétablissement ou l’utilisateur a rétabli manuellement. Restauration :> modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> a rétabli les modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :>'utilisateur a explicitement ignoré/ignoré l’action recommandée.
| Valeur | Description |
|---|---|
| Active |
Activé |
| Pending |
En attente |
| Executing |
Exécution |
| Verifying |
Vérification |
| PendingRevert |
PendingRevert |
| RevertCancelled |
RevertCancelled |
| Reverting |
Retour en arrière |
| Reverted |
Réédité |
| Ignored |
Ignoré |
| Expired |
Expiré |
| Monitoring |
Supervision |
| Resolved |
Résolu |
| Success |
Success |
| Error |
Error |
RecommendedActionErrorInfo
Contient des informations d’erreur pour une action recommandée d’Azure SQL Database, Server ou Elastic Pool.
| Nom | Type | Description |
|---|---|---|
| errorCode |
string |
Obtient la raison pour laquelle l’action recommandée a été mise à l’état d’erreur. Par exemple, DatabaseHasQdsOff, IndexAlreadyExists |
| isRetryable |
Obtient si l’erreur peut être ignorée et que l’action recommandée peut être retentée. Les valeurs possibles sont les suivantes : Oui/Non |
RecommendedActionImpactRecord
Contient des informations sur l’impact estimé ou observé sur divers indicateurs pour une action recommandée de Azure SQL Database, Server ou Elastic Pool.
| Nom | Type | Description |
|---|---|---|
| absoluteValue |
number (double) |
Obtient la valeur absolue de cette dimension le cas échéant. Par exemple, nombre de requêtes affectées |
| changeValueAbsolute |
number (double) |
Obtient la modification absolue de la valeur de cette dimension. Par exemple, changement d’espace disque absolu en mégaoctets |
| changeValueRelative |
number (double) |
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
Contient des informations pour l’implémentation manuelle d’une action recommandée Azure SQL Database, Server ou Elastic Pool.
| Nom | Type | Description |
|---|---|---|
| method |
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
Obtient si l’approbation de l’application de cette action recommandée a été donnée par l’utilisateur/le système.
| Valeur | Description |
|---|---|
| User |
Utilisateur |
| System |
Système |
RecommendedActionMetricInfo
Contient des séries temporelles de diverses métriques impactées pour une action recommandée dans Azure SQL Database, Server ou Elastic Pool.
| Nom | Type | Description |
|---|---|---|
| metricName |
string |
Obtient le nom de la métrique. Par exemple, processeur, nombre de requêtes. |
| startTime |
string (date-time) |
Obtient l’heure de début de l’intervalle de temps donné par cette MetricInfo. |
| timeGrain |
string |
Obtient la durée de l’intervalle de temps pour la valeur donnée par cette MetricInfo. par exemple, PT1H (1 heure) |
| unit |
string |
Obtient l’unité dans laquelle la métrique est mesurée. par exemple, DTU, Frequency |
| value |
number (double) |
Obtient la valeur de la métrique dans l’intervalle de temps donné par cette MetricInfo. |
RecommendedActionStateInfo
Contient des informations sur l’état actuel pour une action recommandée dans Azure SQL Database, Server ou Elastic Pool.
| Nom | Type | Description |
|---|---|---|
| actionInitiatedBy |
Obtient qui a lancé l’exécution de cette action recommandée. La valeur possible est : Utilisateur -> Lorsque le système averti explicite par l’utilisateur doit appliquer l’action recommandée. Système -> Lorsque l’état d’exécution automatique de ce conseiller a été défini sur « Activé », auquel cas le système l’a appliqué. |
|
| currentValue |
État actuel dans lequel se trouve l’action recommandée. Certains états couramment utilisés sont : Actif -> action recommandée est active et aucune action n’a encore été effectuée. En attente :> action recommandée est approuvée et attend l’exécution. Exécution :> action recommandée est appliquée à la base de données utilisateur. Vérification :> action recommandée a été appliquée et est vérifiée de son utilité par le système. Réussite :> action recommandée a été appliquée et une amélioration a été trouvée lors de la vérification. Restauration en attente :> vérification a trouvé peu ou pas d’amélioration afin que l’action recommandée soit mise en file d’attente pour le rétablissement ou l’utilisateur a rétabli manuellement. Restauration :> modifications apportées lors de l’application de l’action recommandée sont rétablies sur la base de données utilisateur. Rétabli :> a rétabli les modifications apportées par l’action recommandée sur la base de données utilisateur. Ignoré :>'utilisateur a explicitement ignoré/ignoré l’action recommandée. |
|
| lastModified |
string (date-time) |
Obtient l’heure de la dernière modification de l’état |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |