Criando uma definição de estatística para controle de versão
No exemplo anterior, ao criar uma definição de estatística, havia uma dica sobre a importância do parâmetroVersionConfiguration
para o controle de versão. Aqui, detalhamos como usá-lo e como ele funciona.
VersionConfiguration. Esse parâmetro permite definir uma
configuração MaxQueryableVersions, que especifica quantas versões da mesma estatística podemos consultar. Neste caso, definimos para consultar 12 versões.
O parâmetro ResetInterval define com que frequência o processo de redefinição ocorre. Esse processo envolve criar uma estatística com a mesma configuração de
antes, mas sem nenhum valor, e o parâmetro de versão muda da seguinte forma: N = N + 1, com N = 0 na criação da definição da estatística.
Por exemplo, digamos que temos uma estatística com o parâmetro de versão igual a dois e um determinado valor. Agora
aumentamos a versão dessa estatística; o resultado será uma nova estatística com o parâmetro de versão igual a três, sem nenhum valor.
Enquanto isso, a estatística anterior permanece no sistema para ser consultada.
O ResetInterval pode funcionar de várias maneiras. Neste exemplo, ele é mensal, mas pode ser alterado de acordo com as necessidades do desenvolvedor. Neste caso
específico, significa que o placar será redefinido automaticamente todo mês a partir do momento em que foi configurado. Oferecemos suporte às seguintes estratégias de redefinição:
- Day
- Hour
- Manual
- Month
- Week
Incrementando a versão de uma estatística
Com essa nova configuração, podemos ter várias versões da mesma estatística para temporadas diferentes. Mas o que acontece se precisarmos redefinir manualmente o placar devido a um problema e recomeçar a temporada? Nesses casos, podemos executar uma redefinição manual usando a API. Veja um exemplo usando o SDK:Conclusões
Neste tutorial, aprendemos a fazer as seguintes operações:- Criar uma estatística com a estratégia de redefinição correta
- Incrementar a versão de uma estatística
