通过

.show database 命令

  • 项目

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

返回一个表，其中显示了上下文数据库的属性。

若要返回一个表，其中每个记录都对应于用户可以访问的群集中的一个数据库，请参阅 .show databases。

权限

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

语法

.show database [details | identity | policies | datastats]

未指定任何选项的默认调用等于“identity”选项。

详细了解语法约定。

返回

此命令将返回一个表格，其中每个选项都包含以下列：

identity 选项的输出

输出参数 类型 说明
DatabaseName string 数据库名称。 数据库名称区分大小写。
PersistentStorage string 在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本 string 数据库的版本号。 此数字针对数据库中的每个更改操作（例如，添加数据和更改架构）进行更新。
IsCurrent bool 如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode string 数据库访问模式。 例如，如果数据库访问模式为 ReadOnly，则所有修改数据库的请求都会失败。
PrettyName string 数据库友好名称。
CurrentUserIsUnrestrictedViewer bool 指定当前用户是否是数据库的不受限制的观看者。
数据库 ID guid 数据库的唯一 ID。
InTransitionTo string 描述处于转换状态的数据库。 例如，访问模式更改、分离数据库、更改数据库物理位置、存储密钥更改或数据库名称更改。
SuspensionState string 数据库挂起的时间和原因。

details 选项的输出

输出参数 类型 说明
DatabaseName string 数据库的名称。 数据库名称区分大小写。
PersistentStorage string 在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本 string 数据库的版本号。 此数字针对数据库中的每个更改操作（例如，添加数据和更改架构）进行更新。
IsCurrent bool 如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode string 数据库的附加方式。 例如，如果数据库以只读模式附加，则所有以任何方式修改数据库的请求都会失败。 选项包括 ReadWrite、ReadOnly、ReadOnlyFollowing 或 ReadWriteEphemeral。
PrettyName string 数据库友好名称（如有）。
AuthorizedPrincipals string 以 JSON 格式序列化的数据库授权主体集合。
RetentionPolicy string 以 JSON 格式序列化的数据库保留策略。
MergePolicy string 以 JSON 格式序列化的数据库“盘区合并”策略。
CachingPolicy string 以 JSON 格式序列化的数据库“缓存”策略。
ShardingPolicy string 以 JSON 格式序列化的数据库“分片”策略。
StreamingIngestionPolicy string 以 JSON 格式序列化的数据库“流式引入”策略。
IngestionBatchingPolicy string 以 JSON 格式序列化的数据库“引入批处理”策略。
TotalSize real 数据库盘区总大小（以字节为单位）。
数据库 ID guid 数据库的唯一 ID。
InTransitionTo string 描述处于转换状态的数据库。 例如，访问模式更改、分离数据库、更改数据库物理位置、存储密钥更改或数据库名称更改。
NumberOfTables int 数据库中的表数量。
NumberOfExternalTables int 外部表的数量。
NumberOfMaterializedViews int 具体化视图的数量。
EncryptionScope int 加密范围。
SuspensionState string 数据库挂起的时间和原因。

policies 选项的输出

输出参数 类型 说明
DatabaseName string 数据库的名称。 数据库名称区分大小写。
PersistentStorage string 在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本 string 数据库的版本号。 此数字针对数据库中的每个更改操作（例如，添加数据和更改架构）进行更新。
IsCurrent bool 如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode string 数据库的附加方式。 例如，如果数据库以只读模式附加，则所有以任何方式修改数据库的请求都会失败。 选项包括 ReadWrite、ReadOnly、ReadOnlyFollowing 或 ReadWriteEphemeral。
PrettyName string 数据库友好名称（如有）。
数据库 ID guid 数据库的唯一 ID。
AuthorizedPrincipals string 以 JSON 格式序列化的数据库授权主体集合。
RetentionPolicy string 以 JSON 格式序列化的数据库保留策略。
MergePolicy string 以 JSON 格式序列化的数据库“盘区合并”策略。
CachingPolicy string 以 JSON 格式序列化的数据库“缓存”策略。
ShardingPolicy string 以 JSON 格式序列化的数据库“分片”策略。
StreamingIngestionPolicy string 以 JSON 格式序列化的数据库“流式引入”策略。
IngestionBatchingPolicy string 以 JSON 格式序列化的数据库“引入批处理”策略。

