Pase los siguientes pares de claves y valores a la API mediante este URL: https://localhost/tuning/wia
| 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. |
La API devuelve los siguientes pares de claves y valores:
| Clave | Valor |
|---|---|
| code | El código de retorno de la API web.
|
| 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. |
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.
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
{
"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."
}