メインコンテンツへスキップ

groupArraySample

導入バージョン: v20.3.0 引数値のサンプルからなる配列を作成します。 生成される配列のサイズは max_size 要素に制限されます。 引数値はランダムに選択され、配列に追加されます。 構文
groupArraySample(max_size[, seed])(x)
パラメータ
  • max_size — 結果の配列の最大サイズ。UInt64
  • seed — 任意。乱数ジェネレータのシード。デフォルト値: 123456。UInt64
  • x — 引数 (カラム名または式) 。Any
引数
  • array_column — 集約対象の配列を含むカラム。Array
戻り値 ランダムに選択された x 引数の配列。Array(T) 使用例
Query
CREATE TABLE default.colors (
    id Int32,
    color String
) ENGINE = Memory;

INSERT INTO default.colors VALUES
(1, 'red'),
(2, 'blue'),
(3, 'green'),
(4, 'white'),
(5, 'orange');

SELECT groupArraySample(3)(color) as newcolors FROM default.colors;
Response
┌─newcolors──────────────────┐
│ ['white','blue','green']   │
└────────────────────────────┘
シードを使用する例
Query
-- カラム名と異なるseedを使用したクエリ
SELECT groupArraySample(3, 987654321)(color) as newcolors FROM default.colors;
Response
┌─newcolors──────────────────┐
│ ['red','orange','green']   │
└────────────────────────────┘
引数として式を使用する
Query
-- 引数として式を使用したクエリ
SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM default.colors;
Response
┌─newcolors───────────────────────────────────┐
│ ['light-blue','light-orange','light-green'] │
└─────────────────────────────────────────────┘
最終更新日 2026年6月10日