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

.show databases 命令

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

返回一个表，其中每个记录对应于用户有权访问的事件库中的数据库。

有关显示上下文数据库属性的表，请参阅 .show database。

权限

你必须至少具有 AllDatabasesMonitor 权限才能运行此命令。

语法

.showdatabases [detailspolicies | datastatsidentity | | ]

.show databases (DatabaseName [, ... ])

详细了解语法约定。

返回

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

databases 选项的输出

列名称	列类型	说明
DatabaseName	string	数据库的名称。
PersistentStorage	string	在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本	string	数据库的版本号。
IsCurrent	bool	如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode	string	数据库的附加方式。 例如，如果数据库以只读模式附加，则所有以任何方式修改数据库的请求都会失败。 选项包括 ReadWrite、ReadOnly、ReadOnlyFollowing 或 ReadWriteEphemeral。
PrettyName	string	数据库的易记名称（如果有）。
数据库 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	数据库挂起的时间和原因。

identity 选项的输出

输出参数	类型	说明
DatabaseName	string	数据库的名称。 数据库名称区分大小写。
PersistentStorage	string	在其中存储数据库的持久存储 URI。 （对于临时数据库，此字段为空。）
版本	string	数据库的版本号。 此数字针对数据库中的每个更改操作（例如，添加数据和更改架构）进行更新。
IsCurrent	bool	如果数据库是当前连接所指向的数据库，则为 True。
DatabaseAccessMode	string	数据库的附加方式。 例如，如果数据库以只读模式附加，则所有以任何方式修改数据库的请求都会失败。 选项包括 ReadWrite、ReadOnly、ReadOnlyFollowing 或 ReadWriteEphemeral。
PrettyName	string	数据库友好名称。
CurrentUserIsUnrestrictedViewer	bool	指定当前用户是否是数据库的不受限制的观看者。
数据库 ID	guid	数据库的唯一 ID。
InTransitionTo	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 分钟，因为它们取自数据库的盘区的缓存摘要。

示例

以下示例显示用户可以在 eventhouse 中访问的数据库。

.show databases

输出

DatabaseName	PersistentStorage	版本	IsCurrent	DatabaseAccessMode	PrettyName	数据库 ID	InTransitionTo	SuspensionState
h1i2j3-1234-k4l5m7-8901234abc	https://storagelocation/abcdefg1234567	v29.0	是	ReadWrite	city-temp-data-1	a1b2c3-1234-d4e5f7-8901234abc
s1r2q3-1234-t4e5f7-8901234abc	https://storagelocation01/bcdefg2345678	v21.0	false	ReadWrite	city-data-2	X1y2z3-1234-d4e5f7-8901234abc

显示数据库标识

以下示例显示了连接到当前事件屋的数据库的标识。

.show databases identity

输出

DatabaseName	PersistentStorage	版本	IsCurrent	DatabaseAccessMode	PrettyName	CurrentUserIsUnrestrictedViewer	数据库 ID	InTransitionTo
h1i2j3-1234-k4l5m7-8901234abc	ttps://storagelocation/abcdefg1234567	v33.0	是	ReadWrite	city-temp-data-1	false	a1b2c3-1234-d4e5f7-8901234abc
s1r2q3-1234-t4e5f7-8901234abc	https://storagelocation01/bcdefg2345678	v25.0	false	ReadWrite	city-temp-data-2	false	a1b2c3-1234-d4e5f7-8901234abc

显示数据库数据统计信息

以下示例显示了连接到当前事件库的数据库的数据统计信息。

.show databases datastats

输出

DatabaseName	PersistentStorage	版本	IsCurrent	DatabaseAccessMode	PrettyName	数据库 ID	OriginalSize	ExtentSize	CompressedSize	IndexSize	RowCount	HotOriginalSize	HotExtentSize	HotCompressedSize	HotIndexSize	HotRowCount	TotalExtents	HotExtents
h1i2j3-1234-k4l5m7-8901234abc	https://storagelocation/abcdefg1234567	v33.0	是	ReadWrite	city-temp-data-1	a1b2c3-1234-d4e5f7-8901234abc	0	0	0	0	0	0	0	0	0	0	0	0
s1r2q3-1234-t4e5f7-8901234abc	https://storagelocation01/bcdefg2345678	v25.0	false	ReadWrite	city-temp-data-2	a1b2c3-1234-d4e5f7-8901234abc	239,026,900	18,422,618	15,104,815	3,317,803	618,794	239,026,900	18,422,618	15,104,815	3,317,803	618,794	1	1