Pase los siguientes pares de claves y valores a la API mediante este URL: https://localhost/tuning/compareworkload
| Categoría | Clave | Valor | Valores posibles | ¿Opcional? |
|---|---|---|---|---|
| Conexión 1 | dbType | El tipo de servidor de datos. | ZOS | No |
| dbHost | El host del servidor de datos. | Nombre de dominio o dirección IP | No | |
| dbPort | El número de puerto del servidor de datos | No | ||
| dbName | El nombre del servidor de datos | No | ||
| dbUser | El ID que se ha de utilizar para conectarse al servidor de datos. | No | ||
| dbPassword | La contraseña que se ha de utilizar para conectarse al servidor de datos. | No | ||
| Conexión 2 | dbHost2 | El host del servidor de datos. | Solo para las comparaciones de Tipo 3. | |
| dbPort2 | El número de puerto del servidor de datos | Solo para las comparaciones de Tipo 3. | ||
| dbName2 | El nombre del servidor de datos | Solo para las comparaciones de Tipo 3. | ||
| dbUser2 | El ID que se ha de utilizar para conectarse al servidor de datos. | Solo para las comparaciones de Tipo 3. | ||
| dbPassword2 | La contraseña que se ha de utilizar para conectarse al servidor de datos. | Solo para las comparaciones de Tipo 3. | ||
| Cargas de trabajo de consulta | carga de trabajo | El nombre de la carga de trabajo de consulta con la instantánea EXPLAIN más antigua que se ha de utilizar en la comparación. | No | |
| workload2 | El nombre de la carga de trabajo de consulta con la instantánea EXPLAIN más reciente que se ha de utilizar en la comparación. El nombre puede ser idéntico al primer nombre si desea comparar dos instantáneas EXPLAIN de una carga de trabajo de consulta individual. | Solo para las comparaciones de Tipo 1 y Tipo 2. | ||
| Opción para filtrar sentencias SQL | apChanged | Especifica que se han de mostrar las sentencias SQL en las que se han modificado los planes de acceso. | true o false. No importan las mayúsculas y minúsculas. | Yes |
| costRegressed | Especifica que se han de mostrar las sentencias SQL en las que se ha aumentado el coste estimado por una cantidad mayor o igual al porcentaje especificado. | Un entero entre 0 y 100 inclusive. | ||
| operator | Especifica si se han de mostrar las sentencias SQL que coinciden con el valor establecido para las dos claves apChanged y costRegressed o se si se han de mostrar las sentencias SQL que coinciden con el valor establecido para cualquiera de estas claves. | and u or. No importan las mayúsculas y minúsculas. | y |
La API devuelve los siguientes pares de claves y valores:
| Clave | Valor |
|---|---|
| code | El código de retorno de la API web.
|
| state |
|
| link | El URL del informe que compara los planes de acceso en las dos instantáneas EXPLAIN. 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 número de sentencias SQL que cumplen con el criterio de filtro y para las que existe información en este informe. |
| 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. |
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,
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:host,
dbPort:port_number,
dbName:subsystem,
dbUser:user_ID,
dbPassword:password,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:20,
apChanged:\"true\"
}"
https://localhosh/tuning/compareworkload
La salida de la API es idéntica a la salida que se muestra en el Ejemplo 1.
curl
--insecure
-X POST
-H "Content-Type: application/json; charset=UTF-8"
--data "{
dbType:ZOS,
dbHost:host_for_the_first_connection,
dbPort:port_number,
dbName:subsystem,
dbUser:user_ID,
dbPassword:password,
dbHost2:host_for_the_second_connection,
dbPort2:port_number,
dbName2:subsystem,
dbUser2:user_ID,
dbPassword2:password,
workload:Sample_Workload,
workload2:Sample_Workload2,
costRegressed:50,
apChanged:\"true\",
operator:\"or\"
}"
https://localhost/tuning/compareworkload
La salida de la API es idéntica a la salida que se muestra en el Ejemplo 1.