인사이트 함수

Insight 함수는 애플리케이션 프로그래밍 인터페이스의 클래스, 메소드, 속성 및 매개변수에 대한 구문과 설명을 Data Studio 도구 모음의 Insight 도구에 제공합니다. 인사이트 생성은 백그라운드에서 수행되며 완료를 확인해야 합니다.

요청 목록 가져오기 프로시저

요청 이름 및 해당 매개변수 목록을 반환합니다.

구문

Insight.get_request_list(owner)

매개변수:

  • 소유자: 이 필드에는 객체의 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

이 예에서는 인사이트의 작업을 나열할 수 있습니다.

adp.Insight.get_request_list()
 
// Output
 
 [
  ... 
  {
    "owner": "ADMIN",
    "request_name": "REQUEST_INSIGHT_1",
    "request_type": "TABLE_INSIGHT",
    "source_object": "SALES",
    "source_owner": "ADMIN",
    "request_metadata": "{\"targets\":[\"ACTUAL\"],\"appName\":\"INSIGHTS\"}",
    "created": "2022-10-31T08:03:26.634Z",
    "updated": "2022-10-31T08:03:26.634Z",
    "request_job_setting": "{\"EXTRACTION\":{\"selectionRule\":{\"value\":\"MAX_DIFFERENCE\"},\"fittedShareConvergence\":{\"value\":\"LAX\"},\"maxNumExtractionDims\":{\"value\":10000},\"insightValueType\":{\"value\":\"MEMBER\"},\"excludeZero\":{\"value\":\"YES\"},\"minXAxisCount\":{\"value\":2}},\"sessionId\":null,\"applicationName\":\"INSIGHTS\",\"insightTypes\":[\"FITTED_SHARE_COMPARISON\"]}",
    "max_num_insights": 20
  },
  ...
]
인사이트 목록 가져오기 프로시저

인사이트 목록을 반환합니다. 각 인사이트에는 insight_name, visualization_id, insight_column, insight_value, insight_dimension, dimension 필드가 있습니다.

구문

Insight.get_insights_list(request_name)

매개변수:

  • request_name: 요청의 이름입니다.

이 예에서는 인사이트를 나열할 수 있습니다.

adp.Insight.get_insights_list('REQUEST_INSIGHT_1')
 
// Output:
[
  {
    "insight_name": "INSIGHT_62",
    "visualization_id": 199,
    "insight_column": "ACTUAL",
    "insight_value": "COUNTRY.2",
    "insight_dimension": "COUNTRY",
    "dimension": "FORECST"
  },..
]
인사이트 삭제 프로시저

인사이트 요청 삭제

구문
Insight.drop(request_name)

매개변수:

  • request_name: 요청의 이름입니다.

이 예에서는 요청을 삭제할 수 있습니다.
adp.Insight.drop('REQUEST_INSIGHT_1')
인사이트 생성 프로시저

분석 뷰에 대한 측정의 인사이트를 생성합니다.

구문

Insight.generate(av_name, measure, job_owner,
                      source_owner)

매개변수:

  • av_name: 분석 뷰의 이름입니다.
  • 측정항목: 측정항목입니다.
  • job_owner: 이 필드에는 작업 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.
  • source_owner: 이 필드에는 객체의 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

이 예에서는 분석 뷰에 대한 인사이트를 생성할 수 있습니다.
adp.Insight.generate('COSTS_AV', 'UNIT_COST')
 
// Output
 {
  "object_owner": "ADMIN",
  "request_name": "REQUEST_INSIGHT_1",
  "max_insight_count": 20,
  "source_object": "COSTS_AV",
  "source_owner": "COSTS_AV",
  "request_metadata": "{\"targets\":[\"UNIT_COST\"],\"appName\":\"INSIGHTS\"}",
  "default_job_settings": "{\"insightTypes\":[\"FITTED_SHARE_COMPARISON\"]}",
  "new_request": "true"
}
작업 현황 가져오기

지정된 작업의 상태를 요청 이름으로 가져옵니다. insight_job_status 필드가 COMPLETED이면 인사이트 생성이 완료됩니다.

구문

Insight.get_job_status(request_name, owner)

매개변수:

  • request_name: 요청의 이름입니다.
  • 소유자: 이 필드에는 객체의 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

이 예에서는 작업 상태를 표시할 수 있습니다.

adp.Insight.get_job_status('REQUEST_INSIGHT_1')
 
// Output
{
  "insight_job_status": "COMPLETED",
  "progress_msg": " ",
  "error_msg": null
}
그래프 세부정보 가져오기 프로시저

플롯할 수 있는 데이터의 JSON 사전을 반환합니다.

결과는 다음 두 개의 필드로 구성됩니다.

item에는 Insight의 전체 정보(description, XAXIS, measure, insight_type_label, visualization_condition, source_object)가 포함됩니다.

query에는 플로팅 정보가 포함되어 있으며 labels, actualsestimates의 세 목록이 있습니다.

구문
Insight.get_graph_details(name, id, count, query_manipulation,
                          owner)

매개변수:

  • name: Insight의 이름입니다.
  • id: 시각화 ID입니다.
  • count: 표시된 값 수
  • query_manipulation: 없음이 아닌 경우 쿼리에 커서 유형 및 총계 필드를 추가합니다.
  • 소유자: 이 필드에는 객체의 소유자가 표시됩니다. 이 필드가 누락된 경우 도구는 현재 스키마 소유자를 사용합니다.

이 예에서는 데이터를 가져와 그래프를 플롯할 수 있습니다.

adp.Insight.get_graph_details("INSIGHT_62", 199, 5, True)
 
 Output:
{
  "items": {
    "description": "COUNTRY.2",
    "XAXIS": "FORECST",
    "measure": "ACTUAL",
    "insight_type_label": "Expected",
    "visualization_condition": "COUNTRY.2",
    "source_object": "C0"
  },
  "query": {
    "labels": [
      "01:[66.7-1590]",
      "02:[829-2350]",
      "04:[2350-3870]",
      "06:[3870-5390]",
      "07:[4630-6150]"
    ],
    "actuals": [
      2200,
      6200,
      24600,
      26600,
      14200
    ],
    "estimates": [
      2671.105013588167,
      4830.820533674098,
      7135.506976989193,
      24772.963909661587,
      22121.48462234561
    ]
  }
}