explainworkload : Explication des charges de travail de requête

Une fois que vous avez transmis à l'API explainworkload le nom d'une charge de travail de requête, l'API explique la charge de travail de requête et renvoie le nombre d'instructions qu'elle a expliquées.

Paramètres d'entrée

Transmettez à l'API les paires de clés et de valeurs suivantes en utilisant l'URL : https://localhost/tuning/explainworkload

Tableau 1. Paramètres d'entrée
Clé Valeur Valeurs admises
dbType Type de serveur de données. ZOS
dbHost Hôte du serveur de données. Nom du domaine ou adresse IP.
dbPort Numéro de port du serveur de données.  
dbName Nom du serveur de données.  
dbUser ID à utiliser lors de la connexion au serveur de données.  
dbPassword Mot de passe à utiliser lors d'une connexion au serveur de données.  
workloadName Nom de la charge de travail de requête à expliquer.  
schema Schéma du processus EXPLAIN à utiliser pour les objets non habilités dans les instructions SQL. Cette valeur remplace la valeur définie dans le fichier tuning_service.properties.  

Paramètres de sortie

L'API renvoie les paires de clés et de valeurs suivantes :

Tableau 2. Paramètres de sortie
Clé Valeur
code Code retour de l'API Web.
0
Exécution sans avertissements
4
Exécution avec des avertissements
8
Arrêt avant la fin de l'exécution en raison d'une erreur
output Nombre d'instructions SQL que l'API a expliquées. Ce nombre est inférieur au nombre d'instructions figurant dans la charge de travail de requête si l'une des instructions n'est pas explicable.
message Messages d'erreur ou d'avertissement.
exception Informations sur l'exception, le cas échéant. Ces informations peuvent être utiles au service de support IBM si vous le contactez pour résoudre un problème.

Exemple

Cet exemple utilise cURL pour transmettre le nom d'une charge de travail de requête à l'API explainworkload, qui renvoie le nombre d'instructions SQL qu'elle a expliquées.

Entrée
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
   dbType:ZOS,
   dbHost:hôte,
   dbPort:numéro_port,
   dbName:sous-système,
   dbUser:ID_utilisateur,
   dbPassword:mot_de_passe,
   workloadName:Sample_Workload,
   }"
https://localhost/tuning/explainworkload
Sortie
{ 
"code":0
}

Feedback