このトピックでは、データ分析のための集計操作を実行する方法を説明します。集計操作では、最小値、最大値、合計、平均、カウント、個別カウント、パーセンタイルを計算できます。結果は、フィールド値、範囲、ロケーション、フィルター、ヒストグラム、または日付でグループ化でき、オプションでネストされたクエリを実行して各グループの行を分析することもできます。複数の集計操作を組み合わせて、より複雑なクエリを実行することもできます。
操作手順
次の図は、集計の全手順を示します。

サーバーは、クエリ条件を満たすデータをクエリし、リクエストに基づいてデータの集計を実行します。そのため、集計が必要なリクエストは、集計が不要なリクエストよりも処理が複雑になります。
機能
集計は、SQL 関数と同様に、最小値を取得する MIN() 関数、最大値を取得する MAX() 関数、合計を取得する SUM() 関数、平均値を取得する AVG() 関数、行数を取得する COUNT() 関数、重複しない行数を取得する COUNT(DISTINCT) 関数、各グループの集計操作の結果から得られた行をクエリする ANY_VALUE() 関数、クエリ結果をグループ化する GROUP BY 関数など、複数の機能をサポートしています。 また、集計操作を実行して、パーセンタイル統計の取得、フィールド値、範囲、地理的位置、フィルター、ヒストグラム、または日付ヒストグラムによる結果のグループ化、複数のフィールドに基づく結果のグループ化、およびネストされたクエリの実行も可能です。 次の表で、これらの機能について説明します。
|
機能 |
説明 |
|
最小値 |
フィールドの最小値を返すための集計方法です。この方法は、SQL の MIN 関数と同様に使用できます。 |
|
最大値 |
フィールドの最大値を返すための集計方法です。この方法は、SQL の MAX 関数と同様に使用できます。 |
|
合計 |
数値フィールドのすべての値の合計を返すための集計方法です。この方法は、SQL の SUM 関数と同様に使用できます。 |
|
平均値 |
数値フィールドのすべての値の平均を返すための集計方法です。この方法は、SQL の AVG 関数と同様に使用できます。 |
|
カウント |
フィールドの値の総数、または検索インデックス内の行の総数を返すための集計方法です。この方法は、SQL の COUNT 関数と同様に使用できます。 |
|
個別カウント |
フィールドの重複を除いた値の数を返すための集計方法です。この方法は、SQL の COUNT(DISTINCT) 関数と同様に使用できます。 |
|
パーセンタイル統計 |
パーセンタイル値は、データセット内の値の相対的な位置を示します。たとえば、システムの日常的な運用保守 (O&M) では各リクエストの応答時間を収集して統計を取る場合、p25、p50、p90、p99 などのパーセンタイルを使用して、応答時間の分布を分析する必要があります。 |
|
フィールド値によるグループ化 |
フィールド値に基づいてクエリ結果をグループ化するための集計方法です。同じ値は同じグループにまとめられます。各グループの同一の値と、各グループに含まれる同一値の数が返されます。 |
|
GroupBy のネスト |
GroupBy はネストをサポートしています。GroupBy を使用して、サブ集計操作を実行できます。 |
|
複数フィールドによるグループ化 |
複数のフィールドに基づいてクエリ結果をグループ化するための集計方法です。トークンを使用してページングを実行できます。 |
|
範囲によるグループ化 |
フィールドの値の範囲に基づいてクエリ結果をグループ化するための集計方法です。特定の範囲内にあるフィールド値は同じグループにまとめられます。各範囲に含まれる値の数が返されます。 |
|
地理的位置によるグループ化 |
地理的位置から中心点までの距離に基づいてクエリ結果をグループ化するための集計方法です。距離が特定の範囲内にあるクエリ結果は同じグループにまとめられます。各範囲に含まれる値の数が返されます。 |
|
フィルターによるグループ化 |
クエリ結果をフィルタリングしてグループ化し、各フィルターに一致する結果の数を取得するための集計方法です。結果は、フィルターを指定した順序で返されます。 |
|
ヒストグラムによるグループ化 |
特定のデータ間隔に基づいてクエリ結果をグループ化するための集計方法です。同じ範囲内にあるフィールド値は同じグループにまとめられます。各グループの値の範囲と、各グループに含まれる値の数が返されます。 |
|
日付ヒストグラムによるグループ化 |
特定の日付間隔に基づいてクエリ結果をグループ化するための集計方法です。同じ範囲内にあるフィールド値は同じグループにまとめられます。各グループの値の範囲と、各グループに含まれる値の数が返されます。 |
|
各グループの集計結果から取得した行のクエリ |
クエリ結果をグループ化した後、各グループの行をクエリできます。この方法は、MySQL の ANY_VALUE(field) 関数と同様に使用できます。 |
|
複数集計 |
複数の集計操作を実行できます。 説明
複数の複雑な集計操作を同時に実行すると、処理に時間がかかる場合があります。 |
前提条件
-
OTSClient インスタンスが初期化されていること。詳細については、「OTSClient インスタンスの初期化」をご参照ください。
-
データテーブルが作成され、データが書き込まれていること。詳細については、「データテーブルの作成」および「データ書き込み」をご参照ください。
-
データテーブルに検索インデックスが作成されていること。詳細については、「検索インデックスの作成」をご参照ください。
最小値
フィールドの最小値を返すための集計方法です。このメソッドは、SQL の MIN 関数と同様です。
-
パラメーター
パラメーター
説明
AggName
集計操作の一意の名前です。この名前を基に、特定の集計操作の結果をクエリできます。
FieldName
集計操作を実行するフィールドの名前です。LONG、DOUBLE、DATE 型のみをサポートします。
Missing
フィールド値が空の場合、その行の集計操作に使用するデフォルト値です。
-
Missing に値を指定しない場合、その行を無視します。
-
Missing に値を指定した場合、このパラメーターの値をその行のフィールド値として使用します。
-
-
例
/// <summary> /// 最小値。 /// </summary> /// <param name="otsClient"></param> public static void MinAggregation(OTSClient otsClient) { MinAggregation minAggregation = new MinAggregation(); minAggregation.AggName = "Min_Agg"; minAggregation.FieldName = "pk1"; RangeQuery rangeQuery = new RangeQuery(); rangeQuery.FieldName = "pk1"; rangeQuery.From = new ColumnValue(0); rangeQuery.To = new ColumnValue(100); SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = rangeQuery, AggregationList = new List<IAggregation> { minAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsMinAggregationResult("Min_Agg"))); }
最大値
フィールドの最大値を返す集約です。このメソッドは、SQL の MAX 関数と同様に使用できます。
-
パラメーター
パラメーター
説明
AggName
集約操作の一意の名前です。この名前に基づいて、特定の集約操作の結果をクエリできます。
FieldName
集約操作に使用するフィールドの名前です。LONG、DOUBLE、DATE 型のみがサポートされています。
Missing
フィールド値が空の行で集約操作を実行する際の、フィールドのデフォルト値です。
-
Missing の値を指定しない場合、その行は無視されます。
-
Missing の値を指定した場合、このパラメーターの値が行のフィールド値として使用されます。
-
-
例
/// <summary> /// 最大値の概要。 /// </summary> /// <param name="otsClient"></param> public static void MaxAggregation(OTSClient otsClient) { MaxAggregation maxAggregation = new MaxAggregation(); maxAggregation.AggName = "Max_Agg"; maxAggregation.FieldName = "pk1"; RangeQuery rangeQuery = new RangeQuery(); rangeQuery.FieldName = "pk1"; rangeQuery.From = new ColumnValue(0); rangeQuery.To = new ColumnValue(100); SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = rangeQuery, AggregationList = new List<IAggregation> { maxAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsMaxAggregationResult("Max_Agg"))); }
Sum
数値フィールドのすべての値の合計を返す集計方法です。このメソッドは、SQL SUM 関数と同様に使用できます。
-
パラメーター
パラメーター
説明
AggName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作を実行するフィールドの名前です。LONG 型と DOUBLE 型のみがサポートされています。
Missing
フィールド値が空の場合に、その行の集計操作で使用するデフォルト値です。
-
Missingに値を指定しない場合、その行は無視されます。 -
Missingに値を指定した場合、このパラメーターの値がその行のフィールド値として使用されます。
-
-
例
/// <summary> /// Sum 集計 /// </summary> /// <param name="otsClient">OTSClient オブジェクト。</param> public static void SumAggregation(OTSClient otsClient) { SumAggregation sumAggregation = new SumAggregation(); sumAggregation.AggName = "Sum_Agg"; sumAggregation.FieldName = "pk1"; RangeQuery rangeQuery = new RangeQuery(); rangeQuery.FieldName = "pk1"; rangeQuery.From = new ColumnValue(0); rangeQuery.To = new ColumnValue(100); SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = rangeQuery, AggregationList = new List<IAggregation> { sumAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsSumAggregationResult("Sum_Agg"))); }
平均値
数値フィールドのすべての値の平均を返す集計方法です。このメソッドは、SQL の AVG 関数と同様に使用できます。
-
パラメーター
パラメーター
説明
AggName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作を実行するフィールドの名前です。LONG、DOUBLE、DATE 型のみがサポートされています。
Missing
フィールド値が空の行で集計操作を行う際に使用される、フィールドのデフォルト値です。
-
Missing の値を指定しない場合、その行は無視されます。
-
Missing の値を指定した場合、このパラメーターの値が行のフィールド値として使用されます。
-
-
例
/// <summary> /// 概要。 /// </summary> /// <param name="otsClient"></param> public static void AvgAggregation(OTSClient otsClient) { AvgAggregation avgAggregation = new AvgAggregation(); avgAggregation.AggName = "Avg_Agg"; avgAggregation.FieldName = "pk1"; RangeQuery rangeQuery = new RangeQuery(); rangeQuery.FieldName = "pk1"; rangeQuery.From = new ColumnValue(0); rangeQuery.To = new ColumnValue(100); SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = rangeQuery, AggregationList = new List<IAggregation> { avgAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsAvgAggregationResult("Avg_Agg"))); }
Count
指定したフィールドの値の総数、または多次元インデックス内の行の総数を返す集計方法です。このメソッドは、SQL COUNT 関数と同様に使用できます。
多次元インデックス内の行の総数、またはクエリ条件を満たす行の総数は、次の方法で照会できます。
-
集計の Count 機能を使用し、リクエストで
count(*)を指定します。 -
クエリ機能を使用して、クエリ条件を満たす行数を取得します。クエリで
setGetTotalCountをtrueに設定します。MatchAllQueryを使用して、多次元インデックス内の行の総数を取得します。
多次元インデックス内で当該カラムを含む行数を照会するには、count 式の値としてカラム名を使用できます。この方法は、スパース列を含むシナリオに適しています。
-
パラメーター
パラメーター
説明
AggName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果を照会できます。
FieldName
集計操作の実行に使用するフィールドの名前です。LONG、DOUBLE、BOOLEAN、KEYWORD、GEO_POINT、DATE 型のみがサポートされています。
-
例
/// <summary> /// カウント集計。 /// </summary> /// <param name="otsClient"></param> public static void CountAggregation(OTSClient otsClient) { CountAggregation countAggregation = new CountAggregation(); countAggregation.AggName = "Count_Agg"; countAggregation.FieldName = "pk1"; RangeQuery rangeQuery = new RangeQuery(); rangeQuery.FieldName = "pk1"; rangeQuery.From = new ColumnValue(0); rangeQuery.To = new ColumnValue(100); SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = rangeQuery, AggregationList = new List<IAggregation> { countAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsCountAggregationResult("Count_Agg"))); }
個別カウント
フィールドの重複を除いた値の数を返す集計方法です。このメソッドは、SQL の COUNT(DISTINCT) 関数と同様に使用できます。
重複を除いた値の数は概算値です。
-
集計前の行の総数が 10,000 未満の場合、計算結果は正確な値に近くなります。
-
集計前の行の総数が 1 億以上の場合、誤差率は約 2% です。
-
パラメーター
パラメーター
説明
AggName
集約操作の一意な名前です。この名前を使用して、特定の集約操作の結果をクエリできます。
FieldName
集約操作を実行するフィールドの名前です。LONG、DOUBLE、BOOLEAN、KEYWORD、GEO_POINT、DATE 型のみをサポートします。
Missing
フィールド値が空の場合に、集約操作で使用するデフォルト値です。
-
Missing に値を指定しない場合、その行は無視されます。
-
Missing に値を指定した場合、このパラメーターの値がその行のフィールド値として使用されます。
-
-
例
/// <summary> /// 個別カウント。 /// </summary> /// <param name="otsClient"></param> public static void DistinctCountAggregation(OTSClient otsClient) { DistinctCountAggregation distinctCountAggregation = new DistinctCountAggregation(); distinctCountAggregation.AggName = "DistinctCount_Agg"; distinctCountAggregation.FieldName = "pk1"; TermsQuery termsQuery = new TermsQuery(); termsQuery.FieldName = "pk0"; termsQuery.Terms = new List<ColumnValue> { new ColumnValue("Sample"), new ColumnValue("SearchIndex") }; SearchQuery seachQuery = new SearchQuery { Limit = 0, Query = termsQuery, AggregationList = new List<IAggregation> { distinctCountAggregation } }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, seachQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse.AggregationResults.GetAsDistinctCountAggregationResult("DistinctCount_Agg"))); }
パーセンタイル統計
パーセンタイル値は、データセット内の値の相対的な位置を示します。たとえば、システムの日常的な運用保守 (O&M) において各リクエストの応答時間を収集して統計を取る場合、p25、p50、p90、p99 などのパーセンタイルを使用して、応答時間の分布を分析する必要があります。
パーセンタイルは概算で計算されます。端に近いパーセンタイルほど、通常は精度が高くなります。たとえば、P1 と P99 は、通常 P50 よりも精度が高くなります。
-
パラメーター
パラメーター
説明
AggName
集約操作の一意の名前です。この名前に基づいて、特定の集約操作の結果をクエリできます。
FieldName
集約操作を実行するフィールドの名前です。 LONG、DOUBLE、DATE 型のみがサポートされています。
Percentiles
p50、p90、p99 などのパーセンタイルです。1 つ以上のパーセンタイルを指定できます。
Missing
フィールド値が空の場合に、その行の集約操作で使用するデフォルト値です。
-
Missing に値を指定しない場合、その行は無視されます。
-
Missing に値を指定した場合、このパラメーターの値がその行のフィールド値として使用されます。
-
-
例
/// <summary> /// パーセンタイル統計。 /// </summary> /// <param name="otsClient"></param> public static void PercentilesAggregation(OTSClient otsClient) { PercentilesAggregation percentilesAggregation = new PercentilesAggregation(); percentilesAggregation.AggName = "Percentiles_Agg"; percentilesAggregation.FieldName = "pk1"; percentilesAggregation.Missing = new ColumnValue(10); percentilesAggregation.Percentiles = new List<double> { 10.0, 30.0, 60.0, 90.0, 100.0 }; MatchAllQuery matchAllQuery = new MatchAllQuery(); SearchQuery searchQuery = new SearchQuery(); searchQuery.AggregationList = new List<IAggregation> { percentilesAggregation }; searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse)); }
フィールド値によるグループ化
フィールド値に基づいてクエリ結果をグループ化する集計方法です。同じ値がグループ化されます。各グループの値と、そのグループ内の行数が返されます。
グループ内の行数が非常に多い場合、算出される件数が実際の件数と異なる場合があります。
-
パラメーター
パラメーター
説明
GroupByName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作の実行に使用するフィールドの名前です。LONG、DOUBLE、ブール型、キーワード型、および DATE 型のみがサポートされています。
Size
返すグループの数です。デフォルト値:10。最大値:2000。グループ数が 2,000 を超える場合、最初の 2,000 グループのみが返されます。
GroupBySorters
グループのソート規則です。デフォルトでは、グループ内の行数に基づいて降順でソートされます。複数のソート規則を設定した場合、設定した順序でグループがソートされます。サポートされているパラメーター:
-
値をアルファベット順にソートします。
-
値をアルファベット逆順にソートします。
-
行数で昇順にソートします。
-
行数で降順にソートします。
-
サブ集計結果の値で昇順にソートします。
-
サブ集計結果の値で降順にソートします。
SubAggregation と SubGroupBy
サブ集計操作です。グループ化結果に基づいてサブ集計操作を実行できます。
-
シナリオ
各カテゴリについて、製品数と最大・最小製品価格をクエリします。
-
方法
製品カテゴリでクエリ結果をグループ化して、各カテゴリの製品数を取得します。次に、2 つのサブ集計操作を実行して、各カテゴリの最大および最小の製品価格を取得します。
-
サンプル結果
-
果物:5、最高価格 2 米ドル、最低価格 0.5 米ドル
-
日用品:10、最高価格 13 米ドル、最低価格 0.1 米ドル
-
電子機器:3、最高価格 1,160 米ドル、最低価格 310 米ドル
-
その他の製品:15、最高価格 130 米ドル、最低価格 11 米ドル
-
-
-
例
/// <summary> /// フィールド値によるグループ化。 /// </summary> /// <param name="otsClient"></param> public static void GroupByField(OTSClient otsClient) { GroupByField groupByField = new GroupByField { GroupByName = "GroupBy_Field", FieldName = "pk0", GroupBySorters = new List<GroupBySorter>{ new GroupBySorter() { RowCountSort = new RowCountSort{ Order = SortOrder.DESC } }, new GroupBySorter() { GroupKeySort = new GroupKeySort{ Order = SortOrder.DESC } } } }; MatchAllQuery matchAllQuery = new MatchAllQuery(); SearchQuery searchQuery = new SearchQuery(); searchQuery.GroupByList = new List<IGroupBy> { groupByField }; searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse)); }
範囲によるグループ化
フィールドの値の範囲に基づいてクエリ結果をグループ化する集計方法です。特定の範囲内にあるフィールド値は同じグループにまとめられます。各範囲に含まれる値の数が返されます。
-
パラメーター
パラメーター
説明
GroupByName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作を実行するフィールドの名前です。LONG および DOUBLE タイプのみがサポートされています。
Range[double_from, double_to)
グループ化のための値の範囲です。
値の範囲は double.MinValue から始まり、 double.MaxValue で終了できます。
SubAggregation and SubGroupBy
サブ集計操作です。グループ化の結果に基づいてサブ集計操作を実行できます。
たとえば、販売量と省に基づいてクエリ結果をグループ化した後、指定した範囲における販売量の割合が最も大きい省を取得できます。
-
例
/// <summary> /// 範囲によるクエリ。 /// </summary> /// <param name="otsClient"></param> public static void GroupByRange(OTSClient otsClient) { GroupByRange groupByRange = new GroupByRange(); groupByRange.GroupByName = "GroupBy_Range"; groupByRange.FieldName = "pk1"; groupByRange.Ranges = new List<Range> { new Range(double.MinValue, 5.0), new Range(5.0, 50.0), new Range(50.0, 100.0), new Range(100.0, double.MaxValue) }; MatchAllQuery matchAllQuery = new MatchAllQuery(); SearchQuery searchQuery = new SearchQuery(); searchQuery.GroupByList = new List<IGroupBy> { groupByRange }; searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse)); }
地理的位置によるグループ化
地理的位置から中心点までの距離に基づいてクエリ結果をグループ化する集計方法です。特定の範囲内の距離にあるクエリ結果を同じグループにまとめます。各範囲に含まれる値の数が返されます。
-
パラメーター
パラメーター
説明
GroupByName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作に使用するフィールドの名前です。GEOPOINT 型のみをサポートします。
Origin(double latitude, double longitude)
中心点の緯度と経度です。
latitude は中心点の緯度を、longitude は中心点の経度を指定します。
Range[double_from, double_to)
グループ化に使用する距離の範囲です。単位:メートル。
値の範囲は double.MinValue から開始し、double.MaxValue で終了できます。
SubAggregation and SubGroupBy
サブ集計操作です。グループ化の結果に基づいてサブ集計操作を実行できます。
-
例
/// <summary> /// 地理的位置によるグループ化。 /// </summary> /// <param name="otsClient"></param> public static void GroupByGeoDistance(OTSClient otsClient) { GroupByGeoDistance groupByGeoDistance = new GroupByGeoDistance { GroupByName = "GroupBy_GeoDistance", FieldName = "geo_col", Origin = new GeoPoint(0, 0), Ranges = new List<Range> { new Range(double.MinValue , 1000.0), new Range(1000.0, 5000.0), new Range(5000.0, double.MaxValue) } }; MatchAllQuery matchAllQuery = new MatchAllQuery(); SearchQuery searchQuery = new SearchQuery(); searchQuery.GroupByList = new List<IGroupBy> { groupByGeoDistance }; searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse)); }
GroupBy フィルター
クエリ結果をフィルタリングしてグループ化し、各フィルターに一致する結果の数を取得する集計方法です。結果は、フィルターが指定された順序で返されます。
-
パラメーター
パラメーター
説明
GroupByName
集計オペレーションの一意の名前です。この名前に基づいて、特定の集計オペレーションの結果をクエリできます。
Filters
クエリに使用するフィルターです。結果は、フィルターが指定された順序で返されます。
SubAggregation と SubGroupBy
サブ集計オペレーションです。グループ化結果に基づいてサブ集計オペレーションを実行できます。
-
例
/// <summary> /// GroupBy フィルター /// </summary> /// <param name="otsClient"></param> public static void GroupByFilter(OTSClient otsClient) { GroupByFilter groupByFilter = new GroupByFilter { GroupByName = "GroupBy_Filter", Filters = new List<IQuery> { new RangeQuery { FieldName = "pk1", From = new ColumnValue(0.0), To = new ColumnValue(5.0) }, } }; TermsQuery termsQuery = new TermsQuery(); termsQuery.FieldName = "pk0"; termsQuery.Terms = new List<ColumnValue> { new ColumnValue("Tablestore SearchIndex"), new ColumnValue("SearchIndex") }; SearchQuery searchQuery = new SearchQuery(); searchQuery.GroupByList = new List<IGroupBy> { groupByFilter }; searchQuery.Query = termsQuery; searchQuery.Limit = 0; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); Console.WriteLine(JsonConvert.SerializeObject(searchResponse)); }
ヒストグラムによるクエリ
特定のデータ間隔に基づいてクエリ結果をグループ化する集計方法です。同じ範囲内にあるフィールド値がグループ化されます。各グループの値の範囲と、各グループ内の値の数が返されます。
-
パラメーター
パラメーター
説明
GroupByName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
FieldName
集計操作を実行するフィールドの名前です。LONG および DOUBLE タイプのみがサポートされています。
Interval
集計結果の取得に使用するデータ間隔です。
FieldRange[min,max]
interval パラメーターと組み合わせてグループ数を制限する範囲です。
(FieldRange.max-FieldRange.min)/intervalの数式で計算される値は、2,000 を超えることはできません。MinDocCount
最小行数です。グループ内の行数が最小行数未満の場合、そのグループの集計結果は返されません。
Missing
フィールド値が空の行に対し、集計時に使用する値です。
-
Missing に値を指定しない場合、その行は無視されます。
-
Missing に値を指定した場合、このパラメーターの値が行のフィールド値として使用されます。
-
-
例
/// <summary> /// ヒストグラムによるクエリ。 /// </summary> /// <param name="otsClient"></param> public static void HistogramAggregation(OTSClient otsClient) { GroupByHistogram groupByHistogram = new GroupByHistogram(); groupByHistogram.GroupByName = "GroupBy_Histogram"; groupByHistogram.FieldName = "pk1"; groupByHistogram.Interval = new ColumnValue(5); groupByHistogram.Missing = new ColumnValue(100); groupByHistogram.FieldRange = new FieldRange(new ColumnValue(0), new ColumnValue(1000)); MatchAllQuery matchAllQuery = new MatchAllQuery(); ; SearchQuery searchQuery = new SearchQuery(); searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; searchQuery.GroupByList = new List<IGroupBy> { groupByHistogram }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); foreach (GroupByHistogramResultItem item in searchResponse.GroupByResults.GetAsGroupByHistogramResult("GroupBy_Histogram").GroupByHistogramResultItems) { Console.WriteLine(JsonConvert.SerializeObject(item)); } }
各グループの集計結果から取得した行のクエリ
クエリ結果をグループ化した後、各グループ内の行をクエリできます。この方法は、MySQL の ANY_VALUE(field) 関数と同様に使用できます。
各グループの集計結果から行をクエリする場合、多次元インデックスに NESTED、GEOPOINT、ARRAY、および DATE フィールドが含まれていると、返される結果にはプライマリキー情報のみが含まれます。必要なフィールドを取得するには、データテーブルをクエリする必要があります。
-
パラメーター
パラメーター
説明
AggName
集計操作の一意の名前です。この名前に基づいて、特定の集計操作の結果をクエリできます。
Limit
各グループで返される最大行数です。デフォルトでは、1 行のデータのみが返されます。
Sort
グループ内のデータをソートするためのソート方法です。
ColumnsToGet
返すフィールドです。多次元インデックス内のフィールドのみ指定できます。ARRAY、DATE、GEOPOINT、および NESTED フィールドはサポートされていません。
このパラメーターの値は、SearchRequest の columnsToGet の値と同じです。SearchRequest で columnsToGet を指定するだけで十分です。
-
例
/// <summary> /// 各グループの集計結果から取得した行のクエリ。 /// </summary> /// <param name="otsClient"></param> public static void TopRowsAggregation(OTSClient otsClient) { GroupByField groupByField = new GroupByField(); groupByField.GroupByName = "GroupBy_Field"; groupByField.FieldName = "pk0"; groupByField.SubAggregations = new List<IAggregation> { new TopRowsAggregation { AggName = "TopRows_Agg", Sort = new Sort(new List<ISorter> { new FieldSort("pk1", SortOrder.DESC) }), Limit = 2 } }; MatchAllQuery matchAllQuery = new MatchAllQuery(); ; SearchQuery searchQuery = new SearchQuery(); searchQuery.Query = matchAllQuery; searchQuery.Limit = 0; searchQuery.GroupByList = new List<IGroupBy> { groupByField }; SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery); SearchResponse searchResponse = otsClient.Search(searchRequest); foreach (GroupByFieldResultItem item in searchResponse.GroupByResults.GetAsGroupByFieldResult("GroupBy_Field").GroupByFieldResultItems) { foreach (Row row in item.SubAggregationResults.GetAsTopRowsAggregationResult("TopRows_Agg").Rows) { Console.WriteLine(JsonConvert.SerializeObject(row)); } } }
ネスト
ネストを使用して、グループ内でサブアグリゲーション操作を実行できます。たとえば、最大 2 レベルまでのネストアグリゲーション操作を実行できます。
-
GroupBy + SubGroupBy:アイテムを都道府県別および市区町村別にグループ化して、各都道府県の各市区町村のデータを取得します。
-
GroupBy + SubAggregation:アイテムを都道府県別にグループ化し、各都道府県ごとにメトリクスの最大値を計算して取得します。
パフォーマンスと複雑さのバランスを取るため、特定の数のネストレイヤーしか使用できません。詳細については、「多次元インデックスの制限」をご参照ください。
/// <summary>
/// ネスト。
/// </summary>
/// <param name="otsClient"></param>
public static void SubGroupBy(OTSClient otsClient)
{
GroupByField groupByField = new GroupByField();
groupByField.GroupByName = "Field_GroupBy";
groupByField.FieldName = "pk0";
groupByField.SubGroupBys = new List<IGroupBy>
{
new GroupByRange
{
GroupByName = "Range_GroupBy",
FieldName = "pk1",
Ranges = new List<Range>
{
new Range(double.MinValue, 5),
new Range(5,100),
new Range(100, double.MaxValue)
}
}
};
MatchAllQuery matchAllQuery = new MatchAllQuery();
SearchQuery searchQuery = new SearchQuery();
searchQuery.GroupByList = new List<IGroupBy>
{
groupByField
};
searchQuery.GetTotalCount = true;
searchQuery.Limit = 0;
searchQuery.Query = matchAllQuery;
SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
SearchResponse searchResponse = otsClient.Search(searchRequest);
foreach (GroupByFieldResultItem item in searchResponse.GroupByResults.GetAsGroupByFieldResult("Field_GroupBy").GroupByFieldResultItems)
{
Console.WriteLine(JsonConvert.SerializeObject(item.SubGroupByResults.GetAsGroupByRangeResult("Range_GroupBy")));
}
}
複数アグリゲーション
複数のアグリゲーション操作を実行できます。
複数の複雑なアグリゲーション操作を同時に実行する場合、時間が長くかかることがあります。
/// <summary>
/// 複数のアグリゲーションを実行します。
/// </summary>
/// <param name="otsClient">OTSClient オブジェクト。</param>
public static void MultipleAggregation(OTSClient otsClient)
{
MaxAggregation maxAggregation = new MaxAggregation();
maxAggregation.AggName = "Max_Agg";
maxAggregation.FieldName = "pk1";
MinAggregation minAggregation = new MinAggregation();
minAggregation.AggName = "Min_Agg";
minAggregation.FieldName = "pk1";
SumAggregation sumAggregation = new SumAggregation();
sumAggregation.AggName = "Sum_Agg";
sumAggregation.FieldName = "pk1";
SearchQuery searchQuery = new SearchQuery();
searchQuery.Limit = 0;
searchQuery.Query = new MatchAllQuery();
searchQuery.AggregationList = new List<IAggregation>
{
maxAggregation,
minAggregation,
sumAggregation
};
SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
SearchResponse searchResponse = otsClient.Search(searchRequest);
Console.WriteLine(JsonConvert.SerializeObject(searchResponse));
}