Utilisation de l’organisation¶

Snowflake fournit des données historiques d’utilisation pour tous les comptes de votre organisation via le schéma ORGANIZATION_USAGE dans une base de données partagée nommée SNOWFLAKE.

Vues ORGANIZATION_USAGE¶

Le schéma ORGANIZATION_USAGE contient les vues suivantes :

Vue	Type	Latence ^[1]	Remarques
ACCESS_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
ACCOUNTS	Objet	24 heures
ALERT_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
ANOMALIES_IN_CURRENCY_DAILY	Historique	24 heures
AUTOMATIC_CLUSTERING_HISTORY	Historique	24 heures	Données conservées pendant un an.
CLASSES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
CLASS_INSTANCES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
COLUMNS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
COMPLETE_TASK_GRAPHS	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
CONTRACT_ITEMS ^[2]	Historique	24 heures
COPY_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
DATA_TRANSFER_DAILY_HISTORY	Historique	2 heures	Données conservées pendant un an.
DATA_TRANSFER_HISTORY	Historique	24 heures	Données conservées pendant un an.
DATABASE_STORAGE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant un an.
DATABASES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
FILE_FORMATS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
FUNCTIONS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
GRANTS_TO_ROLES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
GRANTS_TO_USERS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	Historique	72 heures	Données conservées pendant un an.
LOAD_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
LOCK_WAIT_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
LOGIN_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
MARKETPLACE_DISBURSEMENT_REPORT	Historique	24 heures	Données conservées pendant un an.
MARKETPLACE_PAID_USAGE_DAILY	Historique	24 heures	Données conservées pendant un an.
MASKING_POLICIES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
MATERIALIZED_VIEW_REFRESH_HISTORY	Historique	24 heures	Données conservées pendant un an.
METERING_DAILY_HISTORY	Historique	2 heures	Données conservées pendant un an.
MONETIZED_USAGE_DAILY	Historique	24 heures	Données conservées pendant un an.
OBJECT_DEPENDENCIES	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
PASSWORD_POLICIES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
PIPE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant un an.
PIPES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
POLICY_REFERENCES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
PROCEDURES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
QUERY_ACCELERATION_ELIGIBLE	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
QUERY_ACCELERATION_HISTORY	Historique	24 heures	Données conservées pendant un an.
QUERY_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
RATE_SHEET_DAILY ^[2]	Historique	24 heures
REFERENTIAL_CONSTRAINTS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
REMAINING_BALANCE_DAILY ^[2]	Historique	72 heures
REPLICATION_GROUP_REFRESH_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
REPLICATION_GROUP_USAGE_HISTORY	Historique	24 heures	Données conservées pendant un an.
REPLICATION_USAGE_HISTORY	Historique	24 heures	Données conservées pendant un an.
RESOURCE_MONITORS		24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
ROLES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
ROW_ACCESS_POLICIES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
SCHEMATA	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
SEARCH_OPTIMIZATION_HISTORY	Historique	24 heures	Données conservées pendant un an.
SEQUENCES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
SESSION_POLICIES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
SESSIONS	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
STAGES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
STAGE_STORAGE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant un an.
STORAGE_DAILY_HISTORY	Historique	2 heures	Données conservées pendant un an.
TABLE_CONSTRAINTS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TABLE_STORAGE_METRICS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TABLES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TAG_REFERENCES	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TAGS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TASK_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
TASK_VERSIONS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
USAGE_IN_CURRENCY_DAILY ^[2]	Historique	72 heures
USERS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
VIEWS	Objet	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
WAREHOUSE_EVENTS_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
WAREHOUSE_LOAD_HISTORY	Historique	24 heures	Vue Premium (uniquement disponible dans le compte de l’organisation).
WAREHOUSE_METERING_HISTORY	Historique	24 heures	Données conservées pendant un an.

_{[1] Tous les temps de latence sont approximatifs. Dans certains cas, la latence réelle peut être inférieure.}

_{[2] Les vues de facturation des organisations n’affichent pas le montant final réel, car certains ajustements sont effectués à la fin du mois. Les clients qui ont signé un contrat par l’intermédiaire d’un revendeur Snowflake ne peuvent pas accéder aux données dans ces vues.}

Accès au schéma ORGANIZATION_USAGE¶

Le schéma ORGANIZATION_USAGE est disponible dans le compte de l’organisation et dans un compte classique dont le rôle ORGADMIN est activé. L’accès aux vues du schéma dépend du type de compte que vous utilisez. Pour plus d’informations sur l’accès aux vues, reportez-vous à ce qui suit :

Schéma d’accès dans le compte de l’organisation
Schéma d’accès dans un compte compatible avec ORGADMIN

Note

Les vues du schéma ORGANIZATION_USAGE ne sont actuellement pas disponibles dans les régions US SnowGov sur AWS GovCloud et Microsoft Azure Government.

Schéma d’accès dans le compte de l’organisation¶

