Criação de uma integração de notificação para enviar notificações para tópico do Amazon SNS¶

Criar um tópico do Amazon SNS¶

Crie um tópico do SNS em sua conta AWS para gerenciar as notificações. Registre o Amazon Resource Name (ARN) para o tópico SNS.

Para reduzir a latência e evitar cobranças de saída de dados pelo envio de notificações entre regiões, recomendamos criar o tópico SNS na mesma região que sua conta Snowflake.

Para instruções, consulte o tópico Criar um tópico do Amazon SNS na documentação do SNS.

Criar a política IAM¶

Crie uma política do AWS Identity and Access Management (IAM) que concede permissões para publicar no tópico SNS. A política define as seguintes ações:

• sns:publish: Publique no tópico do SNS.

1. Faça login no Console de gerenciamento AWS.

2. No painel inicial, escolha Identity & Access Management (IAM).

3. Escolha Account settings no painel de navegação à esquerda.

4. Expanda a lista Security Token Service Regions, encontre a região AWS correspondente à região onde sua conta está localizada e escolha Activate se o status for Inactive.

5. Escolha Policies no painel de navegação à esquerda.

6. Selecione Create Policy.

7. Selecione a guia JSON.

8. Adicione um documento de política que defina as ações que podem ser tomadas sobre seu tópico SNS.

   Copie e cole o texto a seguir no editor de políticas:

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

   Copy

   Substitua sns_topic_arn pelo ARN do tópico do SNS que você criou anteriormente.

9. Selecione Review policy.

10. Insira o nome da política (por exemplo, snowflake_sns_topic) e uma descrição opcional, e selecione Create policy.

Criar a função AWS IAM¶

Crie uma função AWS IAM na qual atribuir privilégios sobre o tópico SNS.

1. Faça login no Console de gerenciamento AWS.

2. No painel inicial, escolha Identity & Access Management (IAM):

3. Escolha Roles no painel de navegação à esquerda.

4. Selecione Create role.

5. Selecione Another AWS account como o tipo de entidade confiável.

6. No campo Account ID, digite temporariamente sua própria ID de conta AWS.

7. Selecione a opção Require external ID. Esta opção permite que você conceda permissões sobre os recursos de sua conta Amazon (ou seja, SNS) a um terceiro (ou seja, Snowflake).

   Por enquanto, insira uma ID fictícia, como 0000. Mais tarde, você modificará a relação de confiança e substituirá a ID fictícia pela ID externa para o IAM do Snowflake gerado pelo usuário para sua conta. Uma condição na política de confiança para sua função IAM permite que seus usuários do Snowflake assumam a função usando o objeto de integração de notificação que você criará mais tarde.

8. Selecione Next.

9. Localize a política que você criou anteriormente e selecione esta política.

10. Selecione Next.

11. Digite um nome e descrição para a função e selecione Create role.

12. Registre o valor Role ARN localizado na página de resumo de funções. Você especificará esse valor em uma ou mais etapas posteriores.

Criação da integração de notificação¶

Execute o comando CREATE NOTIFICATION INTEGRATION para criar uma integração de notificação. Uma integração é um objeto Snowflake que faz referência ao tópico SNS que você criou.

Ao executar o comando, defina esses parâmetros com os seguintes valores:

• Defina AWS_SNS_TOPIC_ARN como o ARN do tópico do SNS que você registrou anteriormente.

• Defina AWS_SNS_ROLE_ARN como o ARN da função IAM que você registrou anteriormente.

  Nota

  O valor de AWS_SNS_ROLE_ARN diferencia maiúsculas de minúsculas. Utilize o valor exato especificado em sua conta AWS.

Por exemplo:

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';

Concessão de acesso Snowflake ao tópico SNS¶