Organization Usage¶

通过在名为 SNOWFLAKE 的共享数据库中的 ORGANIZATION_USAGE 架构，Snowflake 提供组织中所有账户的历史使用数据。

ORGANIZATION_USAGE 视图¶

ORGANIZATION_USAGE 架构包含以下视图：

视图	类型	延迟 ^[1]	备注
ACCESS_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
ACCOUNTS	对象	24 小时
ALERT_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
AUTOMATIC_CLUSTERING_HISTORY	历史数据	24 小时	数据保留 1 年。
CLASSES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
CLASS_INSTANCES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
COLUMNS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
COMPLETE_TASK_GRAPHS	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
CONTRACT_ITEMS^[2]	历史数据	24 小时
COPY_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
DATA_TRANSFER_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
DATA_TRANSFER_HISTORY	历史数据	24 小时	数据保留 1 年。
DATABASE_STORAGE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
DATABASES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
FILE_FORMATS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
FUNCTIONS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
GRANTS_TO_ROLES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
GRANTS_TO_USERS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	历史数据	72 小时	数据保留 1 年。
LOAD_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
LOCK_WAIT_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
LOGIN_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
MARKETPLACE_DISBURSEMENT_REPORT	历史数据	24 小时	数据保留 1 年。
MARKETPLACE_PAID_USAGE_DAILY	历史数据	24 小时	数据保留 1 年。
MASKING_POLICIES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
MATERIALIZED_VIEW_REFRESH_HISTORY	历史数据	24 小时	数据保留 1 年。
METERING_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
MONETIZED_USAGE_DAILY	历史数据	24 小时	数据保留 1 年。
OBJECT_DEPENDENCIES	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
PASSWORD_POLICIES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
PIPE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
PIPES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
POLICY_REFERENCES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
PROCEDURES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
QUERY_ACCELERATION_ELIGIBLE	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
QUERY_ACCELERATION_HISTORY	历史数据	24 小时	数据保留 1 年。
QUERY_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
RATE_SHEET_DAILY^[2]	历史数据	24 小时
REFERENTIAL_CONSTRAINTS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
REMAINING_BALANCE_DAILY^[2]	历史数据	72 小时
REPLICATION_GROUP_REFRESH_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
REPLICATION_GROUP_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
REPLICATION_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
RESOURCE_MONITORS		24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
ROLES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
ROW_ACCESS_POLICIES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
SCHEMATA	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
SEARCH_OPTIMIZATION_HISTORY	历史数据	24 小时	数据保留 1 年。
SEQUENCES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
SESSION_POLICIES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
SESSIONS	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
STAGES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
STAGE_STORAGE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
STORAGE_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
TABLE_CONSTRAINTS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TABLE_STORAGE_METRICS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TABLES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TAG_REFERENCES	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TAGS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TASK_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
TASK_VERSIONS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
USAGE_IN_CURRENCY_DAILY^[2]	历史数据	72 小时
USERS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
VIEWS	对象	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
WAREHOUSE_EVENTS_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
WAREHOUSE_LOAD_HISTORY	历史数据	24 小时	:doc:`高级视图 </user-guide/organization-accounts-premium-views>`（仅在组织账户中可用）。
WAREHOUSE_METERING_HISTORY	历史数据	24 小时	数据保留 1 年。

_{[1] 所有延迟时间均为近似值；在某些情况下，实际延迟可能会更低。}

_{[2] 组织账单视图不显示实际的最终金额，因为月底会进行一些调整。通过 Snowflake 经销商签订合同的客户无法访问这些视图中的数据。}

访问 ORGANIZATION_USAGE 架构¶

ORGANIZATION_USAGE 架构可在组织账户和启用 ORGADMIN 角色的常规账户中使用。访问架构中视图的方式因您使用的账户类型而异。有关访问视图的详细信息，请参阅以下内容：

访问组织账户中的架构
在已启用 ORGADMIN 的账户中访问架构

备注

ORGANIZATION_USAGE 架构中的视图目前在 AWS GovCloud 和 Azure 美国政府版上的 US SnowGov 区域中尚不可用。

访问组织账户中的架构¶

默认情况下，只有被授予 GLOBALORGADMIN 角色的用户才能访问组织账户中的 ORGANIZATION_USAGE 视图。

要授予其他用户访问权限，组织管理员可以向账户角色或用户授予适当的 应用程序角色。

