为 MySQL 连接器设置电子邮件通知¶
备注
使用 Snowflake Connector for MySQL 需遵守 Connector 条款。
您可以为连接器启用电子邮件通知。连接器使用 通知系统存储过程 发送电子邮件通知。设置电子邮件通知是一项可选但建议执行的操作。
配置电子邮件通知¶
您可以配置连接器,以便在出现错误时发送电子邮件通知。
按照给定的计划,连接器会检查是否出现了新的错误。如果出现了新的错误,则会向指定收件人发送一封包含错误数量的电子邮件。电子邮件通知是以增量方式发送的,这意味着只有新的错误才会触发通知。出于安全原因,电子邮件仅包含有关错误数量的信息(而不是错误本身)。
要接收有关错误的电子邮件通知,您必须已经为账户创建并设置了事件表(以捕获记录的错误),并且该事件表必须将 CHANGE_TRACKING 设置为 TRUE。
要配置电子邮件通知,请执行以下操作:
创建通知集成¶
为了发送电子邮件通知,连接器会使用通知集成对象,这是一个 Snowflake 对象,它在 Snowflake 和电子邮件服务之间提供接口。
要创建通知集成,请运行以下命令:
CREATE NOTIFICATION INTEGRATION <integration_name> TYPE=EMAIL ENABLED=TRUE ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
其中:
integration_name
指定通知集成的名称。
连接器需要对用于发送电子邮件的通知集成具有 USAGE
权限。要授予此权限,请运行以下命令:
GRANT USAGE ON INTEGRATION <integration_name> TO APPLICATION <app_db_name>;
其中:
integration_name
指定通知集成的名称。
app_db_name
指定连接器数据库的名称。
有关创建通知集成的更多信息,请点击 此处。
为连接器创建日志视图¶
要配置电子邮件通知,您必须为存储来自连接器的记录消息的事件表创建日志视图。您可以在任何数据库和架构中创建日志视图,但作为连接器实例的数据库除外。
运行以下命令以在事件表上创建日志视图:
CREATE SECURE VIEW <logs_view> CHANGE_TRACKING = TRUE AS SELECT * FROM <fully_qualified_event_table_name> WHERE RECORD_TYPE = 'LOG' AND RESOURCE_ATTRIBUTES:"snow.database.name" = '<app_db_name>';
其中:
logs_view
指定要创建的视图的名称。
fully_qualified_event_table_name
指定事件表的完全限定名称。
app_db_name
指定连接器数据库的名称。
连接器需要对视图具有 SELECT
权限。它还需要对数据库和包含视图的架构具有 USAGE
权限。要授予这些权限,请运行以下命令:
GRANT USAGE ON DATABASE <logs_db> TO APPLICATION <app_db_name>; GRANT USAGE ON SCHEMA <logs_db>.<logs_schema> TO APPLICATION <app_db_name>; GRANT SELECT ON VIEW <logs_db>.<logs_schema>.<logs_view> TO APPLICATION <app_db_name>;
其中:
logs_db
指定包含刚刚创建的视图的数据库的名称。
logs_schema
指定包含刚刚创建的视图的架构的名称。
logs_view
指定刚刚创建的视图的名称。
app_db_name
指定连接器数据库的名称。
启用电子邮件通知¶
创建电子邮件通知集成和日志视图后,运行以下命令以从连接器启用电子邮件通知:
CALL PUBLIC.CONFIGURE_ALERTS('<integration_name>', '<logs_db>.<logs_schema>.<logs_view>', '<schedule>', ['<email_address_1>' [, ... '<email_address_2>']]);
其中:
integration_name
指定通知集成的名称。
logs_db
指定包含您在上一步中创建的视图的数据库的名称。
logs_schema
指定包含您在上一步中创建的视图的架构的名称。
logs_view
指定您在上一步中创建的视图的名称。
schedule
指定连接器检查错误并发送通知的计划或频率。有关指定计划或频率的详细信息,请参阅 SCHEDULE 参数。
['email_address_1' [, ... 'email_address_2']]
指定可以从连接器接收电子邮件通知的一个或多个带引号的电子邮件地址的数组。此数组中的电子邮件地址必须位于在 电子邮件通知集成 中指定的 ALLOWED_RECIPIENTS 参数中。
要更改电子邮件通知的配置,请使用提供修改后参数的上述命令。
禁用电子邮件通知¶
要禁用电子邮件通知,请运行以下命令:
CALL PUBLIC.DISABLE_ALERTS();
此命令将移除初始配置期间添加的所有电子邮件地址。
后续步骤¶
完成以上过程后,请按照 设置 Snowflake Connector for MySQL 代理容器 中的步骤操作。