.show databases コマンド
すべてのレコードが、ユーザーがアクセスできるクラスター内のデータベースに対応するテーブルを返します。
すべてのレコードが、ユーザーがアクセスできるイベントハウス内のデータベースに対応するテーブルを返します。
コンテキスト データベースのプロパティを示す表については、「.show database
」を参照してください。
アクセス許可
このコマンドを実行するには、少なくとも AllDatabasesMonitor アクセス許可が必要です。
構文
.show
databases
[details
| identity
| policies
| datastats
]
.show
databases
(
DatabaseName [,
... ])
.show
cluster
databases
[details
| identity
| policies
| datastats
]
.show
cluster
databases
(
DatabaseName [,
... ])
databases
コマンドとcluster databases
コマンドは同等です。
構文規則について詳しく知る。
返品
このコマンドは、各オプションに対して次の列を含むテーブルを返します。
databases
オプションの出力
列名 | 列の種類 | 説明 |
---|---|---|
DatabaseName | string |
データベースの名前。 |
永続的ストレージ | string |
データベースが格納されている永続的なストレージ URI。 (エフェメラル データベースの場合、このフィールドは空です。) |
バージョン | string |
データベースのバージョン番号。 |
IsCurrent | bool |
データベースが現在の接続先データベースの場合は True。 |
DatabaseAccessMode | string |
データベースのアタッチ方法。 たとえば、データベースが ReadOnly モードでアタッチされている場合、データベースを変更するすべての要求は失敗します。 オプションには、 ReadWrite 、 ReadOnly 、 ReadOnlyFollowing 、または ReadWriteEphemeral があります。 |
PrettyName | string |
データベースの美しい名前 (存在する場合)。 |
DatabaseId | guid |
データベースの一意の ID。 |
InTransitionTo | string |
遷移状態のデータベースについて説明します。 たとえば、アクセス モードの変更、データベースのデタッチ、データベースの物理的な場所の変更、ストレージ キーの変更、データベースの名前の変更などです。 |
SuspensionState | string |
データベースが中断されたときとその理由。 |
details
オプションの出力
出力パラメーター | 型 | 説明 |
---|---|---|
DatabaseName | string |
データベースの名前。 データベース名は大文字と小文字が区別されます。 |
永続的ストレージ | 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 |
データベースの一意の ID。 |
InTransitionTo | string |
遷移状態のデータベースについて説明します。 たとえば、アクセス モードの変更、データベースのデタッチ、データベースの物理的な場所の変更、ストレージ キーの変更、データベースの名前の変更などです。 |
NumberOfTables | int |
データベース内のテーブルの数。 |
NumberOfExternalTables | int |
外部テーブルの数。 |
NumberOfMaterializedViews | int |
具体化されたビューの数。 |
EncryptionScope | int |
暗号化スコープ。 |
SuspensionState | string |
データベースが中断されたときとその理由。 |
identity
オプションの出力
出力パラメーター | 型 | 説明 |
---|---|---|
DatabaseName | string |
データベースの名前。 データベース名は大文字と小文字が区別されます。 |
永続的ストレージ | string |
データベースが格納されている永続的なストレージ URI。 (エフェメラル データベースの場合、このフィールドは空です。) |
バージョン | string |
データベースのバージョン番号。 この数値は、データベースの変更操作 (データの追加やスキーマの変更など) ごとに更新されます。 |
IsCurrent | bool |
データベースが現在の接続先データベースの場合は True。 |
DatabaseAccessMode | string |
データベースのアタッチ方法。 たとえば、データベースが ReadOnly モードでアタッチされている場合、データベースを変更するすべての要求は失敗します。 オプションには、 ReadWrite 、 ReadOnly 、 ReadOnlyFollowing 、または ReadWriteEphemeral があります。 |
PrettyName | string |
データベースのプリティ名。 |
CurrentUserIsUnrestrictedViewer | bool |
現在のユーザーがデータベースの無制限のビューアーであるかどうかを指定します。 |
DatabaseId | guid |
データベースの一意の ID。 |
InTransitionTo | string |
遷移状態のデータベースについて説明します。 たとえば、アクセス モードの変更、データベースのデタッチ、データベースの物理的な場所の変更、ストレージ キーの変更、データベースの名前の変更などです。 |
policies
オプションの出力
出力パラメーター | 型 | 説明 |
---|---|---|
DatabaseName | string |
データベースの名前。 データベース名は大文字と小文字が区別されます。 |
永続的ストレージ | string |
データベースが格納されている永続的なストレージ URI。 (エフェメラル データベースの場合、このフィールドは空です。) |
バージョン | string |
データベースのバージョン番号。 この数値は、データベースの変更操作 (データの追加やスキーマの変更など) ごとに更新されます。 |
IsCurrent | bool |
データベースが現在の接続先データベースの場合は True。 |
DatabaseAccessMode | string |
データベースのアタッチ方法。 たとえば、データベースが ReadOnly モードでアタッチされている場合、データベースを変更するすべての要求は失敗します。 オプションには、 ReadWrite 、 ReadOnly 、 ReadOnlyFollowing 、または ReadWriteEphemeral があります。 |
PrettyName | string |
データベースの美しい名前 (存在する場合)。 |
DatabaseId | 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 |
データベースの名前。 データベース名は大文字と小文字が区別されます。 |
永続的ストレージ | string |
データベースが格納されている永続的なストレージ URI。 (エフェメラル データベースの場合、このフィールドは空です。) |
バージョン | string |
データベースのバージョン番号。 この数値は、データベースの変更操作 (データの追加やスキーマの変更など) ごとに更新されます。 |
IsCurrent | bool |
データベースが現在の接続先データベースの場合は True。 |
DatabaseAccessMode | string |
データベースのアタッチ方法。 たとえば、データベースが ReadOnly モードでアタッチされている場合、データベースを変更するすべての要求は失敗します。 オプションには、 ReadWrite 、 ReadOnly 、 ReadOnlyFollowing 、または ReadWriteEphemeral があります。 |
PrettyName | string |
データベースの美しい名前 (存在する場合)。 |
DatabaseId | 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 |
データベースのホット エクステントの合計* 。 |
*
Values は、データベース エクステントのキャッシュされた概要から取得されるため、最大 15 分前にすることができます。
例
次の例は、ユーザーがクラスター内でアクセスできるデータベースを示しています。
次の例は、ユーザーが eventhouse でアクセスできるデータベースを示しています。
.show databases
出力
DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | DatabaseId | InTransitionTo | SuspensionState |
---|---|---|---|---|---|---|---|---|
SecurityLogs | https://storagelocation01/abcdefg1234567 | v25.0 | false | ReadWrite | a1b2c3-1234-d4e5f7-8901234abc | |||
サンプル | https://storagelocation/bcdefg2345678 | v3381.0 | true | ReadWrite | z9y8x7-1234-l5m6n7-8901234abc | |||
SampleMetrics | https://storagelocation/cdefgh3456789 | v70179.0 | false | ReadWrite | w1v2u3-1234-d7e6f5-8901234abc | |||
SampleLogs | https://storagelocation01/efghi4567890 | v252.0 | false | ReadWrite | s1r2q3-1234-t4e5f7-8901234abc |
DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | DatabaseId | InTransitionTo | SuspensionState |
---|---|---|---|---|---|---|---|---|
h1i2j3-1234-k4l5m7-8901234abc | https://storagelocation/abcdefg1234567 | v29.0 | true | 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 |
データベース ID を表示する
次の例は、現在のイベントハウスに接続されているデータベースの ID を示しています。
次の例は、現在のクラスターに接続されているデータベースの ID を示しています。
.show databases identity
出力
DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | CurrentUserIsUnrestrictedViewer | DatabaseId | InTransitionTo |
---|---|---|---|---|---|---|---|---|
Trender | https://storagelocation01/abcdefg1234567 | v45.0 | false | ReadWrite | false | a1b2c3-1234-d4e5f7-8901234abc | ||
SampleMetrics | https://storagelocation/cdefgh3456789 | v70179.0 | false | ReadWrite | false | w1v2u3-1234-d7e6f5-8901234abc | ||
SecurityLogs | https://storagelocation/bcdefg2345678 | v25.0 | false | ReadWrite | false | a1b2c3-1234-d4e5f7-8901234abc | ||
SampleLogs | https://storagelocation01/abcdefg1234567 | v252.0 | true | ReadWrite | false | a1b2c3-1234-d4e5f7-8901234abc | ||
サンプル | https://storagelocation/bcdefg2345678 | v3381.2 | true | ReadWrite | false | z9y8x7-1234-l5m6n7-8901234abc | ||
FindMyPartner | https://storagelocation01/zabcdef0123456 | v37.0 | false | ReadWrite | false | z1b2c3-1234-d4e5f7-8901234abc | ||
SampleIoTData | https://storagelocation01/yzabcd0123456 | v145.0 | false | ReadWrite | false | y1b2c3-1234-d4e5f7-8901234abc | ||
ContosoSales | https://storagelocation01/xabcdef0123456 | v241.7 | false | ReadWrite | false | x1b2c3-1234-d4e5f7-8901234abc |
DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | CurrentUserIsUnrestrictedViewer | DatabaseId | InTransitionTo |
---|---|---|---|---|---|---|---|---|
h1i2j3-1234-k4l5m7-8901234abc | ttps://storagelocation/abcdefg1234567 | v33.0 | true | 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 | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | DatabaseId | OriginalSize | ExtentSize | CompressedSize | IndexSize | RowCount | HotOriginalSize | HotExtentSize | HotCompressedSize | HotIndexSize | HotRowCount | TotalExtents | HotExtents |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Trender | https://storagelocation01/abcdefg1234567 | v45.0 | false | ReadWrite | a1b2c3-1234-d4e5f7-8901234abc3 | 3,110,418,064 | 336,847,996 | 289,726,808 | 47,121,188 | 31,104,180 | 3,110,418,064 | 336,847,996 | 289,726,808 | 47,121,188 | 31,104,180 | 33 | 33 | |
SampleMetrics | https://storagelocation/cdefgh3456789 | v70179.0 | false | ReadWrite | w1v2u3-1234-d7e6f5-8901234abc | 475,587,055,800 | 27,214,500,605 | 22,987,534,959 | 4,226,965,646 | 1,124,828,461 | 475,587,055,800 | 27,214,500,605 | 22,987,534,959 | 4,226,965,646 | 1,124,828,461 | 182 | 182 | |
SecurityLogs | https://storagelocation/bcdefg2345678 | v25.0 | false | ReadWrite | a1b2c3-1234-d4e5f7-8901234abc | 6,541,515 | 7,718,171 | 5,774,797 | 1,943,374 | 40,323 | 6,541,515 | 7,718,171 | 5,774,797 | 1,943,374 | 40,323 | 8 | 8 | |
SampleLogs | https://storagelocation01/abcdefg123456721461682248 | v252.0 | false | ReadWrite | a1b2c3-1234-d4e5f7-8901234abc | 334,521,429,815 | 25,464,984,656 | 21,461,682,248 | 4,003,302,408 | 885,206,395 | 334,521,429,815 | 25,464,984,656 | 21,461,682,248 | 4,003,302,408 | 885,206,395 | 104 | 104 | |
サンプル | https://storagelocation/bcdefg2345678 | v3381.2 | true | ReadWrite | z9y8x7-1234-l5m6n7-8901234abc | 579,596,574,125 | 122,154,458,750 | 98,946,037,133 | 23,208,421,617 | 2,236,670,722 | 579,596,574,125 | 122,154,458,750 | 98,946,037,133 | 23,208,421,617 | 2,236,670,722 | 173 | 173 | |
FindMyPartner | https://storagelocation01/zabcdef0123456 | v37.0 | false | ReadWrite | z1b2c3-1234-d4e5f7-8901234abc | 34,259 | 53,075 | 40,698 | 12,377 | 38 | 34,259 | 53,075 | 40,698 | 12,377 | 38 | 1 | 1 | |
SampleIoTData | https://storagelocation01/yzabcd0123456 | v145.0 | false | ReadWrite | y1b2c3-1234-d4e5f7-8901234abc | 163,026,882 | 45,743,179 | 33,419,597 | 12,323,582 | 1,202,160 | 163,026,882 | 45,743,179 | 33,419,597 | 12,323,582 | 1,202,160 | 3 | 3 | |
ContosoSales | https://storagelocation01/xabcdef0123456 | v241.7 | false | ReadWrite | x1b2c3-1234-d4e5f7-8901234abc | 18,506,982,546 | 4,256,663,908 | 3,602,512,666 | 654,151,242 | 12,092,847 | 18,506,982,546 | 4,256,663,908 | 3,602,512,666 | 654,151,242 | 12,092,847 | 10 | 10 |
DatabaseName | 永続的ストレージ | バージョン | 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 | 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 |