Organization Usage¶

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

备注

本主题讨论常规账户中的 ORGANIZATION_USAGE 架构。要在组织账户中使用 ORGANIZATION_USAGE 架构，包括访问常规账户中不可用的高级视图，请参阅组织账户。

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

备注

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

向非管理员授予访问权限¶

向非管理员授予访问权限的方式取决于他们是否正在访问 ORGANIZATION_USAGE 视图。

在组织账户中，管理员使用应用程序角色向非管理员授予访问权限。有关信息，请参阅授予对组织使用情况视图的访问权限。
在已启用 ORGADMIN 的常规账户中，管理员使用 SNOWFLAKE 数据库角色向非管理员授予访问权限。

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 *。