wia: Generación de recomendaciones de índice para cargas de trabajo de consulta

Después de pasar el nombre de una carga de trabajo de consulta a la API wia, la API ejecuta el Asesor de índices de carga de trabajo. Este asesor genera recomendaciones para índices, así como un informe de su análisis. La API devuelve las recomendaciones y un URL en el informe.

Parámetros de entrada

Pase los siguientes pares de claves y valores a la API mediante este URL: https://localhost/tuning/wia

Tabla 1. Parámetros de entrada
Clave Valor Valores posibles
dbType El tipo de servidor de datos. ZOS
dbHost El host del servidor de datos. Nombre de dominio o dirección IP
dbPort El número de puerto del servidor de datos  
dbName El nombre del servidor de datos  
dbUser El ID que se ha de utilizar para conectarse al servidor de datos.  
dbPassword La contraseña que se ha de utilizar para conectarse al servidor de datos.  
workloadName El nombre de la carga de trabajo de consultas para la que desea las recomendaciones de índice.  

Parámetros de salida

La API devuelve los siguientes pares de claves y valores:

Tabla 2. Parámetros de salida
Clave Valor
code El código de retorno de la API web.
0
Completado con avisos
4
Completado con avisos
8
Finalizado sin completar debido a un error
link El URL del informe de análisis del Asesor de índices de carga de trabajo. De forma predeterminada, el enlace caduca después de 7 días. Puede cambiar este periodo de tiempo en el archivo tuning_service.properties.
output El DDL de las recomendaciones de índice.
message Cualquier mensaje de error o de aviso.
exception Información acerca de la excepción, si se ha producido una. Esta información puede ser útil para el servicio de soporte de IBM si trabaja con ellos para la resolución de un problema.

Ejemplo

En este ejemplo se utiliza cURL para pasar sentencias SQL a la API wia, la cual devuelve un URL para abrir el informe del análisis del Asesor de índices de carga de trabajo y el DDL con las recomendaciones del índice.

Entrada
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
   dbType:ZOS,
   dbHost:host,
   dbPort:port_number,
   dbName:subsystem,
   dbUser:user_ID,
   dbPassword:password,
   workloadName:Sample_Workload,
   }"
https://localhost/tuning/wia
Salida
{        
"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" ,
}

De forma alternativa, la API puede devolver un mensaje de error y una excepción, del mismo modo que cuando no puede encontrar la carga de trabajo de consulta.

{   
    "code" :8 ,
    "error" :"No se ha encontrado la carga de trabajo de consulta Sample_Workload. Asegúrese de
      que el nombre de la carga de trabajo sea correcto. Asegúrese de que la carga de trabajo
      de consulta exista en el servidor de datos especificado."
}

Comentarios