Einstellung von E-Mail-Benachrichtigungen für den MySQL-Konnektor¶
Bemerkung
Der Snowflake Connector for MySQL unterliegt den Nutzungsbedingungen für Konnektoren.
Sie können E-Mail-Benachrichtigungen für den Konnektor aktivieren. Der Konnektor verwendet die Notification System Stored Procedure, um E-Mail-Benachrichtigungen zu versenden. Die Einstellung von E-Mail-Benachrichtigungen ist eine optionale, aber empfohlene Aktion.
Konfiguration von E-Mail-Benachrichtigungen¶
Sie können den Konnektor so konfigurieren, dass er beim Auftreten von Fehlern eine Benachrichtigung per E-Mail sendet.
Der Konnektor prüft nach einem bestimmten Zeitplan, ob neue Fehler aufgetreten sind. Ist dies der Fall, wird eine E-Mail mit der Anzahl der Fehler an die angegebenen Empfänger gesendet. E-Mail-Benachrichtigungen werden inkrementell gesendet, d. h., nur neue Fehler lösen eine Benachrichtigung aus. Aus Sicherheitsgründen enthalten die E-Mails nur Informationen über die Anzahl der Fehler (nicht die Fehler selbst).
Um E-Mail-Benachrichtigungen über Fehler zu erhalten, müssen Sie bereits eine Ereignistabelle für das Konto erstellt und eingerichtet haben (um die protokollierten Fehler zu erfassen), und in dieser Ereignistabelle muss CHANGE_TRACKING auf TRUE eingestellt sein.
Um E-Mail-Benachrichtigungen zu konfigurieren, gehen Sie wie folgt vor:
Benachrichtigungsintegration erstellen¶
Zum Versenden von E-Mail-Benachrichtigungen verwendet der Konnektor das Objekt für die Integration von Benachrichtigungen. Dabei handelt es sich um ein Snowflake-Objekt, das eine Schnittstelle zwischen Snowflake und E-Mail-Diensten bietet.
Um die Integration von Benachrichtigungen zu erstellen, führen Sie den folgenden Befehl aus:
CREATE NOTIFICATION INTEGRATION <integration_name> TYPE=EMAIL ENABLED=TRUE ALLOWED_RECIPIENTS=('first.last@example.com','first2.last2@example.com');
Wobei:
integration_name
Gibt den Namen der Integration für die Benachrichtigung an.
Der Konnektor erfordert die Berechtigung USAGE
für die Integration der Benachrichtigung, die zum Senden der E-Mail verwendet wird. Um diese Berechtigung zu erteilen, führen Sie den folgenden Befehl aus:
GRANT USAGE ON INTEGRATION <integration_name> TO APPLICATION <app_db_name>;
Wobei:
integration_name
Gibt den Namen der Integration für die Benachrichtigung an.
app_db_name
Gibt den Namen der Datenbank des Konnektors an.
Weitere Informationen zur Erstellung der Integration von Benachrichtigungen finden Sie hier.
Erstellen Sie eine Protokollansicht für den Konnektor¶
Um E-Mail-Benachrichtigungen zu konfigurieren, müssen Sie eine Protokollansicht für die Ereignistabelle erstellen, in der die protokollierten Meldungen des Konnektors gespeichert werden. Sie können die Protokollansicht in jeder Datenbank und jedem Schema erstellen, mit Ausnahme der Datenbank, die als Instanz des Konnektors dient.
Führen Sie den folgenden Befehl aus, um eine Protokollansicht der Ereignistabelle zu erstellen:
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>';
Wobei:
logs_view
Gibt den Namen der Ansicht an, die Sie erstellen möchten.
fully_qualified_event_table_name
Gibt den vollqualifizierten Namen der Ereignistabelle an.
app_db_name
Gibt den Namen der Datenbank des Konnektors an.
Der Konnektor erfordert die Berechtigung SELECT
für die Ansicht. Sie erfordert außerdem die Berechtigung USAGE
, sowohl für die Datenbank als auch für das Schema, das die Ansicht enthält. Um diese Berechtigungen zu gewähren, führen Sie die folgenden Befehle aus:
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>;
Wobei:
logs_db
Gibt den Namen der Datenbank an, die die Ansicht enthält, die Sie gerade erstellt haben.
logs_schema
Gibt den Namen des Schemas an, das die Ansicht enthält, die Sie gerade erstellt haben.
logs_view
Gibt den Namen der Ansicht an, die Sie gerade erstellt haben.
app_db_name
Gibt den Namen der Datenbank des Konnektors an.
E-Mail-Benachrichtigungen aktivieren¶
Nachdem Sie die Integration der E-Mail-Benachrichtigung und die Protokollansicht erstellt haben, führen Sie den folgenden Befehl aus, um E-Mail-Benachrichtigungen vom Konnektor zu aktivieren:
CALL PUBLIC.CONFIGURE_ALERTS('<integration_name>', '<logs_db>.<logs_schema>.<logs_view>', '<schedule>', ['<email_address_1>' [, ... '<email_address_2>']]);
Wobei:
integration_name
Gibt den Namen der Integration für die Benachrichtigung an.
logs_db
Gibt den Namen der Datenbank an, die die Ansicht enthält, die Sie im vorherigen Schritt erstellt haben.
logs_schema
Gibt den Namen des Schemas an, das die Ansicht enthält, die Sie im vorherigen Schritt erstellt haben.
logs_view
Gibt den Namen der Ansicht an, die Sie im vorherigen Schritt erstellt haben.
schedule
Legt den Zeitplan oder die Häufigkeit fest, mit der der Konnektor auf Fehler prüfen und eine Benachrichtigung senden soll. Einzelheiten zum Festlegen des Zeitplans oder der Häufigkeit finden Sie unter SCHEDULE-Parameter.
['email_address_1' [, ... 'email_address_2']]
Gibt das Array mit einer oder mehreren angegebenen E-Mail-Adressen an, die E-Mail-Benachrichtigungen vom Konnektor erhalten können. Die E-Mail-Adressen in diesem Array müssen sich in dem Parameter ALLOWED_RECIPIENTS befinden, der in der E-Mail-Benachrichtigungsintegration angegeben ist.
Um die Konfiguration einer E-Mail-Benachrichtigung zu ändern, verwenden Sie den obigen Befehl mit den überarbeiteten Parametern.
Deaktivieren von E-Mail-Benachrichtigungen¶
Um E-Mail-Benachrichtigungen zu deaktivieren, führen Sie den folgenden Befehl aus:
CALL PUBLIC.DISABLE_ALERTS();
Mit diesem Befehl werden alle E-Mail-Adressen entfernt, die bei der ersten Konfiguration hinzugefügt wurden.
Nächste Schritte¶
Führen Sie nach Beendigung dieser Prozeduren die unter Einstellung des Snowflake Connector for MySQL Agent Container beschriebenen Schritte aus.