Compartilhar via


sp_databases (Transact-SQL)

Lists databases that either reside in an instance of the SQL Server 2005 Database Engine or are accessible through a database gateway.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_databases

Return Code Values

None

Result Sets

Column name Data type Description

DATABASE_NAME

sysname

Name of the database. In the Database Engine, this column represents the database name as stored in the sys.databases catalog view.

DATABASE_SIZE

int

Size of database, in kilobytes.

REMARKS

varchar(254)

For the Database Engine, this field always returns NULL.

Remarks

Database names that are returned can be used as parameters in the USE statement to change the current database context.

sp_databases has no equivalent in Open Database Connectivity (ODBC).

Permissions

Requires CREATE DATABASE, or ALTER ANY DATABASE, or VIEW ANY DEFINITION permission, and must have access permission to the database. Cannot be denied VIEW ANY DEFINITION permission.

Examples

The following example shows executing sp_databases.

USE master;
GO
EXEC sp_databases;

See Also

Reference

sys.databases (Transact-SQL)
HAS_DBACCESS (Transact-SQL)

Help and Information

Getting SQL Server 2005 Assistance

Change History

Release History

14 April 2006

Changed content:
  • Corrected the permissions statement.