- Schema:
DATABASES view¶
This Account Usage view displays a row for each database defined in your account.
Columns¶
| Column Name | Data Type | Description |
|---|---|---|
| DATABASE_ID | NUMBER | Internal/system-generated identifier for the database. |
| DATABASE_NAME | VARCHAR | Name of the database. |
| DATABASE_OWNER | VARCHAR | Name of the role that owns the database. |
| IS_TRANSIENT | VARCHAR | Whether the database is transient. |
| COMMENT | VARCHAR | Comment for the database. |
| CREATED | TIMESTAMP_LTZ | Date and time when the database was created. |
| LAST_ALTERED | TIMESTAMP_LTZ | Date and time the object was last altered by a DML, DDL, or background metadata operation. See Usage Notes. |
| DELETED | TIMESTAMP_LTZ | Date and time when the database was dropped. |
| RETENTION_TIME | NUMBER | Number of days that historical data is retained for Time Travel. |
| RESOURCE_GROUP | VARCHAR | For internal use. |
| TYPE | VARCHAR | Specifies the type of database. Valid values are: - APPLICATION: a Snowflake Native App. - APPLICATION_PACKAGE: an application package. - STANDARD: a normal database. - IMPORTED DATABASE: a database created from a share. - PERSONAL DATABASE: a personal database linked to its owner. |
| OWNER_ROLE_TYPE | VARCHAR | 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. |
| OBJECT_VISIBILITY | OBJECT |
|
Usage notes¶
- Latency for the view may be up to 180 minutes (3 hours).
- The view displays all of the databases in an account.
- The view does not recognize the MANAGE GRANTS privilege and consequently may show less information compared to a SHOW command executed by a user who holds the MANAGE GRANTS privilege.
-
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.