dataset
データセットとして定義されたクエリを所有者の権限で実行します。データセットへのアクセス権限があるユーザーは、データセットの所有者の権限でクエリを実行できます。
コマンドプロパティ
| 項目 | 説明 |
|---|---|
| コマンドタイプ | ドライバークエリ |
| 必要な権限 | なし |
| ライセンス使用量 | 集計する |
| 並列実行 | 対応 |
| 分散実行 | 非対応 |
構文
dataset guid=STR
オプション
guid=STR- 実行するデータセットのGUID
出力フィールド
なし(データソースに応じて動的に決定)
エラーコード
パースエラー
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 300101 | 유효하지 않은 세션입니다. | Sonarセッションが有効でない場合 |
| 300105 | 유효하지 않은 guid 옵션 포맷입니다. | GUIDの形式が正しくない場合 |
| 300106 | 데이터 접근 권한이 없습니다. | データセットへのアクセス権限がない場合 |
| 300107 | 데이터셋이 존재하지 않습니다. | 指定したGUIDのデータセットが存在しない場合 |
| 300108 | 데이터셋 소유자가 존재하지 않습니다. | データセットの所有者アカウントが削除された場合 |
| 300109 | 자기 자신을 호출할 수 없습니다. | データセットが自分自身を再帰的に呼び出す場合 |
| 300110 | dataset 명령어에 guid 옵션을 지정하세요. | guidオプションが指定されていない場合 |
ランタイムエラー
該当なし
説明
datasetコマンドは、データセットに保存されたクエリをサブクエリとして実行します。データセットの所有者のセッションを生成して所有者の権限でクエリを実行するため、データセットへのアクセス権限があるユーザーは自分に直接権限のないデータにもアクセスできます。
データセットの所有者、クラスター管理者、組織管理者、またはデータセットを共有されたユーザーのみが実行できます。それ以外のユーザーが実行すると権限エラーが発生します。
自分自身を呼び出す再帰呼び出しは許可されず、呼び出しスタックで同じデータセットGUIDが検出されるとパースエラーが発生します。
クエリの実行が完了すると、所有者セッションを自動的に終了します。
使用例
-
データセットを実行する
dataset guid="550e8400-e29b-41d4-a716-446655440000"指定したGUIDのデータセットに定義されたクエリを所有者の権限で実行します。
-
データセットの結果に加工クエリを適用する
dataset guid="550e8400-e29b-41d4-a716-446655440000" | search src_ip == ip("192.0.2.1") | stats count by dst_portデータセットの実行結果から送信元IPが192.0.2.1のレコードをフィルタリングし、宛先ポートごとの件数を集計します。
互換性
datasetコマンドはSonar 4.0.2305.0バージョンから利用可能です。