- 生产者事件
- 名称
- 运算符
- 参数
事件
每个统计信息规则由标题记录的特定事件名称触发。请注意，多个统计信息规则可以由单个事件触发。命名要求
- 规则名称具有”根”名称。可选地后跟一个或多个”字段”。
- 根是一个字母数字字符串。最多可以包含 32 个字符。
- 统计信息实例名称的总长度不得超过 128 个字符。
- 名称必须以字母字符开头，并且只能包含字母、数字和连字符 (-)。不允许出现空格、逗号、句点、下划线或任何其他特殊字符。示例名称有 “EnemiesDefeated”、“BestScoreUnder2Minutes” 和 “Total-Collectibles-Jewels”。
- 字段由点 (.) 字符分隔。
- 字段名称必须与作为生产者事件一部分的字段名称完全匹配。
当一个或多个字段作为统计信息规则名称的一部分包含时，此规则将成为统计信息模板。在运行时，来自生产者事件的字段的实际值将被插入到统计信息实例名称中。
- 一些有效的模板名称示例：“EnemiesDefeated.WeaponID”、“BestScoreUnder2Minutes.TrackId.DifficultyID” 和 “Total-Collectibles-Jewels.Found”。
- 一些有效的实例名称示例：“EnemiesDefeated.WeaponID.17”、“BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane” 和 “Total-Collectibles-Jewels.Found.1”。
数据类型建议
- 我们建议将整数数据类型用于作为统计信息模板名称一部分的事件字段。
-
如果事件字段数据类型为布尔值，则对于
true，插入的值为 “1”；对于false，插入的值为 “0”。 - 如果事件字段数据类型为 Unicode 字符串，则必须确保该字段的潜在值仅包含有效字符（如前所述）。
运算符
统计信息实例的值在处理生产者事件时于运行时计算。统计信息规则使用指定的参数执行操作。支持的操作选项如下。SUMMAXMINREPLACE
参数
参数可以是常量值，也可以是来自生产事件的字段名称，如下表所示。
生成的统计信息实例的数据类型由参数的数据类型决定。
所有运算符都支持整数、浮点数和布尔数据类型。
只有
REPLACE 运算符支持 Unicode 字符串数据类型。
统计信息和参数数据类型如下表所示。
| 统计信息数据类型 | 参数数据类型 | 备注 |
| --- | --- |
| 整数 | Int32、Int64、UInt32、UInt64、Boolean | 支持的最大整数值为 56 位。布尔值从 TRUE 转换为 1，FALSE 转换为 0。 |
| 浮点数 | Float、Double | 64 位浮点数。 |
| 字符串 | UnicodeString、GUID | 最大字符串长度为 50 个字符。 |