DATABASES view¶

This Information Schema view displays a row for each database defined in your account.

Note

This view uses Snowflake terminology of “database” whereas all the other Information Schema views use the standard INFORMATION_SCHEMA terminology of “catalog”. The two terms have the same meaning.

Columns¶

Column Name	Data Type	Description
DATABASE_NAME	TEXT	Name of the database.
DATABASE_OWNER	TEXT	Name of the role that owns the database.
IS_TRANSIENT	TEXT	Whether this is a transient database.
COMMENT	TEXT	Comment for this database.
CREATED	TIMESTAMP_LTZ	Creation time of the database.
LAST_ALTERED	TIMESTAMP_LTZ	Date and time the object was last altered. See Usage Notes.
RETENTION_TIME	NUMBER	Number of days that historical data is retained for Time Travel.
TYPE	VARCHAR	Specifies the type of database. Valid values are: . . - APPLICATION : an application object. . - APPLICATION_PACKAGE : an application package. . - STANDARD: a normal database. . - IMPORTED DATABASE: a database created from a share.
OWNER_ROLE_TYPE	TEXT	The type of role that owns the object, for example `ROLE`. . If a Snowflake Native App owns the object, the value is `APPLICATION`. . Snowflake returns NULL if you delete the object because a deleted object does not have an owner role.

Usage notes¶

The view only displays objects for which the current role for the session has been granted access privileges. The view does not honor the MANAGE GRANTS privilege and consequently may show less information compared to a SHOW command when both are executed by a user who holds the MANAGE GRANTS privilege.
This view contains all of the databases in the account (regardless of the database’s INFORMATION_SCHEMA used to query the view).
The LAST_ALTERED column is updated when the following operations are performed on an object:
- DDL operations.
- DML operations (for tables only). This column is updated even when no rows are affected by the DML statement.
- Background maintenance operations on metadata performed by Snowflake.