Organization Usage¶

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

本主题内容：

ORGANIZATION_USAGE 视图¶

ORGANIZATION_USAGE 架构包含以下视图：

视图	类型	延迟 ^[1]	备注
ACCOUNTS	对象	24 小时
AUTOMATIC_CLUSTERING_HISTORY	历史数据	24 小时	数据保留 1 年。
CONTRACT_ITEMS^[2]	历史数据	24 小时
DATA_TRANSFER_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
DATA_TRANSFER_HISTORY	历史数据	24 小时	数据保留 1 年。
DATABASE_STORAGE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	历史数据	72 小时	数据保留 1 年。
MARKETPLACE_DISBURSEMENT_REPORT	历史数据	24 小时	数据保留 1 年。
MARKETPLACE_PAID_USAGE_DAILY	历史数据	24 小时	数据保留 1 年。
MATERIALIZED_VIEW_REFRESH_HISTORY	历史数据	24 小时	数据保留 1 年。
METERING_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
MONETIZED_USAGE_DAILY	历史数据	24 小时	数据保留 1 年。
PIPE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
QUERY_ACCELERATION_HISTORY	历史数据	24 小时	数据保留 1 年。
RATE_SHEET_DAILY^[2]	历史数据	24 小时
REMAINING_BALANCE_DAILY^[2]	历史数据	72 小时
REPLICATION_GROUP_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
REPLICATION_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
SEARCH_OPTIMIZATION_HISTORY	历史数据	24 小时	数据保留 1 年。
STAGE_STORAGE_USAGE_HISTORY	历史数据	24 小时	数据保留 1 年。
STORAGE_DAILY_HISTORY	历史数据	2 小时	数据保留 1 年。
USAGE_IN_CURRENCY_DAILY^[2]	历史数据	72 小时
WAREHOUSE_METERING_HISTORY	历史数据	24 小时	数据保留 1 年。

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

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

访问 ORGANIZATION_USAGE 架构¶

要查看 ORGANIZATION_USAGE 架构中的数据，您必须：

从已启用 ORGADMIN 角色的账户（即 ORGADMIN 账户）访问数据。
具有查看数据的相应权限。在 ORGADMIN 账户内，有权访问共享 SNOWFLAKE 数据库的任何人均有权访问 ORGANIZATION_USAGE 架构。默认情况下，只有 ACCOUNTADMIN 角色对该数据库具有权限，这意味着 ORGADMIN 角色不具有必要的权限。若要向 ORGADMIN 角色授予这些权限，请参阅为其他角色启用 SNOWFLAKE 数据库使用。

若要向不是账户管理员或组织管理员的用户授予访问权限，请使用 SNOWFLAKE 数据库角色。

备注

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

SNOWFLAKE 数据库角色¶

Snowflake 为对 ORGANIZATION_USAGE 视图子集授予访问权限的 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 视图<https://other-docs.snowflake.com/en/collaboration/views/marketplace-disbursement-report-org>`_	✔
DATA_TRANSFER_DAILY_HISTORY 视图		✔
DATA_TRANSFER_HISTORY 视图		✔
DATABASE_STORAGE_USAGE_HISTORY 视图		✔
AUTOMATIC_CLUSTERING_HISTORY 视图		✔
`MARKETPLACE_PAID_USAGE_DAILY 视图<https://other-docs.snowflake.com/en/collaboration/views/marketplace-paid-usage-daily-org>`_		✔
MATERIALIZED_VIEW_REFRESH_HISTORY 视图		✔
METERING_DAILY_HISTORY 视图		✔
`MONETIZED_USAGE_DAILY 视图<https://other-docs.snowflake.com/en/collaboration/views/monetized-usage-daily-org>`_		✔
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 *。