lookuptable

룩업에 저장된 데이터를 열거하여 레코드로 출력합니다.

명령어 속성

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

문법

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

옵션

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

대상

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

출력 필드

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

오류 코드

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

해당 사항 없음

설명

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

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

데이터 열거를 지원하는 룩업만 사용할 수 있습니다.

사용 예

  1. 룩업의 전체 데이터 조회

    lookuptable ip_asset
    

    ip_asset 룩업의 모든 레코드를 출력합니다.

  2. 상위 N건만 조회

    lookuptable ip_asset limit=10
    

    ip_asset 룩업에서 최대 10건의 레코드를 출력합니다.

  3. 오프셋과 제한 적용

    lookuptable ip_asset offset=100 limit=50
    

    ip_asset 룩업에서 처음 100건을 건너뛰고 이후 50건의 레코드를 출력합니다.

  4. 특정 필드만 조회

    lookuptable ip_asset ip, hostname, department
    

    ip_asset 룩업에서 ip, hostname, department 필드만 출력합니다.

호환성

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