.show table data statistics 命令

按表列显示表中数据统计信息估算。

注意

此命令仅返回列式存储中存储的数据的统计信息。不返回行存储数据统计信息。

权限

你必须至少具有数据库用户、数据库查看者或数据库监视者权限才能运行此命令。有关详细信息，请参阅基于角色的访问控制。

.showtableTableNamedatastatistics [ with(PropertyName=PropertyValue [, ...]) ]

详细了解语法约定。

客户	类型	必需	说明
TableName	`string`	✔	要显示其统计信息的表的名称。
PropertyName、PropertyValue	`string`		可选受支持属性的逗号分隔列表。

可以指定下列属性。所有属性都是可选的。

属性名称	说明	属性值
`samplepercent`	扫描指定百分比的数据。	一个介于 0 和 100 之间的整数
`scope`	定义是仅扫描热缓存数据还是扫描全部数据。	指定 `"hotcache"` 仅扫描热缓存数据，指定 `"all"` 扫描所有数据。
`from`	扫描在此时间之后创建的数据区。	`datetime`
`to`	扫描在此时间之前创建的数据区。	`datetime`

如果未提供任何选项，则仅扫描 1% 的热缓存数据。

该命令返回一个结果表，其中包含以下信息。

列名	类型	描述
`ColumnName`	`string`	表列名称。
`ColumnType`	`string`	表列数据类型。
`ColumnId`	`guid`	表列内部 ID。
`OriginalSize`	`long`	估算的已引入数据大小（以字节为单位）。
`ExtentSize`	`long`	估算的区的总大小（数据大小 + 索引大小），以字节为单位。
`CompressionRatio`	`real`	原始数据大小与区数据大小的比率。
`DataCompressedSize`	`long`	区数据大小（以字节为单位），不包括索引。
`SharedIndexSize`	`long`	文本索引大小（以字节为单位）。文本索引由所有表列共享。
`IndexSize`	`long`	数字索引的大小（以字节为单位）。
`IndexSizePercent`	`real`	索引大小与原始数据大小（以字节为单位）的比率。
`StorageEngineVersion`	`string`	引擎版本。如果多个引擎版本存在数据，输出将为每个版本包含一个条目。
`PresentRowCount`	`long`	总行计数，不包括已删除的行。
`DeletedRowCount`	`long`	已删除的行计数。
`SamplePercent`	`real`	实际数据采样百分比，可能与 `samplepercent` 选项中提供的提示不同。
`IncludeColdData`	`bool`	计算统计信息估值时是否考虑了冷数据。

注意

ExtentSize 不包括共享文本索引大小。可通过两种方式计算总表数据大小：

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

输出

ColumnName	ColumnType	ColumnId	OriginalSize	ExtentSize	CompressionRatio	DataCompressedSize	SharedIndexSize	IndexSize	IndexSizePercent	StorageEngineVersion	PresentRowCount	SamplePercent	IncludeColdData
名称	字符串	45c15cfe-ef38-4153-97e7-c18d21651fc2	60907	137305	0.44	137305	27787	0	0	V3	2500	80	True
使用情况	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