ACCOUNT_USAGEの履歴はACCOUNTADMINでなくても見られる。SNOWFLAKEデータベースロールで付与する方法

ACCOUNT_USAGEの履歴はACCOUNTADMINでなくても見られる。SNOWFLAKEデータベースロールで付与する方法

Snowflakeのクエリ履歴やクレジット確認をACCOUNTADMINでしか行えないと思い込んでいませんか?実は、SNOWFLAKEデータベースロールを付与すれば、ACCOUNTADMIN以外のロールでもアカウント使用状況のビューを読めるようになります。その方法と設定方法を解説します。
2026.11.21

はじめに

データ事業本部の荒木です。

Snowflakeのクエリ履歴やクレジットの使用量を確認したいとき、ACCOUNTADMINに切り替えて見ていませんか。
私もSNOWFLAKE.ACCOUNT_USAGEにある履歴系のビューは、ACCOUNTADMINでしか見られないものだと思っていました。

ACCOUNT_USAGEのビューは、SNOWFLAKEデータベースに用意されている「SNOWFLAKEデータベースロール」をアカウントロールに付与すれば、ACCOUNTADMIN以外のロールでも見られます。データベースロールは用途ごとに分かれていて、たとえばUSAGE_VIEWERを付与するとMETERING_HISTORYなどの使用量のビューを、GOVERNANCE_VIEWERを付与するとQUERY_HISTORYなどを読めるようになります。

以降では、SNOWFLAKEデータベースロールの概要、ロールごとに見られるビュー、付与のしかたを順に説明します。

SNOWFLAKEデータベースロールとは何か

SNOWFLAKEデータベースロールとは、Snowflakeがあらかじめ用意しているデータベースロールで、SNOWFLAKEデータベースの特定のビューに対するSELECT権限などを持っています。自分で作る必要はなく、アカウントロールに付与するだけで、そのロールは対応するビューを読めるようになります。

公式ドキュメント (Account Usage) では、ACCOUNT_USAGEの権限をACCOUNTADMIN以外のロールに与える方法として、SNOWFLAKEデータベースにIMPORTED PRIVILEGESを付与する方法と、SNOWFLAKEデータベースロールを付与する方法の2つが挙げられています。そのうえで、次のように書かれています。

To avoid unintentionally granting access to organization-level data, consider using SNOWFLAKE database roles

IMPORTED PRIVILEGESはSNOWFLAKEデータベースの多くのスキーマをまとめて見せることになるため、必要なビューだけを見せたい場合はデータベースロールを使うことが勧められています。

図では、HISTORY_ROLEにUSAGE_VIEWERとGOVERNANCE_VIEWERを付与した状態を表しています。付与していないSECURITY_VIEWERとOBJECT_VIEWERに対応するビューは、灰色の点線で示したとおり見られません。

ACCOUNT_USAGEのビューはどのデータベースロールで見られるのか

ACCOUNT_USAGEには、4つのデータベースロールが用意されています。公式ドキュメントにはビューとロールの対応表があり、主なビューを抜き出すと次のとおりです。

データベースロール 対象 主なビュー
OBJECT_VIEWER オブジェクトのメタデータ DATABASES、SCHEMATA、TABLES、COLUMNS、VIEWS
USAGE_VIEWER 使用量の履歴 METERING_HISTORY、WAREHOUSE_METERING_HISTORY、STORAGE_USAGE、TASK_HISTORY、COPY_HISTORY
GOVERNANCE_VIEWER データガバナンス QUERY_HISTORY、ACCESS_HISTORY、MASKING_POLICIES、TAG_REFERENCES
SECURITY_VIEWER セキュリティ LOGIN_HISTORY、USERS、ROLES、GRANTS_TO_ROLES

履歴系のビューでも、使用量の履歴はUSAGE_VIEWER、クエリの履歴はGOVERNANCE_VIEWER、ログインの履歴はSECURITY_VIEWERと、対応するロールが分かれています。見せたい履歴に合わせて、付与するロールを選びます。すべての対応は参照に載せた公式ドキュメントで確認できます。

ACCOUNT_USAGE以外のスキーマにも、専用のデータベースロールがあります。

スキーマ データベースロール
ORGANIZATION_USAGE ORGANIZATION_USAGE_VIEWER、ORGANIZATION_BILLING_VIEWER、ORGANIZATION_ACCOUNTS_VIEWER
READER_ACCOUNT_USAGE READER_USAGE_VIEWER
DATA_SHARING_USAGE SHARING_USAGE_VIEWER
MONITORING MONITORING_VIEWER

SNOWFLAKEデータベースロールの付与のしかた

付与はGRANT DATABASE ROLEで行います。データベースロール名にはSNOWFLAKE.を付けます。次の例では、HISTORY_ROLEというアカウントロールに使用量の履歴とクエリの履歴を見せています。

USE ROLE ACCOUNTADMIN;

-- 使用量の履歴 (METERING_HISTORYなど) を見せる
GRANT DATABASE ROLE SNOWFLAKE.USAGE_VIEWER TO ROLE HISTORY_ROLE;

-- クエリの履歴 (QUERY_HISTORYなど) を見せる
GRANT DATABASE ROLE SNOWFLAKE.GOVERNANCE_VIEWER TO ROLE HISTORY_ROLE;

HISTORY_ROLEにUSAGE_VIEWERだけを付与して試したところ、METERING_HISTORYは読めて、GOVERNANCE_VIEWERに対応するQUERY_HISTORYは次の権限エラーになりました。付与したロールに対応するビューだけが見られることが分かります。

SQL compilation error: Object 'SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY' does not exist or not authorized.
Your primary role HISTORY_ROLE must have at least one privilege granted on TABLE SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY.

データベースロールは重ねて付与できるので、複数の用途のビューを見せたい場合は、必要なロールをそれぞれ付与します。

まとめ

ACCOUNT_USAGEの履歴系のビューは、ACCOUNTADMINでなくても、SNOWFLAKEデータベースロールを付与したロールで見られます。データベースロールは使用量・ガバナンス・セキュリティ・オブジェクトのメタデータという用途ごとに分かれているため、見せたい履歴に合わせて必要なロールだけを付与できます。履歴を確認するためだけにACCOUNTADMINを使っている場合は、データベースロールの付与を検討してみてください。

参照


Snowflakeの導入支援はクラスメソッドに!

クラスメソッドでは Snowflake の導入を支援しております。
製品の詳細や支援の内容についてお気軽にお問い合わせください。

Snowflakeの詳細を見る

この記事をシェアする

関連記事