.show extents

  • Artigo

Nota

As partições horizontais de dados são denominadas extensões e todos os comandos utilizam "extensão" ou "extensões" como sinónimo. Para obter mais informações sobre extensões, veja Descrição Geral de Extensões (Fragmentos de Dados).

Os tipos de .show extents comandos são os seguintes:

Nota

O .show extents comando pode consumir muitos recursos se for executado num âmbito (como uma base de dados ou um cluster) com muitas extensões. Recomendamos a utilização da variante de comando no âmbito mais baixo possível. O âmbito da tabela é preferível em vez do âmbito da base de dados e do âmbito da base de dados sobre o âmbito do cluster. A variante de comandos que inclui extensões de filtragem é preferível a filtrar os resultados do comando com outra consulta.

Permissões

Para ver extensões no cluster, tem de ter permissões AllDatabasesMonitor.

Para ver extensões numa base de dados, tem de ter permissões de Utilizador da Base de Dados, Visualizador de Bases de Dados ou Monitor de Base de Dados.

Para obter mais informações, veja Controlo de acesso baseado em funções.

Âmbito da tabela

Syntax

Mostra informações sobre extensões (partições horizontais de dados) que estão presentes nas tabelas especificadas. A base de dados é retirada do contexto do comando. Se hot for especificado, mostra apenas as extensões que se espera que estejam na cache frequente.

.showtableTableNameextents [(ExtentId [, ...])] [hot] [wheretags (has!has!containscontains|||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

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

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
TableName string ✔️ O nome da tabela.
ExtentId string O ID da extensão a mostrar.
Tag string O nome de uma etiqueta a filtrar, conforme especificado.

Recomendações

  • A utilização de capacidades de filtragem incorporadas no comando é preferível à adição de um filtro baseado em consultas (como adicionar | where DatabaseName == '...' e TableName == '...').
  • Se for fornecida a lista opcional de IDs de extensão, o conjunto de dados devolvido é limitado apenas a essas extensões.
    • Este método é mais rápido do que filtrar (adicionar | where ExtentId in(...)) aos resultados dos comandos "bare".
  • Se tags forem especificados filtros:
    • A lista devolvida está limitada às extensões cuja coleção de etiquetas obedece a todos os filtros de etiquetas fornecidos.
    • Este método é mais rápido do que filtrar (adicionar | where Tags has '...' and Tags contains '...' a) os resultados de comandos "bare".
    • has os filtros são filtros de igualdade. As extensões que não estão etiquetadas com nenhuma das etiquetas especificadas são filtradas.
    • !has os filtros são filtros negativos de igualdade. As extensões etiquetadas com qualquer uma das etiquetas especificadas são filtradas.
    • contains os filtros são filtros de subcadeia não sensíveis a maiúsculas e minúsculas. As extensões que não têm as cadeias especificadas como subcadeia de qualquer uma das respetivas etiquetas são filtradas.
    • !contains os filtros são filtros negativos de subcadeia não sensíveis a maiúsculas e minúsculas. As extensões que têm as cadeias especificadas como subcadeia de qualquer uma das respetivas etiquetas são filtradas.

Âmbito da base de dados

Mostra informações sobre extensões (partições horizontais de dados) que estão presentes na base de dados especificada. Se hot for especificado , mostra apenas as extensões que se espera que estejam na cache frequente.

Syntax

.showdatabaseDatabaseNameextents [(ExtentId [, ...])] [hot] [wheretags (has!has!containscontains|||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
DatabaseName string ✔️ O nome da base de dados.
ExtentId string O ID da extensão a mostrar.
Tag string O nome de uma etiqueta a filtrar, conforme especificado.

Âmbito do cluster

Syntax

.showclusterextents [hot]

Saiba mais sobre as convenções de sintaxe.

Mostra informações sobre extensões (partições horizontais de dados) que estão presentes no cluster. Se hot for especificado , mostra apenas as extensões que se espera que estejam na cache frequente.

Devoluções

Parâmetro de saída Tipo Description
ExtentId guid ID da extensão
DatabaseName string Base de dados à qual a extensão pertence
TableName string Tabela à qual as extensões pertencem
MaxCreatedOn datetime Data-hora em que a extensão foi criada. Para uma extensão intercalada, o máximo de tempos de criação entre extensões de origem
OriginalSize Double (Duplo) Tamanho original em bytes dos dados de extensão
Extensão Double (Duplo) Tamanho da extensão na memória (comprimido + índice)
Comprimir Double (Duplo) Tamanho comprimido dos dados de extensão na memória
Indexar Double (Duplo) Tamanho do índice dos dados de extensão
Blocos long Número de blocos de dados na extensão
Segmentos long Número de segmentos de dados na extensão
ExtentContainerId string ID do contentor de extensão em que a extensão se encontra
Contagem de Linhas long Número de linhas na extensão
MinCreatedOn datetime Data/hora em que a extensão foi criada. Para uma extensão intercalada, o mínimo de tempos de criação entre as extensões de origem
Etiquetas string Etiquetas, se existirem, definidas para a extensão
Tipo string O tipo de motor de armazenamento que criou a extensão
DeletedRowCount long Número de linhas eliminadas na extensão

Exemplos

Extensão com etiquetas

A extensão E na tabela T é marcada com etiquetas aaa, e .cccBBB

  • Esta consulta devolve E:

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

  • Esta consulta não é devolvida E , uma vez que não está etiquetada com aa:

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

  • Esta consulta devolve E:

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

Mostrar o volume de extensões criadas

Mostrar o volume de extensões que estão a ser criadas por hora numa base de dados específica

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

Mostrar o volume de dados que chegam por tabela por hora

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

Mostrar distribuição do tamanho dos dados por tabela

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

Mostrar todas as extensões na base de dados denominada "GamesDB"

.show database GamesDB extents

Mostrar todas as extensões na tabela denominada "Jogos"

.show table Games extents

Mostrar todas as extensões em tabelas específicas

Mostrar todas as extensões nas tabelas denominadas "TaggingGames1" e "TaggingGames2", etiquetadas com "tag1" e "tag2"

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