組織の使用状況¶

Snowflakeは、SNOWFLAKEという名前の共有データベースのORGANIZATION_USAGEスキーマを介して、組織内のすべてのアカウントの履歴使用状況データを提供します。

注釈

このトピックでは、通常のアカウントにおける ORGANIZATION_USAGE スキーマについて説明します。通常のアカウントでは利用できないプレミアムビューへのアクセスなど、組織アカウントで ORGANIZATION_USAGE スキーマを使用している場合は、組織アカウントをご参照ください。

ORGANIZATION_USAGE ビュー¶

ORGANIZATION_USAGEスキーマには次のビューが含まれます。

ビュー	型	待機時間:sup:`[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_USAGE のビューは現在、 AWS GovCloud およびMicrosoft Azure Governmentの US SnowGov リージョンでは利用できません。

SNOWFLAKE データベースロール¶

Snowflakeは、 ORGANIZATION_USAGE ビューのサブセットへのアクセス権を付与する、 SNOWFLAKE データベース用に事前定義されたデータベースロールを提供します。これにより、アカウント管理者または組織管理者以外のユーザーにアクセス権を付与できます。

ORGANIZATION_USAGE_VIEWER、 ORGANIZATION_BILLING_VIEWER、および ORGANIZATION_ACCOUNTS_VIEWER SNOWFLAKE データベースロールには、共有 SNOWFLAKE データベースで組織の使用法ビューに対する 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 * ではなく SELECT name を使用します。