sp_helpdb (Transact-SQL)

Relata informações sobre um banco de dados especificado ou todos os bancos de dados.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_helpdb [ [ @dbname= ] 'name' ]

Argumentos

  • [ @dbname= ] 'name'
    É o nome do banco de dados para o qual as informações são relatadas. name é sysname, sem padrão. Se name não for especificado, sp_helpdb fará um relatório de todos os bancos de dados na exibição de catálogo sys.databases.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna

Tipo de dados

Descrição

name

sysname

Nome do banco de dados.

db_size

nvarchar(13)

Tamanho total do banco de dados.

owner

sysname

Proprietário do banco de dados, como sa.

dbid

smallint

ID do banco de dados.

created

nvarchar(11)

A data em que o banco de dados foi criado.

status

nvarchar(600)

Lista de valores separados por vírgula de opções de banco de dados que estão atualmente definidas no banco de dados.

As opções avaliadas como booleanas serão listadas apenas se estiverem habilitadas. As opções não-booleanas serão listadas com seus valores correspondentes no formato option_name=value.

Para obter mais informações, consulte ALTER DATABASE (Transact-SQL).

compatibility_level

tinyint

Nível de compatibilidade do banco de dados: 60, 65, 70, 80 ou 90.

Se name for especificado, haverá um conjunto de resultados adicional que mostra a alocação de arquivo para o banco de dados especificado.

Nome da coluna

Tipo de dados

Descrição

name

nchar(128)

Nome do arquivo lógico.

fileid

smallint

ID do arquivo.

filename

nchar(260)

Nome do arquivo do -sistema operacional (nome do arquivo físico).

filegroup

nvarchar(128)

Grupo de arquivos ao qual o arquivo pertence.

NULL = ele é um arquivo de log. Ele nunca faz parte de um grupo de arquivos.

size

nvarchar(18)

Tamanho do arquivo em megabytes.

maxsize

nvarchar(18)

Tamanho máximo até o qual o arquivo pode crescer. Um valor UNLIMITED neste campo indica que o arquivo cresce até o disco ficar cheio.

growth

nvarchar(18)

Incremento de crescimento do arquivo. Indica a quantidade de espaço adicionada ao arquivo sempre que um novo espaço for necessário.

usage

varchar(9)

Uso do arquivo Para um arquivo de dados, o valor é 'data only' e, para o arquivo de log, o valor é 'log only'.

Comentários

A coluna status no conjunto de resultados informa quais opções foram definidas como ON no banco de dados. Todas as opções de banco de dados não são relatadas pela coluna status. Para consultar uma lista completa das configurações atuais de opções do banco de dados, use a exibição de catálogo sys.databases.

Permissões

Quando um único banco de dados for especificado, será necessário associação na função pública no banco de dados. Quando nenhum banco de dados for especificado, será necessário associação na função pública no banco de dados mestre.

Se não for possível acessar um banco de dados, sp_helpdb exibirá a mensagem de erro 15622 e o máximo possível de informações sobre o banco de dados.

Exemplos

A. Retornando informações sobre um único banco de dados

O exemplo a seguir exibe informações sobre o banco de dados AdventureWorks.

EXEC sp_helpdb N'AdventureWorks';

B. Retornando informações sobre todos os bancos de dados

O exemplo a seguir exibe informações sobre todos os bancos de dados no servidor que executa o SQL Server.

EXEC sp_helpdb;
GO