dcount() (集計関数)
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
概要グループ内の、スカラー式によって取得された個別の値の概数を計算します。
Null 値は無視され、計算には考慮されません。
Note
dcount() 集計関数は、主に大規模なセットのカーディナリティを推定するために役立ちます。 パフォーマンスの精度を交換し、実行ごとに異なる結果を返す場合があります。 入力の順序が出力に影響を与える可能性があります。
Note
この関数は、summarize 演算子と組み合わせて使用します。
構文
dcount(expr[, accuracy])
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| expr | string |
✔️ | 個別の値をカウントする入力。 |
| 精度 | int |
要求された推定精度を定義する値。 既定値は 1 です。 サポートされている値に関する推定精度を参照してください。 |
返品
グループ内の expr の個別の値の数の推定値を返します。
例
以下の例では、各州で発生した嵐の事象の種類の数を示します。
StormEvents
| summarize DifferentEvents=dcount(EventType) by State
| order by DifferentEvents
表示される結果テーブルには、最初の 10 行のみが含まれます。
| 都道府県 | DifferentEvents |
|---|---|
| テキサス州 | 27 |
| CALIFORNIA | 26 |
| ペンシルベニア | 25 |
| GEORGIA | 24 |
| ILLINOIS | 23 |
| メリーランド | 23 |
| ノースカロライナ | 23 |
| ミシガン | 22 |
| FLORIDA | 22 |
| オレゴン | 21 |
| KANSAS | 21 |
| ... | ... |
推定精度
この関数では、セット カーディナリティの確率的推定を行う HyperLogLog (HLL) アルゴリズム の異形が使用されます。 アルゴリズムには、メモリ サイズごとの精度と実行時間のバランスを取るために使用できる "ノブ" が用意されています。
| 精度 | エラー (%) | エントリ数 |
|---|---|---|
| 0 | 1.6 | 212 |
| 1 | 0.8 | 214 |
| 2 | 0.4 | 216 |
| 3 | 0.28 | 217 |
| 4 | 0.2 | 218 |
Note
"エントリ数" 列は、HLL 実装における 1 バイト カウンターの数です。
セット カーディナリティが十分に小さい場合、アルゴリズムには完璧なカウント (ゼロ エラー) を行うためのいくつかの条件が含まれています。
- 精度レベルが
1の場合は 1,000 個の値を返す - 精度レベルが
2の場合は 8,000 個の値を返す
誤り限界は確率的であり、理論限界ではありません。 値は、誤差分布の標準偏差 (シグマ) であり、推定量 の 99.7% は 3 x シグマ未満の相対エラーになります。
次の図は、サポートされているすべての精度設定の相対的な推定誤差の確率分布関数をパーセントで示したものです。
