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ルックアップからiphostnamedepartmentフィールドのみを出力します。