Transmettez à l'API les paires de clés et de valeurs suivantes en utilisant l'URL : https://localhost/tuning/compareworkload
| Catégorie | Clé | Valeur | Valeurs admises | Facultatif ? |
|---|---|---|---|---|
| Connexion 1 | dbType | Type de serveur de données. | ZOS | Non |
| dbHost | Hôte du serveur de données. | Nom du domaine ou adresse IP. | Non | |
| dbPort | Numéro de port du serveur de données. | Non | ||
| dbName | Nom du serveur de données. | Non | ||
| dbUser | ID à utiliser lors de la connexion au serveur de données. | Non | ||
| dbPassword | Mot de passe à utiliser lors d'une connexion au serveur de données. | Non | ||
| Connexion 2 | dbHost2 | Hôte du serveur de données. | Pour les comparaisons de type 3 uniquement. | |
| dbPort2 | Numéro de port du serveur de données. | Pour les comparaisons de type 3 uniquement. | ||
| dbName2 | Nom du serveur de données. | Pour les comparaisons de type 3 uniquement. | ||
| dbUser2 | ID à utiliser lors de la connexion au serveur de données. | Pour les comparaisons de type 3 uniquement. | ||
| dbPassword2 | Mot de passe à utiliser lors d'une connexion au serveur de données. | Pour les comparaisons de type 3 uniquement. | ||
| Charges de travail de requête | workload | Nom de la charge de travail de requête associée à l'image instantanée EXPLAIN antérieure à utiliser lors de la comparaison. | Non | |
| workload2 | Nom de la charge de travail de requête associée à l'image instantanée EXPLAIN ultérieure à utiliser lors de la comparaison. Le nom peut correspondre au premier nom si vous souhaitez comparer deux images instantanées EXPLAIN d'une même charge de travail de requête. | Pour les comparaisons de type 1 et 2 uniquement. | ||
| Options de filtrage des instructions SQL | apChanged | Indique que le système doit afficher les instructions SQL dont les plans d'accès ont été modifiés. | true ou false. Il n'y a pas de distinction entre les majuscules et les minuscules. | Oui |
| costRegressed | Demande d'afficher les instructions SQL dont l'augmentation des coûts estimés est supérieure ou égale au pourcentage indiqué. | Entier compris entre 0 et 100. | ||
| operator | Indique si le système doit afficher les instructions SQL correspondant à la valeur définie pour les deux clés apChanged et costRegressed ou afficher les instructions SQL correspondant à la valeur définie pour l'une de ces clés. | and ou or. Il n'y a pas de distinction entre les majuscules et les minuscules. | and |
L'API renvoie les paires de clés et de valeurs suivantes :
| Clé | Valeur |
|---|---|
| code | Code retour de l'API Web.
|
| state |
|
| link | URL du rapport qui compare les plans d'accès des deux images instantanées EXPLAIN. Par défaut, le lien expire au bout de sept jours. Vous pouvez modifier cette durée dans le fichier tuning_service.properties. |
| output | Nombre d'instructions SQL répondant aux critères de filtrage et pour lesquelles le rapport contient des informations. |
| 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. |
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,
workload:Sample_Workload_1,
apChanged:\"true\"
costRegressed:30,
operator:\"and\"
}"
https://localhost/tuning/compareworkload
{
"code" :4 ,
"state" :2,
"output" :"11" ,
"link" :"http://localhost:8080/tuning/download/wapc/1394687451884-
14798931739894/ComparisonReport_1.html"}
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,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:20,
apChanged:\"true\"
}"
https://localhost/tuning/compareworkload
La sortie de l'API est identique à la sortie présentée à l'exemple 1.
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:hôte_de_la_dernière_connexion,
dbPort:numéro_port,
dbName:sous-système,
dbUser:ID_utilisateur,
dbPassword:mot_de_passe,
dbHost2:hôte_de_la_seconde_connexion,
dbPort2:numéro_de_port,
dbName2:sous-système,
dbUser2:ID_utilisateur,
dbPassword2:mot_de_passe,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:50,
apChanged:\"true\",
operator:\"or\"
}"
https://localhost/tuning/compareworkload
La sortie de l'API est identique à la sortie présentée à l'exemple 1.