Tous les produits
Search
Centre de documentation

:GetInstanceSqlOptimizeStatistic

Dernière mise à jour :Aug 06, 2026

Consulte les statistiques sur les événements d'optimisation SQL automatique sur une période donnée, telles que le nombre total d'événements d'optimisation et l'amélioration maximale.

Description de l'opération

Avant d'appeler cette opération, prenez note des éléments suivants :

  • Si vous utilisez un SDK Alibaba Cloud ou un SDK Database Autonomy Service (DAS) pour appeler cette opération d'API, nous vous recommandons d'utiliser la dernière version du SDK.

  • Si vous utilisez un SDK pour appeler les opérations d'API de DAS, vous devez définir l'identifiant de la région sur cn-shanghai.

  • Le moteur de base de données est ApsaraDB RDS for MySQL ou PolarDB for MySQL.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

hdm:GetInstanceSqlOptimizeStatistic

get

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

InstanceId

string

Oui

L'identifiant de l'instance de base de données.

Remarque

L'instance de base de données doit être une instance ApsaraDB RDS for MySQL ou un cluster PolarDB for MySQL.

pc-wz90h9560rvdz****

StartTime

string

Oui

Le début de la plage de temps à interroger. Définissez ce paramètre sur un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.

1661308902060

EndTime

string

Oui

La fin de la plage de temps à interroger. Définissez ce paramètre sur un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC.

1662518540764

NodeId

string

Non

L'identifiant du nœud.

Remarque

Pour les instances ApsaraDB RDS for MySQL Cluster Edition ou les clusters PolarDB for MySQL, vous devez spécifier l'identifiant du nœud.

pi-bp12v7243x012****

Threshold

string

Non

Le seuil de durée pour les événements d'optimisation SQL automatique. Une fois ce paramètre spécifié, le système collecte des statistiques sur les événements d'optimisation SQL automatique dont la durée ne dépasse pas le seuil spécifié.

Remarque

Ce paramètre est un paramètre réservé et n'est pas pris en compte.

None

FilterEnable

string

Non

Indique si les instances pour lesquelles DAS Enterprise Edition est activée doivent être filtrées. Valeurs valides :

  • true

  • false

Remarque

Si vous définissez ce paramètre sur true, seules les instances de base de données pour lesquelles DAS Enterprise Edition est désactivée sont interrogées. Si vous définissez ce paramètre sur false, toutes les instances de base de données sont interrogées.

false

UseMerging

string

Non

Indique si les événements d'optimisation SQL automatique doivent être fusionnés. Valeurs valides :

  • true : fusionne les événements d'optimisation SQL automatique.

  • false : ne fusionne pas les événements d'optimisation SQL automatique.

Remarque

Ce paramètre est un paramètre réservé et n'est pas pris en compte.

true

Éléments de réponse

Élément

Type

Description

Exemple

object

Les données renvoyées.

Code

string

Le code d'état HTTP renvoyé.

200

Message

string

Le message renvoyé.

Remarque

Si la requête a réussi, Successful est renvoyé. Si la requête a échoué, un message d'erreur tel qu'un code d'erreur est renvoyé.

Successful

Data

object

Les détails des événements d'optimisation SQL automatique.

count

integer

Le nombre total d'événements d'optimisation SQL automatique.

16

improvement

number

Le multiple de l'amélioration maximale pour les événements d'optimisation SQL automatique renvoyés.

1003

RequestId

string

L'identifiant de la requête.

B6D17591-B48B-4D31-9CD6-9B9796B2****

Success

string

Indique si la requête a réussi. Valeurs valides :

  • true : la requête a réussi.

  • false : la requête a échoué.

true

Exemples

JSON format

{
  "Code": "200",
  "Message": "Successful",
  "Data": {
    "count": 16,
    "improvement": 1003
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParams The request parameters are invalid.
403 NoPermission You are not authorized to do this action.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.