[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: Microsoft Fabric ✅ Azure Data Explorer ✅
タイムライン上の ID 列に基づいてセッション数を計算します。 このプラグインは、evaluate 演算子を使用して呼び出されます。
構文
TabularExpression| evaluatesession_count(IdColumn,TimelineColumn,,,, [,, ...],
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| TabularExpression | string |
✔️ | 入力として機能する表形式の式。 |
| IdColumn | string |
✔️ | ユーザー アクティビティを表す ID 値を持つ列の名前。 |
| TimelineColumn | string |
✔️ | タイムラインを表す列の名前。 |
| Start | スカラー型 | ✔️ | 分析期間の開始。 |
| End | スカラー型 | ✔️ | 分析期間の終了。 |
| Bin | スカラー型 | ✔️ | セッションの分析ステップ期間。 |
| LookBackWindow | スカラー型 | ✔️ | セッションのルックバック期間。
IdColumn の ID が LookBackWindow 内の時間枠に表示される場合、セッションは既存の ID と見なされます。 ID が表示されない場合、セッションは新しいセッションと見なされます。 |
| dim1、 dim2、... | string |
セッション数の計算をスライスするディメンション列の一覧。 |
返品
各タイムライン期間と既存のディメンションの組み合わせごとにセッション カウントの値を持つテーブルを返します。
出力テーブル スキーマは次のとおりです。
| TimelineColumn | dim1 | .. | dim_n | count_sessions |
|---|---|---|---|---|
| 型: TimelineColumn 現在 | .. | .. | .. | long |
例
この例では、データは決定論的であり、2 つの列を含むテーブルを使用します。
-
Timeline: 1 から 10,000 の実行中の数値 -
Id: 1 から 50 のユーザーの ID
Id が Timeline の区切り線 (タイムライン % Id == 0) の場合は、特定の Timeline スロットに表示されます。
Id==1 を持つイベントは、任意の Timeline スロットに、Id==2 を持つイベントは 1 つおきの Timeline スロットごとに表示されます。
データの 20 行を次に示します。
let _data = range Timeline from 1 to 10000 step 1
| extend __key = 1
| join kind=inner (range Id from 1 to 50 step 1 | extend __key=1) on __key
| where Timeline % Id == 0
| project Timeline, Id;
// Look on few lines of the data
_data
| order by Timeline asc, Id asc
| take 20
出力
| タイムライン | Id |
|---|---|
| 1 | 1 |
| 2 | 1 |
| 2 | 2 |
| 3 | 1 |
| 3 | 3 |
| 4 | 1 |
| 4 | 2 |
| 4 | 4 |
| 5 | 1 |
| 5 | 5 |
| 6 | 1 |
| 6 | 2 |
| 6 | 3 |
| 6 | 6 |
| 7 | 1 |
| 7 | 7 |
| 8 | 1 |
| 8 | 2 |
| 8 | 4 |
| 8 | 8 |
次の条件でセッションを定義しましょう。セッションは、ユーザー (Id) が 100 のタイム スロットの時間枠で少なくとも 1 回表示され、セッションのルックバック ウィンドウが 41 タイム スロットである限りアクティブであると見なされます。
次のクエリでは、上記の定義に従ってアクティブなセッションの数が表示されます。
let _data = range Timeline from 1 to 9999 step 1
| extend __key = 1
| join kind=inner (range Id from 1 to 50 step 1 | extend __key=1) on __key
| where Timeline % Id == 0
| project Timeline, Id;
// End of data definition
_data
| evaluate session_count(Id, Timeline, 1, 10000, 100, 41)
| render linechart