Transmettez à l'API les paires de clés et de valeurs suivantes en utilisant l'URL : https://localhost/tuning/wia
| 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 pour laquelle vous souhaitez obtenir des recommandations d'index. |
L'API renvoie les paires de clés et de valeurs suivantes :
| Clé | Valeur |
|---|---|
| code | Code retour de l'API Web.
|
| link | URL du rapport d'analyse de l'assistant Index de la charge de travail. Par défaut, le lien expire au bout de sept jours. Vous pouvez modifier cette durée dans le fichier tuning_service.properties. |
| output | DDL des recommandations d'index. |
| 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. |
Cet exemple utilise cURL pour transmettre des instructions SQL à l'API wia, qui renvoie une URL pour ouvrir le rapport d'analyse de l'assistant Index de la charge de travail, ainsi que la DDL des recommandations d'index.
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/wia
{
"code" :0 ,
"message" :"
--Estimated change in performance: 32.57 % faster\r\n
--Estimated disk space: 0.58 MB used\r\n
-------------------------------------------------------------\r\n
--Recommendations:\r\n
--Index: TPCDS.IDX1403130531140 Table: TPCDS.ORDER Action:Create\r\n
CREATE INDEX\"TPCDS\".\"IDX1403130531140\" ON \"TPCDS\".\"ORDER\"
( \"O_TOTALPRICE\" ASC,
\"O_ORDERDATE\" ASC,
\"O_SHIPPRIORITY\" ASC,
\"O_ORDERKEY\" ASC )
ALLOW REVERSE SCANS
COLLECT STATISTICS;\r\n --END"
"link" :"http://localhost:8080/tuning/download/wia/1394688720272-
16067301553057/summary.html" ,
}
L'API peut renvoyer un message d'erreur et une exception, par exemple lorsque la charge de travail de requête est introuvable.
{
"code" :8 ,
"error" :"The query workload Sample_Workload was not found. Ensure that the
name of the query workload is correct. Ensure that the query workload exists
on the specified data server."
}