Partilhar via


Comando .show database

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Retorna uma tabela mostrando as propriedades do banco de dados de contexto.

Para retornar uma tabela na qual cada registro corresponde a um banco de dados no cluster ao qual o usuário tem acesso, consulte .show databases.

Para retornar uma tabela na qual cada registro corresponde a um banco de dados na casa de eventos ao qual o usuário tem acesso, consulte .show databases.

Permissões

Você deve ter pelo menos as permissões Usuário do Banco de Dados, Visualizador do Banco de Dados ou Monitor do Banco de Dados para executar esse comando. Para obter mais informações, confira Controle de acesso baseado em função.

Sintaxe

.showdatabase [detailspolicies | datastatsidentity | | ]

A chamada padrão sem nenhuma opção especificada é igual à opção 'identity'.

Saiba mais sobre as convenções de sintaxe.

Devoluções

Este comando retorna uma tabela com as seguintes colunas para cada opção:

Saída para identity opção

Parâmetro de saída Tipo Descrição
DatabaseName string Nome do banco de dados. Os nomes de banco de dados diferenciam maiúsculas de minúsculas.
Armazenamentopersistente string O URI de armazenamento persistente no qual o banco de dados está armazenado. (Este campo está vazio para bancos de dados efêmeros.)
Versão string Número de versão de banco de dados. Esse número é atualizado para cada operação de alteração no banco de dados (como adicionar dados e alterar o esquema).
IsCurrent bool True se o banco de dados for aquele para o qual a conexão atual aponta.
Modo de acesso ao banco de dados string O modo de acesso ao banco de dados. Por exemplo, se o modo de acesso ao banco de dados for ReadOnly, todas as solicitações para modificar o banco de dados falharão.
Nome bonito string O nome bonito do banco de dados.
CurrentUserIsUnrestrictedViewer bool Especifica se o usuário atual é um visualizador irrestrito no banco de dados.
DatabaseId guid A ID exclusiva do banco de dados.
Em TransiçãoPara string Descreve o banco de dados em um estado de transição. Por exemplo, alteração do modo de acesso, desanexação do banco de dados, alteração do local físico do banco de dados, alteração das chaves de armazenamento ou alteração do nome bonito do banco de dados.
Estado de suspensão string Quando o banco de dados foi suspenso e o motivo da suspensão.

Saída para details opção

Parâmetro de saída Tipo Descrição
DatabaseName string O nome do banco de dados. Os nomes de banco de dados diferenciam maiúsculas de minúsculas.
Armazenamentopersistente string O URI de armazenamento persistente no qual o banco de dados está armazenado. (Este campo está vazio para bancos de dados efêmeros.)
Versão string Número de versão de banco de dados. Esse número é atualizado para cada operação de alteração no banco de dados (como adicionar dados e alterar o esquema).
IsCurrent bool True se o banco de dados for aquele para o qual a conexão atual aponta.
Modo de acesso ao banco de dados string Como o banco de dados é anexado. Por exemplo, se o banco de dados estiver anexado no modo ReadOnly, todas as solicitações para modificar o banco de dados de qualquer forma falharão. As opções incluem ReadWrite, ReadOnly, ReadOnlyFollowingou ReadWriteEphemeral.
Nome bonito string O nome bonito do banco de dados, se houver.
AuthorizedPrincipals string A coleção de entidades autorizadas para o banco de dados, serializadas no formato JSON.
Política de retenção string A política de retenção do banco de dados, serializada no formato JSON.
Política de mesclagem string A política de mesclagem de extensões do banco de dados, serializada no formato JSON.
CachingPolicy string A política de cache do banco de dados, serializada no formato JSON.
ShardingPolicy string A política de fragmentação do banco de dados, serializada no formato JSON.
Política de Ingestão de Streaming string A política de Ingestão de Streaming do banco de dados, serializada no formato JSON.
IngestionBatchingPolicy string A política de Envio em Lote de Ingestão do banco de dados, serializada no formato JSON.
TotalSize real O banco de dados estende o tamanho total em bytes.
DatabaseId guid A ID exclusiva do banco de dados.
Em TransiçãoPara string Descreve o banco de dados em um estado de transição. Por exemplo, alteração do modo de acesso, desanexação do banco de dados, alteração do local físico do banco de dados, alteração das chaves de armazenamento ou alteração do nome bonito do banco de dados.
Número de Tabelas int O número de tabelas no banco de dados.
Número de tabelas externas int O número de tabelas externas.
NumberOfMaterializedViews int O número de exibições materializadas.
EncryptionScope int O escopo da criptografia.
Estado de suspensão string Quando o banco de dados foi suspenso e o motivo.

Saída para policies opção