已获得 ORG_USAGE_ADMIN 应用程序角色授权的用户可以访问组织账户 ORGANIZATION_USAGE 架构中的视图。以下示例中，向用户 joe 授予了权限，使其能够访问架构中的所有视图：

USE ROLE GLOBALORGADMIN;

GRANT APPLICATION ROLE ORG_USAGE_ADMIN TO ROLE custom_role;

GRANT ROLE custom_role TO USER joe;

Copy

组织管理员还可以从更精细的角度来授予访问权限。例如，ORGANIZATION_OBJECT_VIEWER 应用程序角色授予对 DATABASES 视图的访问权限，但不授予对 TASK_HISTORY 视图的访问权限。

使用以下列表来确定哪个应用程序角色授予对特定视图的访问权限。

视图	所需应用程序角色
ACCESS_HISTORY 视图	ORGANIZATION_GOVERNANCE_VIEWER
ACCOUNTS 视图	ORGANIZATION_ACCOUNTS_VIEWER
ALERT_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
AUTOMATIC_CLUSTERING_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
CLASSES 视图	ORGANIZATION_USAGE_VIEWER
CLASS_INSTANCES 视图	ORGANIZATION_USAGE_VIEWER
COLUMNS 视图	ORGANIZATION_OBJECT_VIEWER
COMPLETE_TASK_GRAPHS 视图	ORGANIZATION_OBJECT_VIEWER
CONTRACT_ITEMS 视图	ORGANIZATION_BILLING_VIEWER
COPY_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
DATABASE_STORAGE_USAGE_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
DATABASES 视图	ORGANIZATION_OBJECT_VIEWER
DATA_TRANSFER_DAILY_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
DATA_TRANSFER_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
FILE_FORMATS 视图	ORGANIZATION_OBJECT_VIEWER
FUNCTIONS 视图	ORGANIZATION_OBJECT_VIEWER
GRANTS_TO_ROLES 视图	ORGANIZATION_SECURITY_VIEWER
GRANTS_TO_USERS 视图	ORGANIZATION_SECURITY_VIEWER
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY 视图	ORGANIZATION_BILLING_VIEWER
LOAD_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
LOCK_WAIT_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
LOGIN_HISTORY 视图	ORGANIZATION_SECURITY_VIEWER
MARKETPLACE_DISBURSEMENT_REPORT 视图	ORGANIZATION_BILLING_VIEWER
MARKETPLACE_PAID_USAGE_DAILY 视图	ORGANIZATION_USAGE_VIEWER
MARKETPLACE_PURCHASE_EVENTS 视图	ORGANIZATION_BILLING_VIEWER
MASKING_POLICIES 视图	ORGANIZATION_GOVERNANCE_VIEWER
MATERIALIZED_VIEW_REFRESH_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
METERING_DAILY_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
MONETIZED_USAGE_DAILY	ORGANIZATION_USAGE_VIEWER
OBJECT_DEPENDENCIES 视图	ORGANIZATION_OBJECT_VIEWER
PASSWORD_POLICIES 视图	ORGANIZATION_SECURITY_VIEWER
PIPE_USAGE_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
PIPES 视图	ORGANIZATION_OBJECT_VIEWER
POLICY_REFERENCES 视图	ORGANIZATION_GOVERNANCE_VIEWER
PROCEDURES 视图	ORGANIZATION_OBJECT_VIEWER
QUERY_ACCELERATION_ELIGIBLE 视图	ORGANIZATION_GOVERNANCE_VIEWER
QUERY_ACCELERATION_HISTORY 视图	ORGANIZATION_GOVERNANCE_VIEWER ORGANIZATION_USAGE_VIEWER
QUERY_HISTORY 视图	ORGANIZATION_GOVERNANCE_VIEWER
RATE_SHEET_DAILY 视图	ORGANIZATION_BILLING_VIEWER
REFERENTIAL_CONSTRAINTS 视图	ORGANIZATION_OBJECT_VIEWER
REMAINING_BALANCE_DAILY 视图	ORGANIZATION_BILLING_VIEWER
REPLICATION_GROUP_REFRESH_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
REPLICATION_GROUP_USAGE_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
REPLICATION_USAGE_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
RESOURCE_MONITORS 视图	ORGANIZATION_OBJECT_VIEWER
ROLES 视图	ORGANIZATION_SECURITY_VIEWER
ROW_ACCESS_POLICIES 视图	ORGANIZATION_GOVERNANCE_VIEWER
SCHEMATA 视图	ORGANIZATION_OBJECT_VIEWER
SEARCH_OPTIMIZATION_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
SEQUENCES 视图	ORGANIZATION_OBJECT_VIEWER
SESSION_POLICIES 视图	ORGANIZATION_SECURITY_VIEWER
SESSIONS 视图	ORGANIZATION_SECURITY_VIEWER
STAGE_STORAGE_USAGE_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
STAGES 视图	ORGANIZATION_OBJECT_VIEWER
STORAGE_DAILY_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
TABLE_CONSTRAINTS 视图	ORGANIZATION_OBJECT_VIEWER
TABLE_STORAGE_METRICS 视图	ORGANIZATION_USAGE_VIEWER
TABLES 视图	ORGANIZATION_OBJECT_VIEWER
TAG_REFERENCES 视图	ORGANIZATION_GOVERNANCE_VIEWER
TAGS 视图	ORGANIZATION_OBJECT_VIEWER
TASK_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
TASK_VERSIONS 视图	ORGANIZATION_OBJECT_VIEWER
USAGE_IN_CURRENCY_DAILY 视图	ORGANIZATION_BILLING_VIEWER
USERS 视图	ORGANIZATION_SECURITY_VIEWER
VIEWS 视图	ORGANIZATION_OBJECT_VIEWER
WAREHOUSE_EVENTS_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
WAREHOUSE_LOAD_HISTORY 视图	ORGANIZATION_USAGE_VIEWER
WAREHOUSE_METERING_HISTORY 视图	ORGANIZATION_USAGE_VIEWER

