事务写入

在本教程中，我们将介绍如何对统计信息执行事务写入。根据用于存储统计信息的流程，开发者可能会遇到导致操作重复的情况，尤其是使用 SUM 聚合时。为了解决这些复杂的场景，我们添加了事务写入功能。我们将从一个包含许多同时进行比赛的多人游戏示例开始。该游戏为每场比赛存储大量统计信息和其他遥测值。为了避免干扰玩家体验，工作室决定每 10 分钟推送一次统计信息，而不是实时推送。此方法可确保玩家在不同比赛之间切换时获得无缝体验。但是，它带来了新的技术挑战。我们现在需要一个队列来每 10 分钟执行一次请求。但是如果出于任何原因我们想要重放队列中的事件，会发生什么？那么我们可能会遇到挑战，特别是当我们有使用 SUM 聚合的统计信息时，因为我们需要避免重复计数。有了这个背景，我们将展示如何解决这个特定问题。

创建统计定义

我们首先创建一个统计定义，在此级别，我们不需要为事务写入添加任何特殊配置。

public static async Task CreateStatisticDefinitionAsync(PlayFabAuthenticationContext context, string statName)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
    {
        Name = statName,
        AuthenticationContext = context,
        EntityType = "title_player_account",
        VersionConfiguration = new VersionConfiguration()
        {
            MaxQueryableVersions = 1,
            ResetInterval = ResetInterval.Manual,
        },
        Columns = new List<StatisticColumn>()
        {
            new StatisticColumn()
            {
                Name = "Eliminations",
                AggregationMethod = StatisticAggregationMethod.Sum,
            },
             new StatisticColumn()
            {
                Name = "Caliber",
                AggregationMethod = StatisticAggregationMethod.Min,
            }
        },
    };
    
    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);
}

向统计信息添加数据

继续我们的示例，我们将向先前定义的统计信息添加数据。普通请求和此请求之间的主要区别是特殊的 TransactionId 参数。此参数用作被执行请求的标识符。每次有新请求到达时，系统会将新的事务 ID 与已处理的标识符进行比较。如果找到匹配项，则不会执行该请求。需要考虑的一个关键方面是，这种事务行为在 TransactionId 和被执行的请求之间建立了一种关系，而不是与该请求内的单个统计信息建立关系。不存在针对每个单独统计信息的映射；映射是针对整个请求的。此外，当使用此功能时，我们有一个不同的计量表来跟踪此类请求，在此处了解更多信息：统计计量表

public static async Task UpdateStatisticForPlayer(PlayFabAuthenticationContext context, string statName, string entityId, int eliminationScore, int caliberScore)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    UpdateStatisticsRequest updateStatRequest = new UpdateStatisticsRequest()
    {
        Entity = new PlayFab.LeaderboardsModels.EntityKey()
        {
            Id = entityId,
            Type = EntityType
        },
        AuthenticationContext = context,
        TransactionId = "YOUR_OWN_IDENTIFIER"
        Statistics = new List<PlayFab.LeaderboardsModels.StatisticUpdate>() 
        {
            new PlayFab.LeaderboardsModels.StatisticUpdate() 
            {
                Name = statName,
                Scores = new List<string> { eliminationScore.ToString(), caliberScore.ToString()},
            }
        }
    };

    PlayFabResult<UpdateStatisticsResponse> updateResult = await statsAPI.UpdateStatisticsAsync(updateStatRequest);
}

现在，让我们解释这个例子的一些关键元素：

Entity：此参数对应于我们希望从中进行统计信息更新的实体。
TransactionId：此参数对应于表示请求唯一标识符的字符串。
Statistics：此参数对应于实体的实际统计信息集。
StatisticUpdate：此参数对应于将要添加的统计信息值。
- Scores：此参数对应于您可以添加到一个实体的分数列表。请记住，统计信息可以有多个列。您可以在此处深入了解这些概念：统计信息的更多用法
- Name：此参数对应于您在创建统计定义时设置的统计信息名称。

有了这些明确的概念，您现在已准备好向统计信息添加数据，并避免请求出现任何重复。

另请参阅

最后修改于 2026年8月25日

相关主题

统计信息计量季节性统计信息配额统计元数据统计 ConfigureNBPMCs

⌘I