Aller au contenu

Base de données

tilttek/leaderboards-bundle
TableCléContient
tilttek_leaderboards_contributionclassement, activitéCe que chaque activité a apporté à chaque classement et à ses critères de départage, dans quelle période, pour quel membre ; c'est la clé qui fait qu'une activité ne compte qu'une fois
tilttek_leaderboards_scoreclassement, période, membreLe score et les critères de départage de chaque membre dans chaque classement et période, et quand il a été atteint ; indexée sur le classement, la période, le score, les critères de départage et le moment, l'ordre des rangs
tilttek_leaderboards_snapshotclassement, périodeLes classements figés à la fin d'une période : quand, et combien de membres étaient classés
tilttek_leaderboards_placingclassement, période, membreLes lignes des membres dans chaque instantané : rang, score, moment
tilttek_leaderboards_appearancemembreComment paraît chaque membre qui a choisi de paraître : named ou pseudonym, avec le pseudonyme
tilttek_leaderboards_league_tierclassement, membreLe palier que chaque membre a atteint dans chaque classement doté d'une ligue
tilttek_leaderboards_league_membershipclassement, semaine, membreLe palier, la division et la cohorte de chaque membre dans chaque semaine où il a pris part, quand il est arrivé et où il est allé à la fin ; indexée sur le classement, la semaine, le palier et la division ; la clé place un membre une fois par semaine
tilttek_leaderboards_league_weekclassement, semaineLes semaines réglées, et quand ; la clé règle une semaine une seule fois
tilttek_leaderboards_leadclassement, période, membreLes premières places prises à mesure que les scores changent, avec celebrate_on: score_change, et quand ; indexée sur le membre ; la clé dit une seule fois à un membre, par classement et par période, qu'il a pris la tête

La référence d'un membre compte 320 octets au plus (un genre de 64, un deux-points et un identifiant de 255), le code d'une période 64, et la clé d'un classement 96 dans les tables des contributions, des scores, des instantanés, des lignes d'instantané et des premières places : son nom de 64 ou, pour un classement par objet, son nom, @ et une empreinte de 24. Les critères de départage occupent deux colonnes, tie_break_1 et tie_break_2, et tie_breaks dit combien une ligne en contient. Les moments (occurred_at, reached_at, taken_at, joined_at, settled_at) sont des colonnes du type datetime_utc_immutable : écrits en UTC, à la seconde, et relus en UTC, quels que soient le fuseau du moment donné et le fuseau par défaut de PHP. La colonne placing est entre guillemets dans chaque instruction, un mot réservé de PostgreSQL.

Avec valkey activé, les contributions et les scores sont gardés dans Valkey à la place des deux premières tables, dans les ensembles triés que décrit la bibliothèque ; les autres tables restent. Les commandes envoyées sont communes : EVAL de courts scripts qui appellent HSET, HSETNX, HGET, HDEL, SADD, SREM, ZADD et ZREM, et HGET, HMGET, SMEMBERS, ZRANGE, ZLEXCOUNT et ZCARD, par rawCommand() du client ou executeRaw() de Predis, de sorte que l'extension redis, Relay, Predis et ValkeyGlide de valkey-glide-php les servent également. Rien ne demande au serveur de persister : ni SAVE, ni BGSAVE, ni CONFIG SET n'est envoyé, et la persistance propre du serveur (instantanés RDB, AOF) s'applique telle que configurée, ou pas du tout sur un serveur géré qui l'interdit ou dans les tests. Un serveur qui perd ses données perd les scores, jamais les instantanés, les choix, les ligues et les premières places gardés dans store ; tilttek:activity:rebuild leaderboards reconstruit ceux que mesure le journal, tandis que les valeurs qu'une application rapporte sont rapportées de nouveau par elle.

Une contribution, un instantané, une appartenance et une semaine réglée sont insérés par une instruction qui n'écrit rien quand la ligne existe : ON CONFLICT DO NOTHING sur PostgreSQL, INSERT IGNORE sur MySQL et MariaDB, INSERT OR IGNORE sur SQLite. Ainsi, deux processus qui remettent la même activité ne la comptent qu'une fois sans interrompre leurs transactions. Un score est remplacé (supprimé puis inséré) dans une seule transaction ; un score rapporté est inséré de la même façon quand le membre n'en a aucun, ou sinon écrit par un UPDATE dont la condition est la comparaison (reached_at <= ? et d'autres valeurs pour latest, une meilleure valeur ou un meilleur critère de départage pour highest), si bien que de deux rapports au même moment, un plus ancien ou plus bas ne remplace jamais l'autre ; les moments sont gardés à la seconde, et deux rapports latest dans la même seconde comptent comme atteints ensemble ; les lignes d'un instantané sont insérées dans la transaction de l'instantané, et le choix d'un membre est remplacé de la même façon. Une semaine se règle dans une seule transaction qui commence par insérer sa ligne : un second règlement n'insère rien et n'écrit rien d'autre. Deux membres qui entrent dans une division au même moment peuvent se partager sa dernière place, qui en compte alors un de plus : une division compte environ sa taille.

Ces instructions s'exécutent sur SQLite, MySQL 8.4 et PostgreSQL 17 dans les tests du bundle ; MariaDB suit le chemin de MySQL.