Compartilhar via


sp_databases (Transact-SQL)

Aplica-se a: SQL Server

Lista os bancos de dados que residem em uma instância do SQL Server ou podem ser acessados por meio de um gateway de banco de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_databases
[ ; ]

Valores do código de retorno

Nenhum.

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
DATABASE_NAME sysname Nome do banco de dados. No Mecanismo de Banco de Dados, essa coluna representa o nome do banco de dados conforme armazenado no modo de exibição do sys.databases catálogo.
DATABASE_SIZE int Tamanho de banco de dados, em kilobytes.
REMARKS varchar(254) Para o Mecanismo de Banco de Dados, esse campo sempre retorna NULL.

Comentários

Os nomes de banco de dados retornados podem ser usados como parâmetros na USE instrução para alterar o contexto atual do banco de dados.

DATABASE_SIZE retorna um NULL valor para bancos de dados maiores que 2,15 TB.

sp_databases não tem equivalente em ODBC (Open Database Connectivity).

Permissões

Requer CREATE DATABASEpermissão , ou ALTER ANY DATABASE, ou VIEW ANY DEFINITION e deve ter permissão de acesso ao banco de dados. Não pode ser negada VIEW ANY DEFINITION a permissão.

Exemplos

O exemplo a seguir exibe a execução do sp_databases.

USE master;
GO
EXEC sp_databases;