geoip

geoip 명령어 문법 및 연동규격 설명서 입니다.

개요

이 명령어는 ip가 포함된 필드를 기반으로 위, 경도 등의 추가정보를 제공합니다.

설명

해당 필드에 포함된 x.x.x.x (IPV4) 형식의 ip 주소에 해당하는 위도, 경도 와 해당국가, 도, 시 그리고 ZIP code(postal code) 정보를 사용자의 요청에 맞게 새로운 필드로 제공합니다. 생성된 필드는 기존 테이블의 마지막에 위치하게 됩니다.

Examples

  • 명령어 이전 테이블
UPDATE_TIME IP_address IN_BYTES_AVG
2018/03/08 01:00:00 211.219.77.93 107
2018/03/08 01:00:00 118.130.235.213 145
2018/03/08 01:00:00 61.74.127.215 797
    1. IP_address 필드값을 이용해 default 값인 위도와 경도를 테이블에 추가하는 예제 입니다.
... | geoip IP_address

명령어 이후 테이블 (lat, lon필드 추가)

UPDATE_TIME IP_address IN_BYTES_AVG LATITUDE LONGITUDE
03/08 01:00:00 211.219.77.93 107 37.43861 127.13778
03/08 01:00:00 118.130.235.213 145 37.47722 126.86639
03/08 01:00:00 61.74.127.215 797 37.56826 126.97783
    1. IP_address 필드값을 이용해 모든 정보를 추가하는 예제 입니다.
 ... | geoip IP_address ALL

명령어 이후 테이블 (lat, lon, ctry, state, city, zip - 모든 정보 필드 추가)
UPDATE_TIME IP_address IN_BYTES_AVG LATITUDE LONGITUDE ZIP_CODE
03/08 01:00:00 211.219.77.93 107 37.43861 127.13778 461-805
03/08 01:00:00 118.130.235.213 145 37.47722 126.86639 423-836
03/08 01:00:00 61.74.127.215 797 37.56826 126.97783 100-101
    1. IP_address 필드값을 이용해 사용자 설정 정보를 추가하는 예제 입니다.
 ... | geoip IP_address state, city, zip

명령어 이후 테이블 ( 사용자가 선택한 옵션 - state, city, zip 필드 추가)
UPDATE_TIME IP_address IN_BYTES_AVG STATE CITY ZIP_CODE
03/08 01:00:00 211.219.77.93 107 Gyeonggi-do Seongnam 461-805
03/08 01:00:00 118.130.235.213 145 Gyeonggi-do Kwangmyong 423-836
03/08 01:00:00 61.74.127.215 797 Gyeonggi-do Seoul 100-101

Parameters

...| geoip field (option(, option)*)?
이름 설명 필수/옵션
field 대상인 필드를 의미하며, x.x.x.x (IPV4) 형식의 ip 주소만 가능합니다. 필수
option 기존 테이블에 추가될 정보를 설정합니다. 생략 시 default 정보가 추가되며, ALL 또는 다중입력으로 사용자가 추가될 정보를 설정할 수 있습니다.
default-위도(lat)와 경도(lon)가 추가됩니다.
ALL-모든 정보를 출력합니다. DEL명령어로 사용하지 않을 데이터를 생략 가능합니다.
사용자 설정-lat 위도(latitude), lon 경도(longitude),ctry 국가(counrty),state 도,city 시,zip zip 코드
주어진 IP 주소에 대한 데이터가 존재하지 않으면 다음과 같이 default 값이 설정 됩니다. (default = na)
옵션

Parameters BNF

geoip_command : GEOIP field options

options : options COMMA option
        | option

option : WORD

field : WORD

t_WORD     = \w+
t_COMMA    = ,