适用于:✅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”} |