datastats 选项的输出

输出参数 类型 说明
DatabaseName string 数据库的名称。 数据库名称区分大小写。
PersistentStorage string 在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本 string 数据库的版本号。 此数字针对数据库中的每个更改操作（例如，添加数据和更改架构）进行更新。
IsCurrent bool 如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode string 数据库的附加方式。 例如，如果数据库以只读模式附加，则所有以任何方式修改数据库的请求都会失败。 选项包括 ReadWrite、ReadOnly、ReadOnlyFollowing 或 ReadWriteEphemeral。
PrettyName string 数据库友好名称（如有）。
数据库 ID guid 数据库的唯一 ID。
OriginalSize real 数据库扩展的原始总大小*。
ExtentSize real 数据库盘区总大小（数据 + 索引）*。
CompressedSize real 数据库盘区总数据压缩大小*。
IndexSize real 数据库盘区总索引大小*。
RowCount long 数据库盘区总行计数*。
HotOriginalSize real 数据库热盘区总原始大小*。
HotExtentSize real 数据库热盘区总大小（数据 + 索引）*。
HotCompressedSize real 数据库热盘区总数据压缩大小*。
HotIndexSize real 数据库热盘区总索引大小*。
HotRowCount long 数据库热盘区总行计数*。
TotalExtents long 数据库总盘区数*。
HotExtents long 数据库总热盘区数*。

* 值可能长达 15 分钟，因为它们取自数据库的盘区的缓存摘要。

示例

显示数据库标识

以下示例显示了当前数据库标识相关属性。

.show database identity

输出

DatabaseName PersistentStorage 版本 IsCurrent DatabaseAccessMode PrettyName CurrentUserIsUnrestrictedViewer 数据库 ID InTransitionTo
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 是 ReadWrite false a1b2c3-1234-d4e5f7-8901234abc

显示数据库策略

以下示例显示了当前数据库策略。

.show database policies
DatabaseName PersistentStorage 版本 IsCurrent DatabaseAccessMode PrettyName 数据库 ID AuthorizedPrincipals RetentionPolicy MergePolicy CachingPolicy ShardingPolicy StreamingIngestionPolicy IngestionBatchingPolicy
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 是 ReadWrite a1b2c3-1234-d4e5f7-8901234ab [{ "Role": "Admin", "PrincipalName": "1234abcd-ef56-789-0123456e" "PrincipalType": "AadUser"}, { "Role": "Admin", "PrincipalName": "fghi1234-5678-9j12-3456", "PrincipalType": "AadUser"}, { "Role": "User", "PrincipalName": "kl1234-1234-56m7-89012", "PrincipalType": "AadApplication"}, { "Role": "User", "PrincipalName": "fghi1234-5678-9j12-3456" "PrincipalType": "AadApplication" }, { "Role": "Ingestor", "PrincipalName": "fghi1234-5678-9j12-3456", "PrincipalType": "AadApplication" }, { "Role": "Viewer", "PrincipalName": "#everyone#", "PrincipalType": "AadUser" }, {"Role": "Viewer", "PrincipalName": "#everyone#", "PrincipalType": "MsaUser" }, { "Role": "Admin" "PrincipalName":"nop1234-1234-56qr-7890", "PrincipalType": "AadUser"}, { "Role": "User", "PrincipalName": "nop1234-1234-56qr-7890", "PrincipalType": "AadUser" }, { "Role": "Viewer", "PrincipalName": "nop1234-1234-56qr-7890","PrincipalType": "AadApplication"}, {"Role": "Ingestor", "PrincipalName": "nop1234-1234-56qr-7890", "PrincipalType": "AadApplication"}] Null { "RowCountUpperBoundForMerge": 16000000, "OriginalSizeMBUpperBoundForMerge": 30000, "MaxExtentsToMerge": 100, "MaxRangeInHours": 24, "AllowRebuild": true, "AllowMerge": true, "Lookback": { "Kind": 0,"CustomPeriod": null }, "Origin": 2 } Null {"MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048, "UseShardEngine": true, "ShardEngineMaxRowCount": 1048576, "ShardEngineMaxExtentSizeInMb": 8192, "ShardEngineMaxOriginalSizeInMb": 3072} Null null