Parâmetro de saída Tipo Descrição
DatabaseName string O nome do banco de dados. Os nomes de banco de dados diferenciam maiúsculas de minúsculas.
Armazenamentopersistente string O URI de armazenamento persistente no qual o banco de dados está armazenado. (Este campo está vazio para bancos de dados efêmeros.)
Versão string Número de versão de banco de dados. Esse número é atualizado para cada operação de alteração no banco de dados (como adicionar dados e alterar o esquema).
IsCurrent bool True se o banco de dados for aquele para o qual a conexão atual aponta.
Modo de acesso ao banco de dados string Como o banco de dados é anexado. Por exemplo, se o banco de dados estiver anexado no modo ReadOnly, todas as solicitações para modificar o banco de dados de alguma forma falharão. As opções incluem ReadWrite, ReadOnly, ReadOnlyFollowingou ReadWriteEphemeral.
Nome bonito string O nome bonito do banco de dados, se houver.
DatabaseId guid A ID exclusiva do banco de dados.
AuthorizedPrincipals string A coleção de entidades autorizadas para o banco de dados, serializadas no formato JSON.
Política de retenção string A política de retenção do banco de dados, serializada no formato JSON.
Política de mesclagem string A política de mesclagem de extensões do banco de dados, serializada no formato JSON.
CachingPolicy string A política de cache do banco de dados, serializada no formato JSON.
ShardingPolicy string A política de fragmentação do banco de dados, serializada no formato JSON.
Política de Ingestão de Streaming string A política de Ingestão de Streaming do banco de dados, serializada no formato JSON.
IngestionBatchingPolicy string A política de Envio em Lote de Ingestão do banco de dados, serializada no formato JSON.

Saída para datastats opção

Parâmetro de saída Tipo Descrição
DatabaseName string O nome do banco de dados. Os nomes de banco de dados diferenciam maiúsculas de minúsculas.
Armazenamentopersistente string O URI de armazenamento persistente no qual o banco de dados está armazenado. (Este campo está vazio para bancos de dados efêmeros.)
Versão string Número de versão de banco de dados. Esse número é atualizado para cada operação de alteração no banco de dados (como adicionar dados e alterar o esquema).
IsCurrent bool True se o banco de dados for aquele para o qual a conexão atual aponta.
Modo de acesso ao banco de dados string Como o banco de dados é anexado. Por exemplo, se o banco de dados estiver anexado no modo ReadOnly, todas as solicitações para modificar o banco de dados de alguma forma falharão. As opções incluem ReadWrite, ReadOnly, ReadOnlyFollowingou ReadWriteEphemeral.
Nome bonito string O nome bonito do banco de dados, se houver.
DatabaseId guid A ID exclusiva do banco de dados.
OriginalSize real O banco de dados estende o tamanho* total do original.
ExtentSize real O tamanho total das extensões do banco de dados (dados + índices).*
CompressedSize real O banco de dados estende o tamanho* total dos dados compactados.
IndexSize real O banco de dados estende o tamanho* total do índice.
RowCount long O banco de dados estende a contagem* total de linhas.
HotOriginalSize real O banco de dados hot estende o tamanho* total do original.
HotExtentSize real O banco de dados hot estende o tamanho total (dados + índices).*
Tamanho Compactado a Quente real O banco de dados hot estende o tamanho* total dos dados compactados.
HotIndexSize real O banco de dados hot estende o tamanho* total do índice.
HotRowCount long O banco de dados hot estende a contagem* total de linhas.
TotalExtents long O banco de dados total extensões*.
HotExtents long O banco de dados total de* extensões ativas.

*Os valores podem ter até 15 minutos, pois são obtidos de um resumo armazenado em cache das extensões do banco de dados.

Exemplos

Mostrar identidade do banco de dados

O exemplo a seguir mostra as propriedades relacionadas à identidade do banco de dados atual.

.show database identity

Saída

DatabaseName Armazenamentopersistente Versão IsCurrent Modo de acesso ao banco de dados Nome bonito CurrentUserIsUnrestrictedViewer DatabaseId Em TransiçãoPara
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 true ReadWrite false A1B2C3-1234-D4E5F7-8901234ABC

Mostrar políticas de banco de dados

O exemplo a seguir mostra as políticas de banco de dados atuais.

.show database policies
DatabaseName Armazenamentopersistente Versão IsCurrent Modo de acesso ao banco de dados Nome bonito DatabaseId AuthorizedPrincipals Política de retenção Política de mesclagem CachingPolicy ShardingPolicy Política de Ingestão de Streaming IngestionBatchingPolicy
SampleLogs https://storagelocation01/abcdefg1234567 v252.0 true ReadWrite A1B2C3-1234-D4E5F7-8901234AB [{ "Função": "Admin", "PrincipalName": "1234abcd-ef56-789-0123456e" "PrincipalType": "AadUser"}, { "Função": "Admin", "PrincipalName": "fghi1234-5678-9j12-3456", "PrincipalType": "AadUser"}, { "Função": "Usuário", "PrincipalName": "kl1234-1234-1234-" 56m7-89012", "PrincipalType": "AadApplication"}, { "Função": "Usuário", "PrincipalName": "fghi1234-5678-9j12-3456" "PrincipalType": "AadApplication" }, { "Função": "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"}] nulo { "RowCountUpperBoundForMerge": 16000000, "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} nulo nulo