Aperçu de la table d’événements¶

Rôles pour l’accès à la table d’événements par défaut et EVENTS_VIEW¶

Snowflake inclut les rôles d’application prédéfinis suivants que vous pouvez utiliser pour gérer l’accès à la table d’événements par défaut et à la vue EVENTS_VIEW : Une personne ayant le rôle ACCOUNTADMIN peut accéder à la table d’événements par défaut et à la vue EVENTS_VIEW et peut accorder les rôles décrits ici à d’autres rôles pour qu’ils y accèdent.

Vous devez accorder ces rôles à d’autres rôles, plutôt qu’à un utilisateur. Par exemple, vous pouvez attribuer le rôle EVENTS_ADMIN à un autre rôle d’administrateur que vous avez créé pour une utilisation administrative plus large.

GRANT APPLICATION ROLE SNOWFLAKE.EVENTS_ADMIN TO ROLE my_admin_role

GRANT APPLICATION ROLE SNOWFLAKE.EVENTS_VIEWER TO ROLE my_analysis_role

EVENTS_VIEWER:

Rôle avec privilèges pour exécuter une instruction SELECT sur la vue EVENTS_VIEW.

EVENTS_ADMIN:

Rôle avec les privilèges suivants :

• SELECT, TRUNCATE, DELETE sur la table d’événements par défaut.

• SELECT sur la vue EVENTS_VIEW de la table des événements par défaut.

• USAGE sur les procédures stockées suivantes :

  • ADD_ROW_ACCESS_POLICY_ON_EVENTS_VIEW

  • DROP_ROW_ACCESS_POLICY_ON_EVENTS_VIEW

• Ce rôle dispose également de privilèges pour exécuter une procédure stockée afin d’appliquer une politique d’accès aux lignes (RAP) sur la vue EVENTS_VIEW dont les données sont basées sur la table d’événements par défaut.

Gérer l’accès à la vue EVENTS_VIEW¶

Vous pouvez gérer l’accès aux données dans la vue EVENTS_VIEW avec des politiques d’accès aux lignes. Snowflake fournit des procédures stockées que vous pouvez utiliser pour ajouter et supprimer une politique d’accès à la vue EVENT_VIEW.

• ADD_ROW_ACCESS_POLICY_ON_EVENTS_VIEW(VARCHAR, ARRAY)— Lie une politique d’accès aux lignes aux colonnes spécifiées dans la EVENTS_VIEW.

• DROP_ROW_ACCESS_POLICY_ON_EVENTS_VIEW(VARCHAR)—Supprime la politique d’accès aux lignes spécifiée liée à la EVENTS_VIEW.

Créer une table d’événements¶

Pour créer une table d’événements, exécutez la commande CREATE EVENT TABLE.

Lorsque vous créez une table d’événements, vous ne spécifiez pas les colonnes de la table. Une table d’événements possède déjà un ensemble de colonnes prédéfinies, comme décrit dans Colonnes de table d’événements.

1. Assurez-vous que vous utilisez un rôle qui dispose du privilège CREATE EVENT TABLE <label-security_access_control_privileges_schema_privileges>.

2. Exécutez la commande CREATE EVENT TABLE pour créer la table d’événements, en spécifiant un nom pour la table d’événements.

   Vous utilisez le nom de la table d’événements pour associer la table à un objet, tel qu’une base de données.

   Par exemple, pour créer une table d’événements portant le nom my_events, exécutez l’instruction suivante :

   CREATE EVENT TABLE my_database.my_schema.my_events;
   

   Copy

Associer une table d’événements à un objet¶

Pour spécifier l’objet pour lequel une table d’événements est active, exécutez la commande ALTER <objet> sur l’objet.

L’association d’une table d’événements à une base de données est une fonctionnalité Enterprise Edition.

1. Assurez-vous que vous utilisez un rôle qui dispose des privilèges requis.

2. Exécutez la commande ALTER <objet> sur l’objet, en définissant le paramètre EVENT_TABLE sur le nom de votre table d’événements.

   L’activation de ce paramètre définit l’objet comme le champ d’application dans lequel les événements seront collectés dans la table d’événements spécifiée.

   Par exemple, pour associer la table d’événements à une base de données, utilisez ALTER DATABASE, comme dans l’exemple suivant :

   ALTER DATABASE my_database SET EVENT_TABLE = my_database.my_schema.my_events;
   

   Copy

   Dans cet exemple, Snowflake, en fonction de la façon dont vous avez spécifié les niveaux de télémétrie, capture les données de télémétrie pour les procédures et les UDFs dans my_database dans la table d’événements telemetry_database.telemetry_schema.my_events.

Définir la table d’événements pour le compte¶

Par exemple, pour définir la table d’événements nommée my_events dans le schéma my_schema de la base de données my_database comme table d’événements active pour votre compte, exécutez l’instruction suivante :

ALTER ACCOUNT SET EVENT_TABLE = my_database.my_schema.my_events;

Comme indiqué ci-dessus, vous devez spécifier le nom pleinement qualifié de la table d’événements.

Pour dissocier une table d’événements d’un compte, exécutez la commande ALTER ACCOUNT et désactivez le paramètre EVENT_TABLE. Par exemple :

ALTER ACCOUNT UNSET EVENT_TABLE;

Vous pouvez confirmer la valeur EVENT_TABLE avec la commande SHOW PARAMETERS :

SHOW PARAMETERS LIKE 'event_table' IN ACCOUNT;

Définir la table d’événements pour une base de données¶

Pour configurer la table d’événements nommée my_events dans le schéma my_schema de la base de données my_database en tant que table d’événements active pour la base de données my_database, exécutez l’instruction suivante :

ALTER DATABASE my_database SET EVENT_TABLE = my_database.my_schema.my_events;

Pour dissocier une table d’événements d’une base de données, exécutez la commande ALTER DATABASE et désactivez le paramètre EVENT_TABLE. Par exemple :

ALTER DATABASE my_database UNSET EVENT_TABLE;

Vous pouvez confirmer la valeur EVENT_TABLE avec la commande SHOW PARAMETERS :

SHOW PARAMETERS LIKE 'event_table' IN DATABASE my_database;