Query Analysis Group By Count

사용된 검색 Query 들을 분석하여 field 별 Group By 된 Count 집계를 합니다.

city1: 도시 구분필드1 ex) 서울특별시, 경기도, 충청북도
city2: 도시 구분필드2 ex) 강남구, 서초, 구로구
city3: 도시 구분필드2 ex) 역삼동, 정자동, 서초동
country: 국가
word: 검색 Query 를 형태소분석한 word

POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/{name}/analysis/count_group_by

요청

요청 파라미터

파라미터 명	필수 여부	타입	제약사항	설명
name	Yes	string		생성되어져 있는 Domain 이름

요청 바디

파라미터 명	필수 여부	타입	설명
from	Yes	string	시작 시간(UTC, ex: 20161027T171340Z )
to	Yes	string	종료 시간(UTC, ex: 20161027T171340Z )
groupBy	Yes	GroupBySchema	groupBy 설정
aggregate	Yes	AggregateSchema	aggregate 설정

응답

Success

[
  {
    "key": (string),
    "doc_count": (int),
    "aggregated_result": {
      "sum_other_doc_count": (int),
      "buckets": [
        {
          "key": (string),
          "doc_count": (int),
        }
      ]
    }
  }
]

응답

필드명	타입	설명
key	string	Group by 된 결과의 기준 값
doc_count	number	기준 값에 해당하는 모든 값의 합
aggregated_result.sum_other_doc_count	number	aggregate 결과가 지정한 max_size 값보다 클 때, 결과에 출력되지 않은 모든 값의 합
aggregated_result.buckets[]	array	aggreagte 결과의 key 별 그룹핑
aggregated_result.buckets[].key	string	해당 시간 동안 query에 사용된 field의 값
aggregated_result.buckets[].doc_count	string	해당 시간 동안 query에 사용된 key의 횟수

응답 Status

Http Status	Desc
200	OK(요청 완료)
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error

예시

예시1 : field_value 가 있는 경우

요청

POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/count_group_by

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "groupBy": {
    "field": "word",
    "field_value": "현대",
    "max_size": 10
  },
  "aggregate": {
    "field": "city1",
    "max_size": 10
  }
}

응답 예시

[
  {
    "key": "현대",
    "doc_count": 1,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "경기도",
          "doc_count": 1
        }
      ]
    }
  }
]

예시2 : field_value 가 없는 경우

요청

POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/count_group_by

POST /CloudSearch/real/v1/domain/car_dev/analysis/count_group_by HTTP/1.1
Host:cloudsearch.apigw.gov-ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "groupBy": {
    "field": "word",
    "max_size": 10
  },
  "aggregate": {
    "field": "city1",
    "max_size": 10
  }
}

응답 예시

[
  {
    "key": "class",
    "doc_count": 3117,
    "aggregated_result": {
      "sum_other_doc_count": 357,
      "buckets": [
        {
          "key": "서울특별시",
          "doc_count": 1378
        },
        {
          "key": "경기도",
          "doc_count": 473
        },
        {
          "key": "",
          "doc_count": 300
        },
        {
          "key": "인천광역시",
          "doc_count": 119
        },
        {
          "key": "대구광역시",
          "doc_count": 107
        },
        {
          "key": "부산광역시",
          "doc_count": 104
        },
        {
          "key": "경상북도",
          "doc_count": 83
        },
        {
          "key": "전라북도",
          "doc_count": 69
        },
        {
          "key": "대전광역시",
          "doc_count": 64
        },
        {
          "key": "경상남도",
          "doc_count": 63
        }
      ]
    }
  },
  {
    "key": "bmw",
    "doc_count": 3027,
    "aggregated_result": {
      "sum_other_doc_count": 303,
      "buckets": [
        {
          "key": "서울특별시",
          "doc_count": 1295
        },
        {
          "key": "경기도",
          "doc_count": 515
        },
        {
          "key": "",
          "doc_count": 331
        },
        {
          "key": "인천광역시",
          "doc_count": 127
        },
        {
          "key": "대구광역시",
          "doc_count": 105
        },
        {
          "key": "부산광역시",
          "doc_count": 88
        },
        {
          "key": "경상북도",
          "doc_count": 79
        },
        {
          "key": "대전광역시",
          "doc_count": 63
        },
        {
          "key": "전라북도",
          "doc_count": 63
        },
        {
          "key": "전라남도",
          "doc_count": 58
        }
      ]
    }
  }
]