.显示外部表详情

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

返回指定外部表或数据库中所有外部表的查询加速详细信息。

此命令与任何类型的任何外部表相关。 有关外部表的概述,请参阅 外部表

Permissions

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

Syntax

.show external tables details

.show external table TableNamedetails

详细了解 语法约定

Parameters

Name 类型 Required Description
TableName string ✔️ 要显示的外部表的名称。

Returns

输出参数 类型 Description
TableName string 外部表的名称
QueryAccelerationPolicy string 在表上设置的 查询加速策略 的 JSON 序列化。
QueryAccelerationState string 查询加速状态参数的 JSON 序列化。

查询加速策略

Column 类型 Description
IsEnabled bool 指示外部表是否启用了查询加速策略。
Hot timespan 查询加速策略中定义的热时段。
MaxAge timespan 自上次索引刷新时间起的最大时间跨度,使外部表能够在加速模式下运行。
HotWindows datetime 一个或多个可选时间窗口。 加速在这些时间时段内创建的增量数据文件。
ManagedIdentity string 查询加速策略中定义的托管标识。
HotDateTimeColumn string 查询加速策略中定义的热日期/时间列。

查询加速状态

Column 类型 Description
HotSize long 由于查询加速策略,项目磁盘上的总大小(以字节为单位)加速。
CompletePercentage double 加速的项目百分比,超过能够加速的总项目数。
PendingDataFilesSize long 挂起加速的项目的总大小。
PendingDataFilesCount int 挂起加速的项目数。
IsHealthy string 指示运行状况是否正常。
NotHealthyReason string 描述查询加速不正常的原因。 如果正常,则为空。
LastUpdatedDateTime datetime 成功刷新表的内部表示形式的最后一个日期/时间。
Latency timespan 自上次新数据添加到逻辑副本以来的时间(以分钟为单位)。

Example

.show external table deltatable details

Output

TableName QueryAccelerationPolicy QueryAccelerationState
deltatable {“IsEnabled”: true, “Hot”: “365000.00:00”, “MaxAge”: “5m”, “HotWindows”:[{“MinValue”:“2025-07-04”,“MaxValue”:“2025-07-06”}]} { “HotSize”: 29454192, “CompletionPercentage”: 75.0, “PendingArtifactSize”: 21162035, “PendingArtifactCount”: 3, “IsHealthy”: false, “NotHealthyReason”: “InaccessibleDeltaTable: Delta table not exist”, “LastUpdatedDateTime”: “2025-04-03 13:38:00.1541537”, “Latency”: “26.00:58:12.8941033”}