explainworkload: Explicación de las cargas de trabajo de consulta

Después de pasar el nombre de una carga de trabajo de consulta a la API explainworkload, la API explica la carga de trabajo de consulta y devuelve el número de sentencias que ha explicado.

Parámetros de entrada

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

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 que desea explicar.  
schema El esquema que ha de utilizar el proceso EXPLAIN para los objetos no calificados en las sentencias SQL. Este valor altera temporalmente el valor establecido en el archivo tuning_service.properties.  

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
output El número de sentencias SQL que ha explicado la API. Este número será menor que el número de sentencias contenidas en la carga de trabajo de consulta si alguna sentencia no se puede explicar.
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 el nombre de una carga de trabajo de consulta a la API explainworkload, la cual devuelve el número de sentencias SQL explicadas por la API.

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/explainworkload
Salida
{ 
"code":0
}

Comentarios