- Schema:
For guidance on query performance when using organization-wide usage views, see Performance (Organization Usage).
CREDENTIALS view¶
Important
This view is only available in the organization account. For more information, see Premium views in the organization account.
Organization Usage performance
When you query a specific view in the SNOWFLAKE.ORGANIZATION_USAGE schema, follow the organization-wide guidance in
Performance (Organization Usage): bound every scan on history views, list
columns explicitly, and use the time filter column table plus worked SQL and anti-patterns there.
This Organization Usage view provides the credentials used for authentication across each account in your organization. Each row corresponds to a different credential.
This view includes rows for the following types of credentials:
- Programmatic access tokens
- Passkeys
- Time-based one-time passcodes (TOTPs)
- Workload identity federation
- Key pairs
This view doesn’t include credentials that have been deleted.
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 | Data type | Description |
|---|---|---|
| CREDENTIAL_ID | NUMBER | Internal/system-generated identifier for the credential. |
| NAME | VARCHAR | Name of the credential. |
| USER_NAME | VARCHAR | Name of the user associated with the credential. |
| TYPE | VARCHAR | Type of the credential. These types include:
|
| DOMAIN | VARCHAR | Domain of the credential. The domains include:
A given domain can have one or more possible types (specified in the TYPE column). |
| COMMENT | VARCHAR | Comment about the credential. |
| STATUS | VARCHAR | Status of the credential. The status depends on the value in the TYPE column:
If a key pair is both disabled and past its expiration time, the status is reported as
|
| ADDITIONAL_DETAILS | OBJECT | Additional details about the credential. The additional details depend on the type of the credential (the value in the TYPE column):
These key-value pairs are present only if the corresponding properties are set in the token. For example: If none of these are specified for the token, the column contains an empty object (
|
| CREATED_BY | VARCHAR | Name of the user who created the credential. |
| LAST_ALTERED_BY | VARCHAR | Name of the user who last modified the credential. |
| CREATED_ON | TIMESTAMP_LTZ | Date and time when the credential was created. |
| LAST_USED_ON | TIMESTAMP_LTZ | Date and time when the credential was last used for authentication. |
| LAST_ALTERED | TIMESTAMP_LTZ | Date and time when the credential was last modified. |
| EXPIRATION_DATE | TIMESTAMP_LTZ | Date and time when the credential expires. |
Usage notes¶
- Latency for the view may be up to 24 hours.
- If a programmatic access token is generated soon after a user is created, the information about that user in this view might be incomplete. It might take some time for the user information to be included in the view.