.show databases 命令

適用於： ✅Microsoft網狀架構✅Azure 數據總管

傳回數據表，其中每個記錄都會對應至使用者可存取之 eventhouse 中的資料庫。

如您顯示內容資料庫屬性的資料表，請參閱 .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	資料庫的完整名稱，如果有的話。
DatabaseId	guid	資料庫唯一標識碼。
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	資料庫範圍大小總計，以位元組為單位。
DatabaseId	guid	資料庫唯一標識碼。
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	指定目前使用者是否為資料庫上不受限制的查看器。
DatabaseId	guid	資料庫唯一標識碼。
InTransitionTo	string	描述處於轉換狀態的資料庫。 例如，存取模式變更、卸離資料庫、變更資料庫實體位置、記憶體密鑰變更或資料庫相當名稱變更。

選項的 policies 輸出

輸出參數	類型	描述
DatabaseName	string	資料庫的名稱。 資料庫名稱會區分大小寫。
PersistentStorage	string	資料庫儲存所在的永續性記憶體 URI。 （暫時資料庫的欄位是空的。
版本	string	資料庫版本號碼。 資料庫中的每個變更作業都會更新此數目（例如新增數據和變更架構）。
IsCurrent	bool	如果資料庫是目前連接所指向的資料庫，則為 True。
DatabaseAccessMode	string	如何附加資料庫。 例如，如果資料庫以 ReadOnly 模式附加，則以任何方式修改資料庫的所有要求都會失敗。 選項包括 ReadWrite、 ReadOnly、 ReadOnlyFollowing或 ReadWriteEphemeral。
PrettyName	string	資料庫相當名稱，如果有的話。
DatabaseId	guid	資料庫唯一標識碼。
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	資料庫相當名稱，如果有的話。
DatabaseId	guid	資料庫唯一標識碼。
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	DatabaseId	InTransitionTo	SuspensionState
h1i2j3-1234-k4l5m7-8901234abc	https://storagelocation/abcdefg1234567	v29.0	true	讀寫	city-temp-data-1	a1b2c3-1234-d4e5f7-8901234abc
s1r2q3-1234-t4e5f7-8901234abc	https://storagelocation01/bcdefg2345678	v21.0	false	讀寫	city-data-2	X1y2z3-1234-d4e5f7-8901234abc

顯示資料庫身分識別

下列範例顯示連線至目前 eventhouse 之資料庫的身分識別。

.show databases identity

輸出

DatabaseName	PersistentStorage	版本	IsCurrent	DatabaseAccessMode	PrettyName	CurrentUserIsUnrestrictedViewer	DatabaseId	InTransitionTo
h1i2j3-1234-k4l5m7-8901234abc	ttps://storagelocation/abcdefg1234567	v33.0	true	讀寫	city-temp-data-1	false	a1b2c3-1234-d4e5f7-8901234abc
s1r2q3-1234-t4e5f7-8901234abc	https://storagelocation01/bcdefg2345678	v25.0	false	讀寫	city-temp-data-2	false	a1b2c3-1234-d4e5f7-8901234abc

顯示資料庫數據統計數據

下列範例顯示連接到目前 eventhouse 之資料庫的數據統計數據。

.show databases datastats

輸出

DatabaseName	PersistentStorage	版本	IsCurrent	DatabaseAccessMode	PrettyName	DatabaseId	OriginalSize	ExtentSize	CompressedSize	IndexSize	RowCount	HotOriginalSize	HotExtentSize	HotCompressedSize	HotIndexSize	HotRowCount	TotalExtents	HotExtents
h1i2j3-1234-k4l5m7-8901234abc	https://storagelocation/abcdefg1234567	v33.0	true	讀寫	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	讀寫	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