wia: Génération de recommandations d'index pour les charges de travail de requête

Une fois que vous avez transmis à l'API wia le nom d'une charge de travail de requête, l'API exécute l'assistant Index de la charge de travail. Cet assistant génère des recommandations pour les index, ainsi qu'un rapport d'analyse. L'API renvoie les recommandations et une URL permettant d'accéder au rapport.

Paramètres d'entrée

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

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 pour laquelle vous souhaitez obtenir des recommandations d'index.  

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
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.

Exemple

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.

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/wia
Sortie
{        
"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."
}

Feedback