explainworkload: 쿼리 워크로드 Explain

explainworkload API에 쿼리 워크로드 이름을 전달하면 API는 쿼리 워크로드를 Explain하고 Explain한 명령문 수를 리턴합니다.

입력 매개변수

URL을 사용하여 API에 다음 키 및 값 쌍을 전달하십시오. https://localhost/tuning/explainworkload

표 1. 입력 매개변수
가능한 값
dbType 데이터 서버 유형 ZOS
dbHost 데이터 서버의 호스트입니다. 도메인 이름 또는 IP 주소
dbPort 데이터 서버의 포트 번호  
dbName 데이터 서버 이름  
dbUser 데이터 서버에 연결할 때 사용할 ID입니다.  
dbPassword 데이터 서버에 연결할 때 사용할 비밀번호입니다.  
workloadName Explain할 쿼리 워크로드의 이름입니다.  
schema SQL문에 규정되지 않은 오브젝트에 사용할 EXPLAIN 프로세스의 스키마입니다. 이 값은 tuning_service.properties 파일에 설정된 값을 겹쳐씁니다.  

출력 매개변수

API는 다음 키 및 값 쌍을 리턴합니다.

표 2. 출력 매개변수
code 웹 API의 리턴 코드입니다.
0
경고 없이 완료됨
4
완료되었지만 경고가 표시됨
8
오류로 인해 완료되지 않고 종료됨
output API가 Explain한 SQL문 수입니다. 명령문을 Explain할 수 없는 경우 이 숫자는 쿼리 워크로드에 있는 명령문 수보다 작습니다.
message 오류 또는 경고 메시지입니다.
exception 예외가 발생한 경우 예외에 대한 정보입니다. IBM 지원 센터와 작업하여 문제점을 해결하는 경우 이 정보는 IBM 지원 센터에 유용합니다.

예제

이 예제에서는 cURL을 사용하여 explainworkload API에 쿼리 워크로드의 이름을 전달하며, 이 API는 API가 Explain한 명령문 수를 리턴합니다.

입력
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
출력
{ 
"code":0
}

피드백