sonar-matchnet-by-ip-batch
각 레코드의 IP 주소가 포함된 네트워크 대역을 전체 대역 그룹에서 찾아 레코드에 추가합니다.
여러 대역에 겹쳐 속하는 주소는 대역마다 한 행씩, 원본 필드를 모두 유지한 채 출력됩니다. 네트워크 대역 목록은 쿼리 시작 시점에 한 번 읽으므로 쿼리 실행 중 변경된 대역은 반영되지 않습니다. 소나의 네트워크 대역은 IPv4만 저장하며, IPv6나 해석할 수 없는 값은 매칭되지 않습니다.
문법
sonar-matchnet-by-ip-batch [field=FIELD] [fields=FIELDS] [keywords=KEYWORDS] [limit=NUM] [drop=DROP]
옵션
- field=FIELD
- 선택 옵션. IP 주소가 들어 있는 필드 이름. field 또는 fields 중 하나를 지정하세요
- fields=FIELDS
- 선택 옵션. IP 주소가 들어 있는 필드 이름을 쉼표로 구분하여 지정합니다. field 또는 fields 중 하나를 지정하세요
- keywords=KEYWORDS
- 선택 옵션. 대상 네트워크 대역을 좁히는 검색어. 공백으로 구분하며 네트워크 대역 그룹의 이름·설명 또는 네트워크 대역의 설명과 대조합니다
- limit=NUM
- 선택 옵션. 입력 레코드 1건당 출력할 최대 매칭 행 수 (기본값: 제한 없음)
- drop=DROP
- 선택 옵션. t: 매칭된 레코드만 출력합니다. f: 매칭되지 않은 레코드를 그대로 통과시킵니다 (기본값)
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| subnet_field | 문자열 | 매칭 필드 | 주소를 읽은 필드 이름 |
| subnet_value | IP 주소 | 매칭 값 | 매칭된 IP 주소 |
| subnet_group_guid | 문자열 | 그룹 GUID | 네트워크 대역 그룹 GUID |
| subnet_group_name | 문자열 | 그룹 이름 | 네트워크 대역 그룹 이름 |
| subnet_group_description | 문자열 | 그룹 설명 | 네트워크 대역 그룹 설명 |
| subnet_id | 32비트 정수 | 대역 ID | 네트워크 대역 항목 ID |
| subnet_start_ip | IP 주소 | 시작 IP | 네트워크 대역의 시작 IP 주소 |
| subnet_end_ip | IP 주소 | 종료 IP | 네트워크 대역의 종료 IP 주소. CIDR로 저장된 항목은 프리픽스로 계산한 값 |
| subnet_cidr | 32비트 정수 | CIDR | CIDR 프리픽스 길이. 범위로 저장된 항목은 null |
| subnet_description | 문자열 | 설명 | 네트워크 대역 설명 |
| subnet_app_code | 문자열 | 앱 코드 | 네트워크 대역을 소유한 앱의 코드. 수동으로 등록한 대역은 null |