Visão geral da tabela de evento¶

Funções para acesso à tabela de evento padrão e EVENTS_VIEW¶

O Snowflake inclui as seguintes funções de aplicativo predefinidas que você pode usar para gerenciar o acesso à tabela de eventos padrão e à exibição EVENTS_VIEW: uma pessoa com a função ACCOUNTADMIN pode acessar a tabela de eventos padrão e a exibição EVENTS_VIEW e pode conceder as funções descritas aqui a outras funções para acesso a elas.

Você deve conceder essas funções a outras funções, e não a um usuário. Por exemplo, você pode conceder a função EVENTS_ADMIN a outra função de administrador que tenha criado para uso administrativo mais amplo.

GRANT APPLICATION ROLE SNOWFLAKE.EVENTS_ADMIN TO ROLE my_admin_role

GRANT APPLICATION ROLE SNOWFLAKE.EVENTS_VIEWER TO ROLE my_analysis_role

EVENTS_VIEWER:

Função com privilégios para executar uma instrução SELECT na exibição EVENTS_VIEW.

EVENTS_ADMIN:

Função com os seguintes privilégios:

• SELECT, TRUNCATE e DELETE na tabela de evento padrão.

• SELECT na exibição EVENTS_VIEW da tabela de evento padrão.

• USAGE nos seguintes procedimentos armazenados:

  • ADD_ROW_ACCESS_POLICY_ON_EVENTS_VIEW

  • DROP_ROW_ACCESS_POLICY_ON_EVENTS_VIEW

• Esta função também tem privilégios para executar um procedimento armazenado para aplicar uma política de acesso a linhas (RAP) na exibição EVENTS_VIEW cujos dados são baseados na tabela de evento padrão.

Gerenciar o acesso à exibição EVENTS_VIEW¶

É possível gerenciar o acesso aos dados na exibição EVENTS_VIEW com políticas de acesso a linhas. O Snowflake fornece procedimentos armazenados que você pode usar para adicionar e remover uma política de acesso a linhas à exibição EVENT_VIEW.

• ADD_ROW_ACCESS_POLICY_ON_EVENTS_VIEW(VARCHAR, ARRAY)—Vincula uma política de acesso a linhas às colunas especificadas no EVENTS_VIEW.

• DROP_ROW_ACCESS_POLICY_ON_EVENTS_VIEW(VARCHAR)—Exclui a política de acesso a linhas especificada vinculada ao EVENTS_VIEW.

Criação de uma tabela de eventos¶

Para criar uma tabela de eventos, execute o comando CREATE EVENT TABLE.

Ao criar uma tabela de eventos, você não especifica as colunas da tabela. Uma tabela de eventos já tem um conjunto de colunas predefinidas, conforme descrito em Colunas da tabela de eventos.

1. Certifique-se de que você esteja usando uma função que tenha o privilégio CREATE EVENT TABLE.

2. Execute o comando CREATE EVENT TABLE para criar a tabela de eventos, especificando um nome para a tabela de eventos.

   Você usa o nome da tabela de eventos para associar a tabela a um objeto, como um banco de dados.

   Por exemplo, para criar uma tabela de eventos com o nome my_events, execute a seguinte instrução:

   CREATE EVENT TABLE my_database.my_schema.my_events;
   

   Copy

Associar uma tabela de eventos a um objeto¶

Para especificar o objeto para o qual uma tabela de eventos está ativa, execute o comando ALTER <objeto> no objeto.

A associação de uma tabela de eventos a um banco de dados é um recurso do Enterprise Edition.

1. Certifique-se de que você esteja usando uma função que tenha os privilégios necessários.

2. Execute o comando ALTER <objeto> no objeto, definindo o parâmetro EVENT_TABLE para o nome de sua tabela de eventos.

   A definição desse parâmetro define o objeto como o escopo dentro do qual os eventos serão coletados na tabela de eventos especificada.

   Por exemplo, para associar a tabela de eventos a um banco de dados, use ALTER DATABASE, como no exemplo a seguir:

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

   Copy

   Neste exemplo, o Snowflake, dependendo de como você especificou os níveis de telemetria, captura dados de telemetria para procedimentos e UDFs em my_database na tabela de eventos telemetry_database.telemetry_schema.my_events.

Definir a tabela de eventos para a conta¶

Por exemplo, para configurar a tabela de eventos denominada my_events no esquema my_schema no banco de dados my_database como a tabela de eventos ativa de sua conta, execute a seguinte instrução:

ALTER ACCOUNT SET EVENT_TABLE = my_database.my_schema.my_events;

Como mostrado acima, você deve especificar o nome totalmente qualificado da tabela de eventos.

Para desassociar uma tabela de eventos de uma conta, execute o comando ALTER ACCOUNT e desmarque o parâmetro EVENT_TABLE. Por exemplo:

ALTER ACCOUNT UNSET EVENT_TABLE;

Você pode confirmar o valor EVENT_TABLE com o comando SHOW PARAMETERS:

SHOW PARAMETERS LIKE 'event_table' IN ACCOUNT;

Definir a tabela de eventos para um banco de dados¶

Para configurar a tabela de eventos chamada my_events no esquema my_schema no banco de dados my_database como a tabela de eventos ativa para o banco de dados my_database, execute a seguinte instrução:

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

Para desassociar uma tabela de eventos de um banco de dados, execute o comando ALTER DATABASE e desmarque o parâmetro EVENT_TABLE. Por exemplo:

ALTER DATABASE my_database UNSET EVENT_TABLE;

Você pode confirmar o valor EVENT_TABLE com o comando SHOW PARAMETERS:

SHOW PARAMETERS LIKE 'event_table' IN DATABASE my_database;