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
    
    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",
        "field_value": "현대",
        "maxSize": 10
      },
      "aggregate": {
        "field": "city1",
        "maxSize": 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",
        "maxSize": 10
      },
      "aggregate": {
        "field": "city1",
        "maxSize": 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
            }
          ]
        }
      }
    ]