- Schema:
DATABASES view¶
Important
This view is only available in the organization account. For more information, see Premium views in the organization account.
This Organization Usage view displays a row for each database defined in an account.
Columns¶
Organization-level columns
| Column Name | Data Type | Description |
|---|---|---|
| ORGANIZATION_NAME | VARCHAR | Name of the organization. |
| ACCOUNT_LOCATOR | VARCHAR | System-generated identifier for the account. |
| ACCOUNT_NAME | VARCHAR | User-defined identifier for the account. |
Additional 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 24 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.