sp_helpdb (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de 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 o nome não for especificado, sp_helpdb relatórios em todos os bancos de dados na exibição de catálogo sys.databases .

Valores do 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.
proprietário 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 boolianas serão listadas apenas se estiverem habilitadas. As opções não boolianas são listadas com seus valores correspondentes na forma de option_name=valor.

Para obter mais informações, veja ALTER DATABASE (Transact-SQL).
compatibility_level tinyint Nível de compatibilidade do banco de dados: 60, 65, 70, 80 ou 90.

Se o nome 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.
Idarquivo 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.
Uso varchar(9) Uso do arquivo Para um arquivo de dados, o valor é "somente dados" e para o arquivo de log o valor é "somente log".

Comentários

A coluna status no conjunto de resultados relata 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 ver uma lista completa das configurações de opção de banco de dados atuais, use a exibição de catálogo sys.databases .

Permissões

Quando um único banco de dados é especificado, a associação na função pública no banco de dados é necessária. Quando nenhum banco de dados é especificado, a associação à função pública no banco de dados master é necessária.

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

Exemplos

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

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

EXEC sp_helpdb N'AdventureWorks2022';  

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

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

EXEC sp_helpdb;  
GO  

Consulte Também

Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
ALTER DATABASE (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL)
sys.databases (Transact-SQL)
sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)