Share via

.show extents

  • Artículo

Nota

Las particiones de datos se denominan extensiones y todos los comandos usan "extent" o "extents" como sinónimo. Para obtener más información sobre las extensiones, consulte Información general sobre extensiones (particiones de datos).

Los tipos de .show extents comandos son los siguientes:

Nota

El .show extents comando puede consumir muchos recursos si se ejecuta en un ámbito (como una base de datos o un clúster) con muchas extensiones. Se recomienda usar la variante de comando en el ámbito más bajo posible. El ámbito de tabla es preferible sobre el ámbito de la base de datos y el ámbito de la base de datos a través del ámbito del clúster. La variante de comando que incluye extensiones de filtrado es preferible a filtrar los resultados del comando mediante otra consulta.

Permisos

Para ver las extensiones del clúster, debe tener permisos AllDatabasesMonitor.

Para ver las extensiones de una base de datos, debe tener permisos usuario de base de datos, Visor de base de datos o Monitor de base de datos.

Para obtener más información, consulte Control de acceso basado en roles.

Ámbito de tabla

Syntax

Muestra información sobre las extensiones (particiones de datos) que están presentes en las tablas especificadas. La base de datos se toma del contexto del comando. Si hot se especifica , muestra solo las extensiones que se espera que estén en la caché activa.

.showtableTablenameextents [(ExtentId [, ...])] [] [hotwheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

.showtables(TableName [, ...])extents [(ExtentId [, ...])] [] [hotwheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido Descripción
TableName string ✔️ Nombre de la tabla.
ExtentId string Identificador de la extensión que se va a mostrar.
Tag string Nombre de una etiqueta que se va a filtrar según se especifique.

Recomendaciones

  • El uso de funcionalidades de filtrado integradas en el comando es preferible a agregar un filtro basado en consultas (como agregar | where DatabaseName == '...' y TableName == '...').
  • Si se proporciona la lista opcional de identificadores de extensión, el conjunto de datos devuelto solo se limita a esas extensiones.
    • Este método es más rápido que filtrar (agregar | where ExtentId in(...)) a los resultados de los comandos "bare".
  • Si tags se especifican filtros:
    • La lista devuelta se limita a esas extensiones cuya colección de etiquetas obedece a todos los filtros de etiquetas proporcionados.
    • Este método es más rápido que filtrar (agregar | where Tags has '...' and Tags contains '...' a) los resultados de los comandos "bare".
    • has los filtros son filtros de igualdad. Las extensiones que no están etiquetadas con ninguna de las etiquetas especificadas se filtran.
    • !has los filtros son filtros negativos de igualdad. Las extensiones etiquetadas con cualquiera de las etiquetas especificadas se filtran.
    • contains los filtros no distinguen mayúsculas de minúsculas. Las extensiones que no tienen las cadenas especificadas como subcadena de cualquiera de sus etiquetas se filtran.
    • !contains los filtros no distinguen entre mayúsculas y minúsculas filtros negativos. Las extensiones que tienen las cadenas especificadas como subcadena de cualquiera de sus etiquetas se filtran.

Ámbito de la base de datos

Muestra información sobre las extensiones (particiones de datos) que están presentes en la base de datos especificada. Si hot se especifica , muestra solo las extensiones que se espera que estén en la caché activa.

Syntax

.showdatabaseDatabasenameextents [(ExtentId [, ...])] [] [hotwheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

Más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Requerido Descripción
DatabaseName string ✔️ El nombre de la base de datos.
ExtentId string Identificador de la extensión que se va a mostrar.
Tag string Nombre de una etiqueta que se va a filtrar según se especifique.

Ámbito del clúster

Syntax

.showclusterextents [hot]

Más información sobre las convenciones de sintaxis.

Muestra información sobre las extensiones (particiones de datos) que están presentes en el clúster. Si hot se especifica , muestra solo las extensiones que se espera que estén en la caché activa.

Devoluciones

Parámetro de salida Tipo Descripción
ExtentId guid Identificador de la extensión
DatabaseName string Base de datos a la que pertenece la extensión
TableName string Tabla a la que pertenecen las extensiones
MaxCreatedOn datetime Fecha y hora en que se creó la extensión. Para una extensión combinada, el máximo de tiempos de creación entre las extensiones de origen
OriginalSize Double Tamaño original en bytes de los datos de extensión
ExtentSize Double Tamaño de la extensión en memoria (comprimido + índice)
CompressedSize Double Tamaño comprimido de los datos de extensión en memoria
IndexSize Double Tamaño del índice de los datos de extensión
Blocks long Número de bloques de datos en la extensión
Segmentos long Número de segmentos de datos en la extensión
ExtentContainerId string Identificador del contenedor de extensión en el que se encuentra la extensión.
RowCount long Número de filas en la extensión
MinCreatedOn datetime Fecha y hora en que se creó la extensión. Para una extensión combinada, el mínimo de tiempos de creación entre las extensiones de origen
Etiquetas string Etiquetas, si las hay, definidas para la extensión
Clase string El tipo del motor de almacenamiento que creó la extensión
DeletedRowCount long Número de filas eliminadas en la extensión

Ejemplos

Extensión etiquetada

La extensión E de la tabla T se etiqueta con etiquetas aaa, BBBy ccc.

  • Esta consulta devuelve E:

      .show table T extents where tags has 'aaa' and tags contains 'bb'

  • Esta consulta no devuelve E porque no está etiquetada con aa:

      .show table T extents where tags has 'aa' and tags contains 'bb'

  • Esta consulta devuelve E:

      .show table T extents where tags contains 'aaa' and tags contains 'bb'

Mostrar el volumen de extensiones creadas

Mostrar el volumen de extensiones que se crean por hora en una base de datos específica

.show database MyDatabase extents | summarize count(ExtentId) by MaxCreatedOn bin=time(1h) | render timechart

Mostrar el volumen de datos que llegan por tabla por hora

.show database MyDatabase extents  
| summarize sum(OriginalSize) by TableName, MaxCreatedOn bin=time(1h)  
| render timechart

Mostrar distribución de tamaño de datos por tabla

.show database MyDatabase extents | summarize sum(OriginalSize) by TableName

Mostrar todas las extensiones de la base de datos denominada "GamesDB"

.show database GamesDB extents

Mostrar todas las extensiones de la tabla denominada "Juegos"

.show table Games extents

Mostrar todas las extensiones en tablas específicas

Mostrar todas las extensiones de las tablas denominadas 'TaggingGames1' y 'TaggingGames2', etiquetadas con 'tag1' y 'tag2'

.show tables (TaggingGames1,TaggingGames2) extents where tags has 'tag1' and tags has 'tag2'