Firestore en mode Datastore conserve des statistiques sur les données stockées pour une application, telles que le nombre d'entités d'un genre donné ou l'espace utilisé par les valeurs de propriété d'un type donné. Vous pouvez consulter ces statistiques dans la console Google Cloud. Accédez à la page Tableau de bord ou exécutez une requête GQL sous la forme SELECT * FROM __Stat_Kind__ à partir de la page Entités.
Vous pouvez également accéder à ces valeurs de manière automatisée dans l'application en interrogeant des entités spécialement désignées à l'aide de l'API Datastore. Chaque statistique est accessible en tant qu'entité dont le nom de genre commence et se termine par deux traits de soulignement. Par exemple, chaque application possède exactement une entité de genre __Stat_Total__, qui représente des statistiques sur toutes les entités du mode Datastore au total. Chaque entité statistique possède les propriétés suivantes :
count, le nombre d'éléments pris en compte par la statistique (un entier long)bytes, la taille totale des éléments pour cette statistique (un entier long)timestamp, l'heure de la mise à jour de la statistique la plus récente (une valeur date-heure)
Certains genres de statistiques possèdent également des propriétés supplémentaires, répertoriées ci-dessous.
Lorsque le système de statistiques crée des entités statistiques, il ne supprime pas immédiatement les anciennes. La meilleure façon d'obtenir une vue cohérente des statistiques consiste à rechercher l'entité statistique avec la valeur timestamp la plus récente, puis à utiliser cette valeur d'horodatage comme filtre lors de l'extraction d'autres entités statistiques.
Les entités statistiques sont incluses dans les valeurs statistiques calculées. Elles utilisent l'espace en fonction du nombre de noms de propriétés et de genres uniques utilisés par l'application.
Le système de statistiques créera également des statistiques spécifiques à chaque espace de noms. Attention, si une application n'utilise pas les espaces de noms, les statistiques spécifiques à un espace de noms ne seront pas créées. Les statistiques spécifiques à un espace de noms se trouvent dans l'espace de noms auquel elles se rapportent. Les noms de genres pour les statistiques spécifiques à un espace de noms portent le préfixe __Stat_Ns_ et le même suffixe que les genres de statistiques à l'échelle de l'application.
Liste des statistiques
La liste complète des statistiques disponibles est la suivante :
| Statistique | Genre d'entité statistique | Description |
|---|---|---|
| Toutes les entités | __Stat_Total__ Entrée spécifique d'un espace de noms: __Stat_Ns_Total__ |
Toutes les entités. Propriétés supplémentaires : • entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées• composite_index_bytes : l'espace de stockage dans les entrées d'index composite, mesuré en octets• composite_index_count : le nombre d'entrées d'index composite |
| Toutes les entités dans un espace de noms | __Stat_Namespace__Notez que les entités __Stat_Namespace__ sont créées pour chaque espace de noms rencontré et ne se trouvent que dans l'espace de noms de chaîne vide. |
Toutes les entités dans un espace de noms. • subject_namespace : l'espace de noms représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées• composite_index_bytes : l'espace de stockage dans les entrées d'index composite, mesuré en octets• composite_index_count : le nombre d'entrées d'index composite |
| Toutes les entrées dans les index définis par l'application | __Stat_Kind_CompositeIndex__Entrée spécifique d'un espace de noms: __Stat_Ns_Kind_CompositeIndex__ |
Entrées dans la table d'index composite ; une entité statistique pour chaque genre d'entité stockée. Propriétés supplémentaires : • index_id : l'identifiant de l'index• kind_name : le nom du genre représenté (une chaîne) |
| Entités d'un genre | __Stat_Kind__ Entrée spécifique d'un espace de noms: __Stat_Ns_Kind__ |
Entités d'un genre ; une entité statistique pour chaque genre d'entité stocké. Propriétés supplémentaires : • kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées• composite_index_bytes : l'espace de stockage dans les entrées d'index composite, mesuré en octets• composite_index_count : le nombre d'entrées d'index composite |
| Entités racines d'un genre | __Stat_Kind_IsRootEntity__ Entrée spécifique d'un espace de noms: __Stat_Ns_Kind_IsRootEntity__ |
Entités d'un genre qui sont les entités racines d'un groupe d'entités (sans parent ascendant) ; une entité statistique pour chaque genre d'entité stocké. Propriétés supplémentaires : • kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets |
| Entités non racines d'un genre | __Stat_Kind_NotRootEntity__ Entrée spécifique d'un espace de noms: __Stat_Ns_Kind_NotRootEntity__ |
Entités d'un genre qui ne sont pas les entités racines d'un groupe d'entités (avec parent ascendant) ; une entité statistique pour chaque genre d'entité stocké. Propriétés supplémentaires : • kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets |
| Propriétés d'un type | __Stat_PropertyType__ Entrée spécifique d'un espace de noms: __Stat_Ns_PropertyType__ |
Propriétés d'un type de valeur sur l'ensemble des entités ; une entité statistique par type de valeur. Propriétés supplémentaires : • property_type : nom du type de valeur (une chaîne)• entity_bytes : espace de stockage de la table des entités mesuré en octets.• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées |
| Propriétés d'un type par genre | __Stat_PropertyType_Kind__ Entrée spécifique d'un espace de noms: __Stat_Ns_PropertyType_Kind__ |
Propriétés d'un type de valeur sur les entités d'un genre donné ; une entité statistique par combinaison de type de propriété et de genre. Propriétés supplémentaires : • property_type : le nom du type de valeur (une chaîne)• kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées |
| Propriétés comportant un nom | __Stat_PropertyName_Kind__ Entrée spécifique d'un espace de noms: __Stat_Ns_PropertyName_Kind__ |
Propriétés avec un nom donné sur les entités d'un genre donné ; une entité statistique par combinaison de nom de propriété unique et de genre. Propriétés supplémentaires : • property_name : le nom de la propriété (une chaîne)• kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées |
| Propriétés d'un type comportant un nom | __Stat_PropertyType_PropertyName_Kind__ Entrée spécifique d'un espace de noms: __Stat_Ns_PropertyType_PropertyName_Kind__ |
Propriétés avec un nom donné et un type de valeur donné sur les entités d'un genre donné ; une entité statistique par combinaison de nom de propriété, de type de valeur et de genre existant dans la base de données. Propriétés supplémentaires : • property_type : le nom du type de valeur (une chaîne)• property_name : le nom de la propriété (une chaîne)• kind_name : le nom du genre représenté (une chaîne)• entity_bytes : l'espace de stockage dans la table des entités, mesuré en octets• builtin_index_bytes : l'espace de stockage dans les entrées d'index intégrées, mesuré en octets• builtin_index_count : le nombre d'entrées d'index intégrées |
Certaines statistiques font référence aux types de valeur de propriété par nom, sous forme de chaînes. Ces noms sont les suivants :
"Blob""BlobKey""Boolean""Category""Date/Time""Email""Float""GeoPt""IM""Integer""Key""Link""NULL""PhoneNumber""PostalAddress""Rating""ShortBlob""String""Text""User"
Ordre de suppression des entités de statistiques
Les applications comportant des milliers d'espaces de noms, de genres ou de noms de propriétés nécessitent un grand nombre d'entités statistiques. Pour réduire les coûts liés au stockage et à la mise à jour des statistiques, les bases de données Firestore en mode Datastore suppriment progressivement les entités statistiques selon les ordres ci-dessous.
Firestore en mode Datastore suit séparément la taille des entités statistiques de genre et celles non liées au genre. La taille des entités statistiques non liées au genre n'a aucune incidence sur la suppression des statistiques de genre.
Les entités statistiques récapitulatives __Stat_Kind_CompositeIndex__, __Stat_PropertyType__ et __Stat_Total__ ne sont jamais supprimées.
Supprimer la commande pour les entités statistiques de genre
Les statistiques d'entité de genre sont supprimées dans l'ordre suivant:
Statistiques par espace de noms et par genre
__Stat_Ns_Kind____Stat_Ns_Kind_IsRootEntity____Stat_Ns_Kind_NotRootEntity____Stat_Ns_PropertyType_Kind__
Statistiques par genre
__Stat_Kind____Stat_Kind_IsRootEntity____Stat_Kind_NotRootEntity____Stat_PropertyType_Kind__
Abandonner la commande pour les entités statistiques non liées au genre
Les statistiques d'entité non genre sont supprimées dans l'ordre suivant:
Statistiques par espace de noms, par genre et par propriété:
__Stat_Ns_PropertyName_Kind____Stat_Ns_PropertyType_PropertyName_Kind__
Statistiques par genre et par propriété
__Stat_PropertyName_Kind____Stat_PropertyType_PropertyName_Kind__
Statistiques par espace de noms
__Stat_Namespace____Stat_Ns_Kind_CompositeIndex____Stat_Ns_PropertyType____Stat_Ns_Total__