在已启用 ORGADMIN 的账户中访问架构¶

已启用 ORGADMIN 的账户是已启用 ORGADMIN 角色的常规账户。在已启用 ORGADMIN 的账户内，有权访问共享 SNOWFLAKE 数据库的任何人均有权访问 ORGANIZATION_USAGE 架构。默认情况下，只有 ACCOUNTADMIN 角色对该数据库具有权限，这意味着 ORGADMIN 角色不具有必要的权限。要向 ORGADMIN 角色授予这些权限，请参阅允许其他角色使用 SNOWFLAKE 数据库中的架构。

要向非管理员授予访问权限，组织管理员可以向账户角色或用户授予相应的 数据库角色。

使用以下列表来确定哪个数据库角色授予对特定视图的访问权限。

ORGANIZATION_USAGE_VIEWER、ORGANIZATION_BILLING_VIEWER 和 ORGANIZATION_ACCOUNTS_VIEWER SNOWFLAKE 数据库角色被授予共享 SNOWFLAKE 数据库中 Organization Usage 视图的 SELECT 权限。

视图	ORGANIZATION_BILLING_VIEWER 角色	ORGANIZATION_USAGE_VIEWER 角色	ORGANIZATION_ACCOUNTS_VIEWER 角色
ACCOUNTS 视图			✔
CONTRACT_ITEMS 视图	✔
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY 视图	✔
RATE_SHEET_DAILY 视图	✔
REMAINING_BALANCE_DAILY 视图	✔
USAGE_IN_CURRENCY_DAILY 视图	✔
MARKETPLACE_DISBURSEMENT_REPORT 视图	✔
DATA_TRANSFER_DAILY_HISTORY 视图		✔
DATA_TRANSFER_HISTORY 视图		✔
DATABASE_STORAGE_USAGE_HISTORY 视图		✔
AUTOMATIC_CLUSTERING_HISTORY 视图		✔
MARKETPLACE_PAID_USAGE_DAILY 视图		✔
MATERIALIZED_VIEW_REFRESH_HISTORY 视图		✔
METERING_DAILY_HISTORY 视图		✔
MONETIZED_USAGE_DAILY 视图		✔
PIPE_USAGE_HISTORY 视图		✔
QUERY_ACCELERATION_HISTORY 视图		✔
REPLICATION_GROUP_USAGE_HISTORY 视图		✔
REPLICATION_USAGE_HISTORY 视图		✔
SEARCH_OPTIMIZATION_HISTORY 视图		✔
STAGE_STORAGE_USAGE_HISTORY 视图		✔
STORAGE_DAILY_HISTORY 视图		✔
WAREHOUSE_METERING_HISTORY 视图		✔

有关更多信息，请参阅 GRANT DATABASE ROLE。

一般使用说明¶

Snowflake 特定的视图可能会发生变化。避免从这些视图中选择所有列。相反，请选择所需的列。例如，如果您想选择 name 列，请使用 SELECT name，而不是 SELECT *。