sp_databases (Transact-SQL)
Aplica-se: 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 DATABASE
permissã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;