sp_helpdb (Transact-SQL)sp_helpdb (Transact-SQL)

APLICA-SE A: simSQL Server (a partir do 2008) nãoBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Relata informações sobre um banco de dados especificado ou todos os bancos de dados.Reports information about a specified database or all databases.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax


sp_helpdb [ [ @dbname= ] 'name' ]  

ArgumentosArguments

[ @dbname= ] 'name'[ @dbname= ] 'name'
É o nome do banco de dados cujas informações são reportadas.Is the name of the database for which information is reported. nome da está sysname, sem padrão.name is sysname, with no default. Se nome não for especificado, sp_helpdb relatórios em todos os bancos de dados a sys. Databases exibição do catálogo.If name is not specified, sp_helpdb reports on all databases in the sys.databases catalog view.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Nome da colunaColumn name Tipo de dadosData type DescriptionDescription
namename sysnamesysname Nome do banco de dados.Database name.
tamanho de BDdb_size nvarchar(13)nvarchar(13) Tamanho total do banco de dados.Total size of the database.
Proprietárioowner sysnamesysname Banco de dados proprietário, como sa.Database owner, such as sa.
dbiddbid smallintsmallint ID do banco de dados.Database ID.
createdcreated nvarchar(11)nvarchar(11) A data em que o banco de dados foi criado.Date the database was created.
statusstatus nvarchar(600)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.Comma-separated list of values of database options that are currently set on the database.

As opções avaliadas como boolianas serão listadas apenas se estiverem habilitadas.Boolean-valued options are listed only if they are enabled. Opções não Boolianas são listadas com seus valores correspondentes na forma de option_name=valor.Non-Boolean options are listed with their corresponding values in the form of option_name=value.

Para obter mais informações, veja ALTER DATABASE (Transact-SQL).For more information, see ALTER DATABASE (Transact-SQL).
compatibility_levelcompatibility_level tinyinttinyint Nível de compatibilidade do banco de dados: 60, 65, 70, 80 ou 90.Database compatibility level: 60, 65, 70, 80, or 90.

Se nome for especificado, há um conjunto de resultados adicionais que mostra a alocação de arquivo para o banco de dados especificado.If name is specified, there is an additional result set that shows the file allocation for the specified database.

Nome da colunaColumn name Tipo de dadosData type DescriptionDescription
namename nchar(128)nchar(128) Nome do arquivo lógico.Logical file name.
fileidfileid smallintsmallint ID do arquivo.File ID.
filenamefilename nchar(260)nchar(260) Nome do arquivo do -sistema operacional (nome do arquivo físico).Operating-system file name (physical file name).
filegroupfilegroup nvarchar(128)nvarchar(128) Grupo de arquivos ao qual o arquivo pertence.Filegroup in which the file belongs.

NULL = ele é um arquivo de log.NULL = file is a log file. Ele nunca faz parte de um grupo de arquivos.This is never a part of a filegroup.
sizesize nvarchar(18)nvarchar(18) Tamanho do arquivo em megabytes.File size in megabytes.
tamanho máximomaxsize nvarchar(18)nvarchar(18) Tamanho máximo até o qual o arquivo pode crescer.Maximum size to which the file can grow. Um valor UNLIMITED neste campo indica que o arquivo cresce até o disco ficar cheio.A value of UNLIMITED in this field indicates that the file grows until the disk is full.
growthgrowth nvarchar(18)nvarchar(18) Incremento de crescimento do arquivo.Growth increment of the file. Indica a quantidade de espaço adicionada ao arquivo sempre que um novo espaço for necessário.This indicates the amount of space added to the file each time new space is needed.
Usousage varchar(9)varchar(9) Uso do arquivoUsage of the file. Para um arquivo de dados, o valor será 'dados' e para o arquivo de log é o valor 'log apenas'.For a data file, the value is 'data only' and for the log file the value is 'log only'.

ComentáriosRemarks

O status quais opções foram definidas como ON no banco de dados de relatórios do conjunto de colunas no resultado.The status column in the result set reports which options have been set to ON in the database. Todas as opções de banco de dados não são informadas por meio de status coluna.All database options are not reported by the status column. Para ver uma lista completa das configurações de opção de banco de dados atual, use o sys. Databases exibição do catálogo.To see a complete list of the current database option settings, use the sys.databases catalog view.

PermissõesPermissions

Quando um banco de dados é especificado, associação à pública função no banco de dados é necessária.When a single database is specified, membership in the public role in the database is required. Quando nenhum banco de dados for especificado, associação a pública função no mestre banco de dados é necessário.When no database is specified, membership in the public role in the master database is required.

Se um banco de dados não pode ser acessado, sp_helpdb exibe informações de 15622 e de mensagem de erro sobre o banco de dados quanto possível.If a database cannot be accessed, sp_helpdb displays error message 15622 and as much information about the database as it can.

ExemplosExamples

A.A. Retornando informações sobre um único banco de dadosReturning information about a single database

O exemplo a seguir exibe informações sobre o banco de dados AdventureWorks2012AdventureWorks2012.The following example displays information about the AdventureWorks2012AdventureWorks2012 database.

EXEC sp_helpdb N'AdventureWorks2012';  

B.B. Retornando informações sobre todos os bancos de dadosReturning information about all databases

O exemplo a seguir exibe informações sobre todos os bancos de dados no servidor que executa o SQL ServerSQL Server.This following example displays information about all databases on the server running SQL ServerSQL Server.

EXEC sp_helpdb;  
GO  

Consulte tambémSee Also

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
ALTER DATABASE (Transact-SQL) ALTER DATABASE (Transact-SQL)
CREATE DATABASE (SQL Server Transact-SQL) CREATE DATABASE (SQL Server Transact-SQL)
sys.databases (Transact-SQL) sys.databases (Transact-SQL)
sys.database_files (Transact-SQL) sys.database_files (Transact-SQL)
sys.filegroups (Transact-SQL) sys.filegroups (Transact-SQL)
sys.master_files (Transact-SQL) sys.master_files (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)