Par défaut, seuls les utilisateurs auxquels le rôle GLOBALORGADMIN a été attribué peuvent accéder aux vues ORGANIZATION_USAGE dans le compte de l’organisation.

Pour accorder l’accès à d’autres utilisateurs, l’administrateur de l’organisation peut accorder le rôle d’application approprié à un utilisateur ou un rôle de compte.

Les utilisateurs qui disposent du rôle d’application ORG_USAGE_ADMIN peuvent accéder à toutes les vues dans le schéma ORGANIZATION_USAGE du compte organisation. L’exemple suivant permet à l’utilisateur joe d’accéder à toutes les vues du schéma :

USE ROLE GLOBALORGADMIN;

GRANT APPLICATION ROLE ORG_USAGE_ADMIN TO ROLE custom_role;

GRANT ROLE custom_role TO USER joe;

Copy

L’administrateur de l’organisation peut également accorder l’accès à un niveau plus granulaire. Par exemple, le rôle d’application ORGANIZATION_OBJECT_VIEWER autorise l’accès à la vue DATABASES, mais n’autorise pas l’accès à la vue TASK_HISTORY.

Utilisez la liste suivante pour déterminer quel rôle d’application accorde l’accès à une vue spécifique.

Vue	Rôle d’application requis
Vue ACCESS_HISTORY	ORGANIZATION_GOVERNANCE_VIEWER
Vue ACCOUNTS	ORGANIZATION_ACCOUNTS_VIEWER
Vue ALERT_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue AUTOMATIC_CLUSTERING_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue CLASSES	ORGANIZATION_USAGE_VIEWER
Vue CLASS_INSTANCES	ORGANIZATION_USAGE_VIEWER
Vue COLUMNS	ORGANIZATION_OBJECT_VIEWER
Vue COMPLETE_TASK_GRAPHS	ORGANIZATION_OBJECT_VIEWER
Vue CONTRACT_ITEMS	ORGANIZATION_BILLING_VIEWER
Vue COPY_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue DATABASE_STORAGE_USAGE_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue DATABASES	ORGANIZATION_OBJECT_VIEWER
Vue DATA_TRANSFER_DAILY_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue DATA_TRANSFER_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue FILE_FORMATS	ORGANIZATION_OBJECT_VIEWER
Vue FUNCTIONS	ORGANIZATION_OBJECT_VIEWER
Vue GRANTS_TO_ROLES	ORGANIZATION_SECURITY_VIEWER
Vue GRANTS_TO_USERS	ORGANIZATION_SECURITY_VIEWER
Vue LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	ORGANIZATION_BILLING_VIEWER
Vue LOAD_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue LOCK_WAIT_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue LOGIN_HISTORY	ORGANIZATION_SECURITY_VIEWER
Vue MARKETPLACE_DISBURSEMENT_REPORT	ORGANIZATION_BILLING_VIEWER
Vue MARKETPLACE_PAID_USAGE_DAILY	ORGANIZATION_USAGE_VIEWER
Vue MARKETPLACE_PURCHASE_EVENTS	ORGANIZATION_BILLING_VIEWER
Vue MASKING_POLICIES	ORGANIZATION_GOVERNANCE_VIEWER
Vue MATERIALIZED_VIEW_REFRESH_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue METERING_DAILY_HISTORY	ORGANIZATION_USAGE_VIEWER
MONETIZED_USAGE_DAILY	ORGANIZATION_USAGE_VIEWER
Vue OBJECT_DEPENDENCIES	ORGANIZATION_OBJECT_VIEWER
Vue PASSWORD_POLICIES	ORGANIZATION_SECURITY_VIEWER
Vue PIPE_USAGE_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue PIPES	ORGANIZATION_OBJECT_VIEWER
Vue POLICY_REFERENCES	ORGANIZATION_GOVERNANCE_VIEWER
Vue PROCEDURES	ORGANIZATION_OBJECT_VIEWER
Vue QUERY_ACCELERATION_ELIGIBLE	ORGANIZATION_GOVERNANCE_VIEWER
Vue QUERY_ACCELERATION_HISTORY	ORGANIZATION_GOVERNANCE_VIEWER ORGANIZATION_USAGE_VIEWER
Vue QUERY_HISTORY	ORGANIZATION_GOVERNANCE_VIEWER
Vue RATE_SHEET_DAILY	ORGANIZATION_BILLING_VIEWER
Vue REFERENTIAL_CONSTRAINTS	ORGANIZATION_OBJECT_VIEWER
Vue REMAINING_BALANCE_DAILY	ORGANIZATION_BILLING_VIEWER
Vue REPLICATION_GROUP_REFRESH_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue REPLICATION_GROUP_USAGE_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue REPLICATION_USAGE_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue RESOURCE_MONITORS	ORGANIZATION_OBJECT_VIEWER
Vue ROLES	ORGANIZATION_SECURITY_VIEWER
Vue ROW_ACCESS_POLICIES	ORGANIZATION_GOVERNANCE_VIEWER
Vue SCHEMATA	ORGANIZATION_OBJECT_VIEWER
Vue SEARCH_OPTIMIZATION_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue SEQUENCES	ORGANIZATION_OBJECT_VIEWER
Vue SESSION_POLICIES	ORGANIZATION_SECURITY_VIEWER
Vue SESSIONS	ORGANIZATION_SECURITY_VIEWER
Vue STAGE_STORAGE_USAGE_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue STAGES	ORGANIZATION_OBJECT_VIEWER
Vue STORAGE_DAILY_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue TABLE_CONSTRAINTS	ORGANIZATION_OBJECT_VIEWER
Vue TABLE_STORAGE_METRICS	ORGANIZATION_USAGE_VIEWER
Vue TABLES	ORGANIZATION_OBJECT_VIEWER
Vue TAG_REFERENCES	ORGANIZATION_GOVERNANCE_VIEWER
Vue TAGS	ORGANIZATION_OBJECT_VIEWER
Vue TASK_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue TASK_VERSIONS	ORGANIZATION_OBJECT_VIEWER
Vue USAGE_IN_CURRENCY_DAILY	ORGANIZATION_BILLING_VIEWER
Vue USERS	ORGANIZATION_SECURITY_VIEWER
Vue VIEWS	ORGANIZATION_OBJECT_VIEWER
Vue WAREHOUSE_EVENTS_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue WAREHOUSE_LOAD_HISTORY	ORGANIZATION_USAGE_VIEWER
Vue WAREHOUSE_METERING_HISTORY	ORGANIZATION_USAGE_VIEWER

