.show extents
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:
- Mostrar algumas ou todas as extensões para um âmbito de tabela específico
- Mostrar algumas ou todas as extensões de um âmbito de base de dados específico
- Mostrar algumas ou todas as extensões para todo o cluster
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.
.show
table
TableNameextents
[(
ExtentId [,
...])
] [hot
] [where
tags
(has
!has
!contains
contains
|||) TagName [and
tags
(has
|contains
||!contains
!has
) TagName [,
...]]]
.show
tables
(
TableName [,
...])
extents
[(
ExtentId [,
...])
] [hot
] [where
tags
(has
!has
!contains
contains
|||) TagName [and
tags
(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 == '...'
eTableName == '...'
). - 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".
- Este método é mais rápido do que filtrar (adicionar
- 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
.show
database
DatabaseNameextents
[(
ExtentId [,
...])
] [hot
] [where
tags
(has
!has
!contains
contains
|||) TagName [and
tags
(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
.show
cluster
extents
[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 .ccc
BBB
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 comaa
:.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'
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários