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

.show databases 命令

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

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

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

权限

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

语法

.showdatabases [detailspolicies | datastatsidentity | | ]

.showdatabases (DatabaseName [, ... ])

详细了解语法约定。

返回

此命令返回一个表，其中包含每个选项的下列列：

选项的 databases 输出

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