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.

Dans ce chapitre :

Vues ORGANIZATION_USAGE
Accès au schéma ORGANIZATION_USAGE
- Rôles de base de données SNOWFLAKE du schéma ORGANIZATION_USAGE
Notes générales sur l’utilisation

Vues ORGANIZATION_USAGE¶

Le schéma ORGANIZATION_USAGE contient les vues suivantes :

Vue	Type	Latence ^[1]	Remarques
AUTOMATIC_CLUSTERING_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
CONTRACT_ITEMS ^[2]	Historique	24 heures
DATA_TRANSFER_DAILY_HISTORY	Historique	2 heures	Données conservées pendant 1 an.
DATA_TRANSFER_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
DATABASE_STORAGE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
MARKETPLACE_DISBURSEMENT_REPORT	Historique	24 heures	Données conservées pendant 1 an.
MARKETPLACE_PAID_USAGE_DAILY	Historique	24 heures	Données conservées pendant 1 an.
MATERIALIZED_VIEW_REFRESH_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
METERING_DAILY_HISTORY	Historique	2 heures	Données conservées pendant 1 an.
MONETIZED_USAGE_DAILY	Historique	24 heures	Données conservées pendant 1 an.
PIPE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
RATE_SHEET_DAILY ^[2]	Historique	24 heures
REMAINING_BALANCE_DAILY ^[2]	Historique	72 heures
REPLICATION_USAGE_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
SEARCH_OPTIMIZATION_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
STAGE_STORAGE_USAGE_HISTORY	Historique	24 heures	Données conservées pendant 1 an.
STORAGE_DAILY_HISTORY	Historique	2 heures	Données conservées pendant 1 an.
USAGE_IN_CURRENCY_DAILY ^[2]	Historique	72 heures
WAREHOUSE_METERING_HISTORY	Historique	24 heures	Données conservées pendant 1 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 n’est disponible que depuis un compte dont le rôle ORGADMIN est activé (c’est-à-dire le compte ORGADMIN).

Dans le 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, reportez-vous à Activation de l’utilisation de la base de données Snowflake pour d’autres rôles.

Rôles de base de données SNOWFLAKE du schéma ORGANIZATION_USAGE¶

Snowflake fournit des rôles de base de données prédéfinis pour la base de données SNOWFLAKE qui donnent accès à un sous-ensemble de vues ORGANIZATION_USAGE. Cela vous permet d’accorder l’accès à des utilisateurs qui ne sont pas l’administrateur du compte ou de l’organisation.

Les rôles de base de données ORGANIZATION_USAGE_VIEWER et ORGANIZATION_BILLING_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
Vue CONTRACT_ITEMS	✔
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 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 *.