lookuptable

매핑 테이블에 저장된 데이터를 열거하여 레코드로 출력합니다.

명령어 속성

항목	설명
명령어 유형	드라이버 쿼리
필요 권한	매핑 테이블에 대한 조회 권한
라이선스 사용량	집계 안 함
병렬 실행	미지원
분산 실행	미지원

문법

lookuptable TABLE [offset=LONG] [limit=LONG] [FIELD, ...]

옵션

offset=LONG: 건너뛸 레코드 수. 자연수만 허용됩니다.
limit=LONG: 가져올 최대 레코드 수. 자연수만 허용됩니다.

대상

TABLE: 조회할 매핑 테이블의 이름
[FIELD, ...]: 출력할 필드 목록. 쉼표(,)로 구분하여 여러 필드를 지정할 수 있습니다. 생략하면 매핑 테이블의 모든 필드를 출력합니다.

출력 필드

없음 (데이터 소스에 따라 동적으로 결정)

오류 코드

파싱 오류

오류 코드	메시지	설명
20705	lookuptable 조회 대상의 이름을 입력해야 합니다.	매핑 테이블 이름이 지정되지 않은 경우
20706	[name]은 존재하지 않는 룩업 테이블 이름입니다.	존재하지 않는 매핑 테이블 이름을 지정한 경우
20707	[name]은 데이터 조회가 지원되지 않는 룩업 테이블 이름입니다.	매핑 테이블이 데이터 열거를 지원하지 않는 경우
20708	[name]에 대한 lookuptable 권한이 없습니다.	매핑 테이블에 대한 조회 권한이 없는 경우
20709	lookuptable의 offset 옵션 값은 자연수만 허용됩니다.	`offset` 값이 0 이하이거나 숫자가 아닌 경우
20710	lookuptable의 limit 옵션 값은 자연수만 허용됩니다.	`limit` 값이 0 이하이거나 숫자가 아닌 경우
20711	[name]은 조회 불가능한 룩업 테이블 필드입니다.	매핑 테이블에 존재하지 않는 필드를 지정한 경우

런타임 오류

해당 사항 없음

설명

lookuptable 명령어는 매핑 테이블에 저장된 데이터를 열거하여 레코드로 출력합니다. lookup 명령어가 입력 레코드의 키 필드를 사용하여 매핑 테이블에서 값을 조회하는 반면, lookuptable 명령어는 매핑 테이블의 전체 데이터를 레코드로 출력합니다.

offset과 limit 옵션을 사용하여 페이지네이션할 수 있습니다. 필드 목록을 지정하면 해당 필드만 출력합니다.

데이터 열거를 지원하는 매핑 테이블만 사용할 수 있습니다.

사용 예

매핑 테이블의 전체 데이터 조회
```
lookuptable ip_asset
```
ip_asset 매핑 테이블의 모든 레코드를 출력합니다.
상위 N건만 조회
```
lookuptable ip_asset limit=10
```
ip_asset 매핑 테이블에서 최대 10건의 레코드를 출력합니다.
오프셋과 제한 적용
```
lookuptable ip_asset offset=100 limit=50
```
ip_asset 매핑 테이블에서 처음 100건을 건너뛰고 이후 50건의 레코드를 출력합니다.
특정 필드만 조회
```
lookuptable ip_asset ip, hostname, department
```
ip_asset 매핑 테이블에서 ip, hostname, department 필드만 출력합니다.

호환성

lookuptable 명령어는 소나 4.0 이전 버전부터 제공되었습니다.