Schéma d’accès dans un compte compatible avec ORGADMIN¶

Un compte activé ORGADMIN est un compte normal dont le rôle ORGADMIN est activé. Au sein d’un compte ORGADMIN, toute personne ayant accès à la base de données partagée SNOWFLAKE a accès au schéma ORGANIZATION_USAGE. Par défaut, seul le rôle ACCOUNTADMIN a des privilèges sur cette base de données, ce qui signifie que le rôle ORGADMIN n’a pas les privilèges nécessaires. Pour accorder ces privilèges au rôle ORGADMIN, voir Permettre à d’autres rôles d’utiliser des schémas dans la base de données SNOWFLAKE.

Pour accorder l’accès à des non-administrateurs, l’administrateur de l’organisation peut accorder le rôle de base de données approprié à un utilisateur ou un rôle de compte.

Utilisez la liste suivante pour déterminer quel rôle dans la base de données donne accès à des vues spécifiques.

Les rôles de base de données ORGANIZATION_USAGE_VIEWER, ORGANIZATION_BILLING_VIEWER et ORGANIZATION_ACCOUNTS_VIEWER de SNOWFLAKE se voient accorder le privilège SELECT pour trouver les vues Utilisation de l’organisation dans la base de données partagée de SNOWFLAKE.

Vue	Rôle ORGANIZATION_BILLING_VIEWER	Rôle ORGANIZATION_USAGE_VIEWER	Rôle ORGANIZATION_ACCOUNTS_VIEWER
Vue ACCOUNTS			✔
Vue ANOMALIES_IN_CURRENCY_DAILY	✔
Vue CONTRACT_ITEMS	✔
Vue LISTING_AUTO_FULFILLMENT_USAGE_HISTORY	✔
Vue RATE_SHEET_DAILY	✔
Vue REMAINING_BALANCE_DAILY	✔
Vue USAGE_IN_CURRENCY_DAILY	✔
Vue MARKETPLACE_DISBURSEMENT_REPORT	✔
Vue DATA_TRANSFER_DAILY_HISTORY		✔
Vue DATA_TRANSFER_HISTORY		✔
Vue DATABASE_STORAGE_USAGE_HISTORY		✔
Vue AUTOMATIC_CLUSTERING_HISTORY		✔
Vue MARKETPLACE_PAID_USAGE_DAILY		✔
Vue MATERIALIZED_VIEW_REFRESH_HISTORY		✔
Vue METERING_DAILY_HISTORY		✔
Vue MONETIZED_USAGE_DAILY		✔
Vue PIPE_USAGE_HISTORY		✔
Vue QUERY_ACCELERATION_HISTORY		✔
Vue REPLICATION_GROUP_USAGE_HISTORY		✔
Vue REPLICATION_USAGE_HISTORY		✔
Vue SEARCH_OPTIMIZATION_HISTORY		✔
Vue STAGE_STORAGE_USAGE_HISTORY		✔
Vue STORAGE_DAILY_HISTORY		✔
Vue WAREHOUSE_METERING_HISTORY		✔

Pour plus d’informations, reportez-vous à GRANT DATABASE ROLE.

Notes générales sur l’utilisation¶

Les vues spécifiques à Snowflake sont susceptibles d’être modifiées. Évitez de sélectionner toutes les colonnes dans ces vues. À la place, sélectionnez les colonnes que vous voulez. Par exemple, si vous voulez la colonne name utilisez SELECT name, plutôt que SELECT *.