你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

.show table data statistics 命令

适用于:✅Microsoft Fabric✅Azure 数据资源管理器

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

注意

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

权限

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

语法

.show table TableName data statistics [ 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 不包括共享文本索引大小。 可通过两种方式计算总表数据大小:

  • 对所有 ExtentSize 值求和并添加 SharedIndexSize 值。
  • 运行 .show table details 命令,并使用 TotalExtentSize 值。

示例

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

输出

ColumnName ColumnType ColumnId OriginalSize ExtentSize CompressionRatio DataCompressedSize SharedIndexSize IndexSize IndexSizePercent StorageEngineVersion PresentRowCount DeletedRowCount SamplePercent IncludeColdData
名称 字符串 45c15cfe-ef38-4153-97e7-c18d21651fc2 60907 137305 0.44 137305 27787 0 0 V3 2500 0 80 True
使用情况 real c0aa6668-0f73-46a1-874e-f1b19123eb61 20000 20282 0.99 20102 27787 180 0.9 V3 2500 0 80 True
ID long eb01bab7-da60-4515-a5d4-4780a827bd85 20000 5722 3.49 5152 27787 570 2.85 V3 2500 0 80 True