Comando .show database
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer
Devuelve una tabla que muestra las propiedades de la base de datos de contexto.
Para devolver una tabla en la que cada registro corresponde a una base de datos del clúster al que el usuario tiene acceso, consulte .show databases.
Para devolver una tabla en la que cada registro corresponde a una base de datos del centro de eventos al que el usuario tiene acceso, consulte .show databases.
Permisos
Debe tener al menos permisos de Usuario de base de datos, Visor de bases de datos o Monitor de base de datos para ejecutar este comando. Para más información, vea Control de acceso basado en roles.
Sintaxis
.showdatabase [detailspolicies | datastatsidentity | | ]
La llamada predeterminada sin opciones especificadas es igual a la opción "identity".
Obtenga más información sobre las convenciones de sintaxis.
Devoluciones
Este comando devuelve una tabla con las columnas siguientes para cada opción:
Salida de la identity opción
| Parámetro de salida | Tipo | Descripción |
|---|---|---|
| DatabaseName | string |
Nombre de la base de datos. Los nombres de base de datos distinguen mayúsculas de minúsculas. |
| Almacenamiento persistente | string |
Identificador URI de almacenamiento persistente en el que se almacena la base de datos. (Este campo está vacío para las bases de datos efímeras). |
| Versión | string |
Número de versión de la base de datos. Este número se actualiza para cada operación de cambio de la base de datos (como agregar datos y cambiar el esquema). |
| IsCurrent | bool |
True si la base de datos es la que apunta la conexión actual. |
| DatabaseAccessMode | string |
Modo de acceso a la base de datos. Por ejemplo, si el modo de acceso a la base de datos es ReadOnly, se producirá un error en todas las solicitudes para modificar la base de datos. |
| PrettyName | string |
Nombre bonito de la base de datos. |
| CurrentUserIsUnrestrictedViewer | bool |
Especifica si el usuario actual es un visor sin restricciones en la base de datos. |
| DatabaseId | guid |
Identificador único de la base de datos. |
| InTransitionTo | string |
Describe la base de datos en un estado de transición. Por ejemplo, el cambio del modo de acceso, la desasociación de la base de datos, el cambio de ubicación física de la base de datos, el cambio de claves de almacenamiento o el cambio de nombre de la base de datos. |
| SuspensionState | string |
Cuando se suspendió la base de datos y el motivo de la suspensión. |
Salida de la details opción
| Parámetro de salida | Tipo | Descripción |
|---|---|---|
| DatabaseName | string |
El nombre de la base de datos. Los nombres de base de datos distinguen mayúsculas de minúsculas. |
| Almacenamiento persistente | string |
Identificador URI de almacenamiento persistente en el que se almacena la base de datos. (Este campo está vacío para las bases de datos efímeras). |
| Versión | string |
Número de versión de la base de datos. Este número se actualiza para cada operación de cambio de la base de datos (como agregar datos y cambiar el esquema). |
| IsCurrent | bool |
True si la base de datos es la que apunta la conexión actual. |
| DatabaseAccessMode | string |
Cómo se adjunta la base de datos. Por ejemplo, si la base de datos está asociada en modo ReadOnly, todas las solicitudes para modificar la base de datos de cualquier manera producirán un error. Las opciones incluyen ReadWrite, ReadOnly, ReadOnlyFollowingo ReadWriteEphemeral. |
| PrettyName | string |
Nombre bonito de la base de datos, si existe. |
| AuthorizedPrincipals | string |
Colección de entidades de seguridad autorizadas para la base de datos, serializada en formato JSON. |
| RetentionPolicy | string |
Directiva de retención de base de datos, serializada en formato JSON. |
| MergePolicy | string |
Directiva de combinación de extensiones de base de datos, serializada en formato JSON. |
| CachingPolicy | string |
La directiva de almacenamiento en caché de la base de datos, serializada en formato JSON. |
| ShardingPolicy | string |
Directiva de particionamiento de base de datos, serializada en formato JSON. |
| StreamingIngestionPolicy | string |
La directiva de ingesta de streaming de base de datos, serializada en formato JSON. |
| IngestionBatchingPolicy | string |
Directiva de procesamiento por lotes de ingesta de base de datos, serializada en formato JSON. |
| TotalSize | real |
Tamaño total de la base de datos en bytes. |
| DatabaseId | guid |
Identificador único de la base de datos. |
| InTransitionTo | string |
Describe la base de datos en un estado de transición. Por ejemplo, el cambio del modo de acceso, la desasociación de la base de datos, el cambio de ubicación física de la base de datos, el cambio de claves de almacenamiento o el cambio de nombre de la base de datos. |
| NumberOfTables | int |
Número de tablas de la base de datos. |
| NumberOfExternalTables | int |
Número de tablas externas. |
| NumberOfMaterializedViews | int |
Número de vistas materializadas. |
| EncryptionScope | int |
Ámbito de cifrado. |
| SuspensionState | string |
Cuando se suspendió la base de datos y el motivo. |
Salida de la policies opción
| Parámetro de salida | Tipo | Descripción |
|---|---|---|
| DatabaseName | string |
El nombre de la base de datos. Los nombres de base de datos distinguen mayúsculas de minúsculas. |
| Almacenamiento persistente | string |
Identificador URI de almacenamiento persistente en el que se almacena la base de datos. (Este campo está vacío para las bases de datos efímeras). |
| Versión | string |
Número de versión de la base de datos. Este número se actualiza para cada operación de cambio de la base de datos (como agregar datos y cambiar el esquema). |
| IsCurrent | bool |
True si la base de datos es la que apunta la conexión actual. |
| DatabaseAccessMode | string |
Cómo se adjunta la base de datos. Por ejemplo, si la base de datos está adjunta en modo ReadOnly, todas las solicitudes para modificar la base de datos de cualquier manera producirán un error. Las opciones incluyen ReadWrite, ReadOnly, ReadOnlyFollowingo ReadWriteEphemeral. |
| PrettyName | string |
Nombre bonito de la base de datos, si existe. |
| DatabaseId | guid |
Identificador único de la base de datos. |
| AuthorizedPrincipals | string |
Colección de entidades de seguridad autorizadas para la base de datos, serializada en formato JSON. |
| RetentionPolicy | string |
Directiva de retención de base de datos, serializada en formato JSON. |
| MergePolicy | string |
Directiva de combinación de extensiones de base de datos, serializada en formato JSON. |
| CachingPolicy | string |
La directiva de almacenamiento en caché de la base de datos, serializada en formato JSON. |
| ShardingPolicy | string |
Directiva de particionamiento de base de datos, serializada en formato JSON. |
| StreamingIngestionPolicy | string |
La directiva de ingesta de streaming de base de datos, serializada en formato JSON. |
| IngestionBatchingPolicy | string |
Directiva de procesamiento por lotes de ingesta de base de datos, serializada en formato JSON. |
Salida de la datastats opción
| Parámetro de salida | Tipo | Descripción |
|---|---|---|
| DatabaseName | string |
El nombre de la base de datos. Los nombres de base de datos distinguen mayúsculas de minúsculas. |
| Almacenamiento persistente | string |
Identificador URI de almacenamiento persistente en el que se almacena la base de datos. (Este campo está vacío para las bases de datos efímeras). |
| Versión | string |
Número de versión de la base de datos. Este número se actualiza para cada operación de cambio de la base de datos (como agregar datos y cambiar el esquema). |
| IsCurrent | bool |
True si la base de datos es la que apunta la conexión actual. |
| DatabaseAccessMode | string |
Cómo se adjunta la base de datos. Por ejemplo, si la base de datos está adjunta en modo ReadOnly, todas las solicitudes para modificar la base de datos de cualquier manera producirán un error. Las opciones incluyen ReadWrite, ReadOnly, ReadOnlyFollowingo ReadWriteEphemeral. |
| PrettyName | string |
Nombre bonito de la base de datos, si existe. |
| DatabaseId | guid |
Identificador único de la base de datos. |
| OriginalSize | real |
Tamaño original* total de las extensiones de la base de datos. |
| ExtentSize | real |
Tamaño total de las extensiones de la base de datos (datos + índices).* |
| CompressedSize | real |
La base de datos amplía el tamaño* total de los datos comprimidos. |
| IndexSize | real |
El tamaño* total del índice de extensiones de la base de datos. |
| RowCount | long |
El recuento* total de filas de extensiones de la base de datos. |
| HotOriginalSize | real |
El tamaño* original total de las extensiones activas de la base de datos. |
| HotExtentSize | real |
El tamaño total de las extensiones activas de la base de datos (datos + índices)* . |
| HotCompressedSize | real |
La base de datos amplía el tamaño* total de los datos comprimidos. |
| HotIndexSize | real |
El tamaño* total del índice de extensiones activas de la base de datos. |
| HotRowCount | long |
El recuento* total de filas de extensiones activas de la base de datos. |
| TotalExtents | long |
Extensiones* totales de la base de datos. |
| HotExtents | long |
Extensiones* activas totales de la base de datos. |
*Los valores pueden tener hasta 15 minutos de antigüedad, ya que se toman de un resumen almacenado en caché de las extensiones de la base de datos.
Ejemplos
Mostrar identidad de base de datos
En el ejemplo siguiente se muestran las propiedades relacionadas con la identidad de base de datos actual.
.show database identity
Salida
| DatabaseName | Almacenamiento persistente | Versión | IsCurrent | DatabaseAccessMode | PrettyName | CurrentUserIsUnrestrictedViewer | DatabaseId | InTransitionTo |
|---|---|---|---|---|---|---|---|---|
| SampleLogs | https://storagelocation01/abcdefg1234567 | v252.0 | true | ReadWrite | false | a1b2c3-1234-d4e5f7-8901234abc |
Mostrar directivas de base de datos
En el ejemplo siguiente se muestran las directivas de base de datos actuales.
.show database policies
| DatabaseName | Almacenamiento persistente | Versión | 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", ""Viewer" PrincipalName": "nop1234-1234-56qr-7890","PrincipalType": "AadApplication"}, {"Role": "Ingestor", "PrincipalName": " nop1234-1234-56qr-7890", "PrincipalType": "AadApplication"}] | nulo | { "RowCountUpperBoundForMerge": 160000000, "OriginalSizeMBUpperBoundForMerge": 30000, "MaxExtentsToMerge": 100, "MaxRangeInHours": 24, "AllowRebuild": true, "AllowMerge": true, "Lookback": { "Kind": 0,"CustomPeriod": null }, "Origin": 2 } | nulo | {"MaxRowCount": 750000, "MaxExtentSizeInMb": 1024, "MaxOriginalSizeInMb": 2048, "UseShardEngine": true, "ShardEngineMaxRowCount": 1048576, "ShardEngineMaxExtentSizeInMb": 8192, "ShardEngineMaxOriginalSizeInMb": 3072} | null | nulo |