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=2021-11-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
advisor
|
path | True |
string |
Nom de l’Assistant de base de données. |
database
|
path | True |
string |
Nom de la base de données. |
resource
|
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. |
server
|
path | True |
string |
Le nom du serveur |
subscription
|
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. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Récupération réussie des détails de l’assistant de base de données spécifié. |
|
Other Status Codes |
Réponses d’erreur : ***
|
Exemples
Get database advisor
Sample Request
Sample Response
{
"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"
}
}
Définitions
Nom | Description |
---|---|
Advisor |
Database, Server ou Elastic Pool Advisor. |
Advisor |
Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ». |
Auto |
Obtient l’exécution automatique status (laisser le système exécuter les recommandations) de cet conseiller. Les valeurs possibles sont « Enabled » et « Disabled » |
Auto |
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). |
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 si 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 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. |
Recommended |
Contient des informations d’erreur pour une action recommandée pour une base de données Azure SQL, un serveur ou un pool élastique. |
Recommended |
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. |
Recommended |
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. |
Recommended |
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é. |
Recommended |
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. |
Recommended |
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
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 |
Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ». |
|
properties.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 |
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 |
Obtient les actions recommandées pour cet conseiller. |
|
type |
string |
Type de ressource. |
AdvisorStatus
Obtient la status de disponibilité de ce conseiller pour les clients. Les valeurs possibles sont « GA », « PublicPreview », « LimitedPublicPreview » et « PrivatePreview ».
Nom | Type | Description |
---|---|---|
GA |
string |
|
LimitedPublicPreview |
string |
|
PrivatePreview |
string |
|
PublicPreview |
string |
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 »
Nom | Type | Description |
---|---|---|
Default |
string |
|
Disabled |
string |
|
Enabled |
string |
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).
Nom | Type | Description |
---|---|---|
Database |
string |
|
Default |
string |
|
ElasticPool |
string |
|
Server |
string |
|
Subscription |
string |
ImplementationMethod
Obtient la méthode dans laquelle cette action recommandée peut être implémentée manuellement. par exemple, TSql, AzurePowerShell.
Nom | Type | Description |
---|---|---|
AzurePowerShell |
string |
|
TSql |
string |
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
Nom | Type | Description |
---|---|---|
No |
string |
|
Yes |
string |
RecommendedAction
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 |
Obtient les détails de l’erreur si et pourquoi cette action recommandée est placée à l’état d’erreur. |
|
properties.estimatedImpact |
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 |
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 |
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 |
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 |
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 |
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 |
Obtient l’heure depuis laquelle cette action recommandée est valide. |
type |
string |
Type de ressource. |
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.
Nom | Type | Description |
---|---|---|
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
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 |
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
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
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 |
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 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é.
Nom | Type | Description |
---|---|---|
System |
string |
|
User |
string |
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.
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
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 |
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 |
É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 |