Erstellen einer Benachrichtigungsintegration zum Senden von Benachrichtigungen an ein Amazon SNS-Thema¶

Erstellen eines Amazon SNS-Themas¶

Erstellen Sie ein SNS-Thema in Ihrem AWS-Konto, das die Benachrichtigung verarbeiten soll. Notieren Sie sich den Amazon Resource Name (ARN) für das SNS-Thema.

Um die Latenz zu verringern und Gebühren für ausgehende Daten für das Senden von Benachrichtigungen zwischen Regionen zu vermeiden, empfehlen wir, das SNS-Thema in derselben Region wie Ihr Snowflake-Konto zu erstellen.

Eine Anleitung dazu finden Sie in der SNS-Dokumentation unter Erstellen eines Amazon SNS-Themas.

Erstellen Sie die IAM-Richtlinie¶

Erstellen Sie eine AWS-Richtlinie für die Identitäts- und Zugriffsverwaltung (IAM), die Berechtigungen zur Veröffentlichung im SNS-Thema erteilt. In der Richtlinie sind die folgenden Aktionen definiert:

• sns:publish: Veröffentlichen im SNS-Thema.

1. Anmelden bei der AWS Management Console.

2. Wählen Sie auf dem Startseiten-Dashboard die Option Identity & Access Management (IAM) aus.

3. Wählen Sie im linken Navigationsbereich Account settings aus.

4. Erweitern Sie die Security Token Service Regions-Liste, suchen Sie die AWS-Region, die der Region entspricht, in der sich Ihr Konto befindet, und wählen Sie Activate, wenn der Status Inactive ist.

5. Wählen Sie im linken Navigationsbereich Policies aus.

6. Wählen Sie Create Policy aus.

7. Wählen Sie die Registerkarte JSON aus.

8. Fügen Sie ein Richtliniendokument hinzu, das Aktionen definiert, die für Ihr SNS-Thema ausgeführt werden können.

   Kopieren Sie den Text, und fügen Sie ihn in den Richtlinieneditor ein:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "sns:Publish"
         ],
         "Resource": "<sns_topic_arn>"
       }
     ]
   }
   

   Copy

   Ersetzen Sie sns_topic_arn durch den ARN des SNS-Themas, das Sie zuvor erstellt haben.

9. Wählen Sie Review policy aus.

10. Geben Sie den Richtliniennamen (z. B. snowflake_sns_topic) und eine optionale Beschreibung ein, und wählen Sie Create policy aus.

AWS-IAM-Rolle erstellen¶

Erstellen Sie eine AWS-IAM-Rolle, der Sie Berechtigung für das SNS-Thema zuweisen können.

1. Anmelden bei der AWS Management Console.

2. Wählen Sie auf dem Startseiten-Dashboard die Option Identity & Access Management (IAM) aus:

3. Wählen Sie im linken Navigationsbereich Roles aus.

4. Wählen Sie Create role aus.

5. Wählen Sie Another AWS account als vertrauenswürdigen Entitätstyp aus.

6. Geben Sie im Feld Account ID vorläufig Ihre eigene AWS-Konto-ID ein.

7. Wählen Sie die Option Require external ID aus. Mit dieser Option können Sie Dritten (z. B. Snowflake) Berechtigungen für die Ressourcen Ihres Amazon-Kontos (d. h. SNS) erteilen.

   Geben Sie vorläufig eine Dummy-ID ein, wie z. B. 0000. Später werden Sie die Vertrauensstellung ändern und die Dummy-ID durch die externe ID für den Snowflake-IAM-Benutzer ersetzen, der für Ihr Konto erstellt wurde. Eine Bedingung in der Vertrauensrichtlinie Ihrer IAM-Rolle ermöglicht es Ihren Snowflake-Benutzern, die Rolle mithilfe des Benachrichtigungsintegrationsobjekts zu übernehmen, das Sie später erstellen werden.

8. Wählen Sie Next aus.

9. Suchen Sie die zuvor erstellte Richtlinie, und wählen Sie diese Richtlinie aus.

10. Wählen Sie Next aus.

11. Geben Sie einen Namen und eine Beschreibung für die Rolle ein, und wählen Sie Create role aus.

12. Notieren Sie den Role ARN-Wert, der auf der Übersichtsseite der Rolle angegeben ist. Sie werden diesen Wert in einem oder mehreren späteren Schritten angeben.

Benachrichtigungsintegration erstellen¶

Führen Sie den Befehl CREATE NOTIFICATION INTEGRATION aus, um eine Benachrichtigungsintegration zu erstellen. Eine Integration ist ein Snowflake-Objekt, das auf das von Ihnen erstellte SNS-Thema verweist.

Wenn Sie den Befehl ausführen, legen Sie diese Parameter auf die folgenden Werte fest:

• Stellen Sie AWS_SNS_TOPIC_ARN auf den zuvor notierten ARN des SNS-Themas ein.

• Stellen Sie AWS_SNS_ROLE_ARN auf den zuvor notierten ARN der IAM-Rolle ein.

  Bemerkung

  Beim AWS_SNS_ROLE_ARN-Wert wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie den genauen Wert, der in Ihrem AWS-Konto angegeben ist.

Beispiel:

CREATE NOTIFICATION INTEGRATION my_notification_int
  ENABLED = TRUE
  DIRECTION = OUTBOUND
  TYPE = QUEUE
  NOTIFICATION_PROVIDER = AWS_SNS
  AWS_SNS_TOPIC_ARN = 'arn:aws:sns:us-east-2:111122223333:sns_topic'
  AWS_SNS_ROLE_ARN = 'arn:aws:iam::111122223333:role/error_sns_role';

Snowflake Zugriff auf das SNS-Thema gewähren¶