Schema:

ORGANIZATION_USAGE

For guidance on query performance when using organization-wide usage views, see Performance (Organization Usage).

MULTI_PARTY_APPROVAL_REQUESTS 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 returns one row for each Multi-party Approval request in an account.

Columns

Organization-level columns

Column NameData TypeDescription
ORGANIZATION_NAMEVARCHARName of the organization.
ACCOUNT_LOCATORVARCHARSystem-generated identifier for the account.
ACCOUNT_NAMEVARCHARUser-defined identifier for the account.

Additional columns

Column NameData TypeDescription
REQUEST_IDVARCHARUnique identifier for the approval request.
REQUESTER_USER_NAMEVARCHARName of the user who triggered the request.
STATUSVARCHARStatus of the request, such as PENDING, APPROVED, REJECTED, CANCELLED, or EXPIRED.
OPERATIONVARCHARThe protected operation that triggered the request, such as MODIFY_MULTI_PARTY_APPROVAL, DISABLE_MULTI_FACTOR_AUTHENTICATION, or MODIFY_NETWORK_POLICY.
JOB_UUIDVARCHARUUID of the job that triggered the request.
CREATED_TIMETIMESTAMP_LTZDate and time when the request was created.
RESOLVED_TIMETIMESTAMP_LTZDate and time when the request was resolved. NULL if the request is still pending.
EXPIRED_ATTIMESTAMP_LTZDate and time when the request expires or expired. NULL if the request has not yet expired.
REQUEST_JUSTIFICATIONVARCHARBusiness justification provided by the requester.
JUSTIFICATION_TIMETIMESTAMP_LTZDate and time when the justification was submitted. NULL if no justification was provided.
REQUIRED_APPROVALS_COUNTNUMBERNumber of approvals required for this request.
APPROVERSARRAY

An array of objects, one per approver, each with the following keys: approver_user_name, vote, assigned_time, voted_time, and comment.

POLICY_IDNUMBERInternal/system-generated identifier for the Multi-party Approval policy that governs the request.
POLICY_NAMEVARCHARFully qualified name (database.schema.policy) of the Multi-party Approval policy. NULL if the policy was dropped.

Usage notes

  • Latency for the view may be up to 24 hours.