Commande .show table data statistics

Article
11/23/2024

S’applique à : ✅Microsoft Fabric ✅Azure Data Explorer

Affiche l’estimation des statistiques de données de table par colonne de table.

Remarque

Cette commande retourne uniquement des statistiques pour les données stockées dans les magasins columnar. Les statistiques de données du magasin de lignes ne sont pas retournées.

autorisations

Vous devez disposer au moins des autorisations Utilisateur de base de données, Visionneuse de base de données ou Moniteur de base de données pour exécuter cette commande. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle.

Syntaxe

.showtable TableName [ with ( PropertyName = data statistics PropertyValue [, ...] ])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
TableName	`string`	✔️	Nom de la table pour laquelle afficher les statistiques.
PropertyName, PropertyValue	`string`		Liste séparée par des virgules des propriétés prises en charge facultatives.

Propriétés prises en charge

Les propriétés suivantes peuvent être spécifiées. Toutes les propriétés sont facultatives.

Nom de la propriété	Description	Valeurs de propriétés
`samplepercent`	Analyse le pourcentage de données spécifié.	Entier compris entre 0 et 100
`scope`	Définit si seul le cache chaud est analysé ou si les données entières sont analysées.	Spécifiez `"hotcache"` pour analyser uniquement les données de cache à chaud ou `"all"` pour analyser toutes les données.
`from`	Analyse les étendues de données créées après cette période.	`datetime`
`to`	Analysez les étendues de données créées avant cette heure.	`datetime`

Si aucune option n’est fournie, seuls 1 % des données de cache à chaud sont analysées.

Retours

La commande retourne une table de résultats qui contient les informations suivantes.

Nom de la colonne	Type	Description
`ColumnName`	`string`	Nom de colonne de table.
`ColumnType`	`string`	Type de données de colonne de table.
`ColumnId`	`guid`	ID interne de colonne de table.
`OriginalSize`	`long`	Estimation de la taille des données ingérées en octets.
`ExtentSize`	`long`	Estimation de la taille totale des étendues (taille de données + taille d’index) en octets.
`CompressionRatio`	`real`	Ratio de la taille des données d’origine à la taille des données dans l’étendue.
`DataCompressedSize`	`long`	Taille des données d’étendue en octets, à l’exclusion des index.
`SharedIndexSize`	`long`	Taille de l’index de texte en octets. L’index de texte est partagé par toutes les colonnes de tableau.
`IndexSize`	`long`	Taille des index numériques en octets.
`IndexSizePercent`	`real`	Ratio de la taille d’index à la taille de données d’origine en octets.
`StorageEngineVersion`	`string`	Version du moteur. Si des données existent pour plusieurs versions du moteur, la sortie inclut une entrée pour chaque version.
`PresentRowCount`	`long`	Nombre total de lignes, à l’exclusion des lignes supprimées .
`DeletedRowCount`	`long`	Nombre de lignes supprimées .
`SamplePercent`	`real`	Pourcentage réel d’échantillonnage des données, qui peut différer de l’indicateur fourni dans `samplepercent` l’option.
`IncludeColdData`	`bool`	Indique si les données à froid ont été prises en compte lors du calcul de l’estimation des statistiques.

Remarque

ExtentSize n’inclut pas la taille d’index de texte partagé. Il existe deux façons de calculer la taille totale des données de table :

Additionnez toutes les ExtentSize valeurs et ajoutez la SharedIndexSize valeur.
Exécutez la commande .show table details et utilisez la TotalExtentSize valeur.

Exemple

.show table Users data statistics with (scope="all", samplepercent=80)

Sortie

ColumnName	ColumnType	ColumnId	OriginalSize	ExtentSize	CompressionRatio	DataCompressedSize	SharedIndexSize	IndexSize	IndexSizePercent	StorageEngineVersion	PresentRowCount	SamplePercent	IncludeColdData
Nom	chaîne	45c15cfe-ef38-4153-97e7-c18d21651fc2	60907	137305	0.44	137305	27787	0	0	V3	2500	80	True
Utilisation	real	c0aa6668-0f73-46a1-874e-f1b19123eb61	20000	20282	0.99	20102	27787	180	0,9	V3	2500	80	True
id	long	eb01bab7-da60-4515-a5d4-4780a827bd85	20000	5722	3.49	5152	27787	570	2.85	V3	2500	80	True

Partager via