sp_helpdb (Transact-SQL)
Aplica-se: 
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 = ] N'dbname' ]
[ ; ]
Argumentos
@dbname [ = ] N'dbname'
O nome do banco de dados para o qual as informações são relatadas. @dbname é sysname, com um padrão de NULL. Se @dbname não for especificado, sp_helpdb relatará todos os bancos de dados na exibição do sys.databases catálogo.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto 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 com valor booleano serão listadas somente se estiverem habilitadas. As opções não booleanas são listadas com seus valores correspondentes na forma de <option_name>=<value>.Para saber mais, confira ALTERAR BANCO DE DADOS. |
compatibility_level |
tinyint | Nível de compatibilidade do banco de dados: 90, 100, 110, 120, 130, 140, 150 ou 160. |
Se @dbname for especificado, um conjunto de resultados extra mostrará a alocação de arquivos 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 |
Número(260) | Nome do arquivo do -sistema operacional (nome do arquivo físico). |
filegroup |
nvarchar(128) | Grupo de arquivos ao qual o arquivo pertence.NULL = file é um arquivo de log. Os arquivos de log nunca fazem 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 de UNLIMITED neste campo indica que o arquivo cresce até que o disco esteja cheio. |
growth |
nvarchar(18) | Incremento de crescimento do arquivo. Esse valor indica a quantidade de espaço adicionada ao arquivo sempre que um novo espaço é 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 status coluna no conjunto de resultados informa quais opções são definidas ON no banco de dados. Nem todas as opções de banco de dados são relatadas status pela coluna. Para ver uma lista completa das configurações atuais da opção de banco de dados, use a exibição de sys.databases catálogo.
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 master associação à função pública no banco de dados é 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 possível sobre o banco de dados.
Exemplos
R. Retornar 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. Retornar 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 o SQL Server.
EXEC sp_helpdb;
GO