.show database コマンド
コンテキスト データベースのプロパティを示すテーブルを返します。
すべてのレコードが、ユーザーがアクセスできるクラスター内のデータベースに対応するテーブルを返す場合は、.show databases を参照してください。
すべてのレコードが、ユーザーがアクセスできるイベントハウス内のデータベースに対応するテーブルを返すには、 .show databasesを参照してください。
アクセス許可
このコマンドを実行するには、少なくともデータベース ユーザー、データベース ビューアー、またはデータベース モニターのアクセス許可が必要です。 詳細については、ロールベースのアクセス制御に関するページを参照してください。
構文
.showdatabase [details | identity | policies | datastats]
オプションを指定しない既定の呼び出しは、'identity' オプションと等しくなります。
構文規則について詳しく知る。
返品
このコマンドは、各オプションに対して次の列を含むテーブルを返します。
identity オプションの出力
| 出力パラメーター | 型 | 説明 |
|---|---|---|
| DatabaseName | string |
データベース名。 データベース名は大文字と小文字が区別されます。 |
| 永続的ストレージ | string |
データベースが格納されている永続的なストレージ URI。 (エフェメラル データベースの場合、このフィールドは空です。) |
| バージョン | string |
データベースのバージョン番号。 この数値は、データベースの変更操作 (データの追加やスキーマの変更など) ごとに更新されます。 |
| IsCurrent | bool |
データベースが現在の接続先データベースの場合は True。 |
| DatabaseAccessMode | string |
データベース アクセス モード。 たとえば、データベース アクセス モードが ReadOnlyされている場合、データベースを変更するすべての要求は失敗します。 |
| PrettyName | string |
データベースのプリティ名。 |
| CurrentUserIsUnrestrictedViewer | bool |
現在のユーザーがデータベースの無制限のビューアーであるかどうかを指定します。 |
| 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 |
データベースが中断されたときとその理由。 |
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 分前にすることができます。
例
データベース ID の表示
次の例は、現在のデータベース ID 関連のプロパティを示しています。
.show database identity
出力
| DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | CurrentUserIsUnrestrictedViewer | DatabaseId | InTransitionTo |
|---|---|---|---|---|---|---|---|---|
| SampleLogs | https://storagelocation01/abcdefg1234567 | v252.0 | true | ReadWrite | false | a1b2c3-1234-d4e5f7-8901234abc |
データベース ポリシーを表示する
次の例は、現在のデータベース ポリシーを示しています。
.show database policies
| DatabaseName | 永続的ストレージ | バージョン | IsCurrent | DatabaseAccessMode | PrettyName | DatabaseId | AuthorizedPrincipals | RetentionPolicy | MergePolicy | CachingPolicy | ShardingPolicy | StreamingIngestionPolicy | IngestionBatchingPolicy |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SampleLogs | https://storagelocation01/abcdefg1234567 | v252.0 | true | 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 |