組織の使用状況¶

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

ORGANIZATION_USAGE ビュー¶

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

ビュー	型	待機時間:sup:`[1]`	注意
ACCESS_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
ACCOUNTS	オブジェクト	24時間
ALERT_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
ANOMALIES_IN_CURRENCY_DAILY	履歴	24時間
AUTOMATIC_CLUSTERING_HISTORY	履歴	24時間	データは1年間保持されます。
CLASSES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
CLASS_INSTANCES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
COLUMNS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
COMPLETE_TASK_GRAPHS	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
CONTRACT_ITEMS ^[2]	履歴	24時間
COPY_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
DATA_TRANSFER_DAILY_HISTORY	履歴	2時間	データは1年間保持されます。
DATA_TRANSFER_HISTORY	履歴	24時間	データは1年間保持されます。
DATABASE_STORAGE_USAGE_HISTORY	履歴	24時間	データは1年間保持されます。
DATABASES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
FILE_FORMATS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
FUNCTIONS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
GRANTS_TO_ROLES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
GRANTS_TO_USERS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	履歴	72時間	データは1年間保持されます。
LOAD_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
LOCK_WAIT_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
LOGIN_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
MARKETPLACE_DISBURSEMENT_REPORT	履歴	24時間	データは1年間保持されます。
MARKETPLACE_PAID_USAGE_DAILY	履歴	24時間	データは1年間保持されます。
MASKING_POLICIES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
MATERIALIZED_VIEW_REFRESH_HISTORY	履歴	24時間	データは1年間保持されます。
METERING_DAILY_HISTORY	履歴	2時間	データは1年間保持されます。
MONETIZED_USAGE_DAILY	履歴	24時間	データは1年間保持されます。
OBJECT_DEPENDENCIES	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
PASSWORD_POLICIES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
PIPE_USAGE_HISTORY	履歴	24時間	データは1年間保持されます。
PIPES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
POLICY_REFERENCES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
PROCEDURES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
QUERY_ACCELERATION_ELIGIBLE	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
QUERY_ACCELERATION_HISTORY	履歴	24時間	データは1年間保持されます。
QUERY_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
RATE_SHEET_DAILY ^[2]	履歴	24時間
REFERENTIAL_CONSTRAINTS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
REMAINING_BALANCE_DAILY ^[2]	履歴	72時間
REPLICATION_GROUP_REFRESH_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
REPLICATION_GROUP_USAGE_HISTORY	履歴	24時間	データは1年間保持されます。
REPLICATION_USAGE_HISTORY	履歴	24時間	データは1年間保持されます。
RESOURCE_MONITORS		24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
ROLES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
ROW_ACCESS_POLICIES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
SCHEMATA	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
SEARCH_OPTIMIZATION_HISTORY	履歴	24時間	データは1年間保持されます。
SEQUENCES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
SESSION_POLICIES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
SESSIONS	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
STAGES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
STAGE_STORAGE_USAGE_HISTORY	履歴	24時間	データは1年間保持されます。
STORAGE_DAILY_HISTORY	履歴	2時間	データは1年間保持されます。
TABLE_CONSTRAINTS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TABLE_STORAGE_METRICS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TABLES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TAG_REFERENCES	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TAGS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TASK_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
TASK_VERSIONS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
USAGE_IN_CURRENCY_DAILY ^[2]	履歴	72時間
USERS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
VIEWS	オブジェクト	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
WAREHOUSE_EVENTS_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
WAREHOUSE_LOAD_HISTORY	履歴	24時間	プレミアムビュー（組織アカウントでのみ利用可能）。
WAREHOUSE_METERING_HISTORY	履歴	24時間	データは1年間保持されます。

_{[1] すべての待機時間は概算です。状況に応じて、実際の待機時間は短くなる場合があります。}

_{[2] 一部の調整は月末に行われるため、組織の請求ビューには実際の最終的な金額は表示されません。Snowflakeリセラーを通じて契約を結んだ顧客は、これらのビューのデータにアクセスできません。}

ORGANIZATION_USAGE スキーマへのアクセス¶

ORGANIZATION_USAGE スキーマは、組織アカウントおよび ORGADMIN ロールを有効にした一般アカウントで利用可能です。スキーマ内のビューへのアクセス方法は、使用しているアカウントのタイプによって異なります。ビューへのアクセスについては、以下をご参照ください。

組織アカウントでのスキーマへのアクセス
ORGADMIN が有効なアカウントでのスキーマへのアクセス

注釈

ORGANIZATION_USAGE のビューは現在、 AWS GovCloud およびMicrosoft Azure Governmentの 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 データベースで組織の使用法ビューに対する SELECT 権限が付与されます。

ビュー	ORGANIZATION_BILLING_VIEWERロール	ORGANIZATION_USAGE_VIEWERロール	ORGANIZATION_ACCOUNTS_VIEWERロール
ACCOUNTS ビュー			✔
ANOMALIES_IN_CURRENCY_DAILY ビュー	✔
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 を使用します。