Query Analysis Group By Count
    • PDF

    Query Analysis Group By Count

    • PDF

    Article Summary

    사용된 검색 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
    

    요청

    요청 파라미터

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

    요청 바디

    파라미터 명필수 여부타입제약사항설명
    fromYesstring시작 시간(UTC, ex: 20161027T171340Z )
    toYesstring종료 시간(UTC, ex: 20161027T171340Z )
    groupByYesGroupBySchemagroupBy 설정
    aggregateYesAggregateSchemaaggregate 설정

    응답

    Success

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

    응답

    필드명타입설명비고
    keystringGroup by 된 결과의 기준 값
    doc_countnumber기준 값에 해당하는 모든 값의 합
    aggregated_result.sum_other_doc_countnumberaggregate 결과가 지정한 max_size 값보다 클 때, 결과에 출력되지 않은 모든 값의 합
    aggregated_result.buckets[]arrayaggreagte 결과의 key 별 그룹핑
    aggregated_result.buckets[].keystring해당 시간 동안 query에 사용된 field의 값
    aggregated_result.buckets[].doc_countstring해당 시간 동안 query에 사용된 key의 횟수

    응답 Status

    Http StatusDesc
    200OK(요청 완료)
    400Bad Request
    401Unauthorized
    403Forbidden
    404Not Found
    500Internal 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": "현대",
        "maxSize": 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",
        "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
            }
          ]
        }
      }
    ]
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.