ALTER NOTIFICATION INTEGRATION (e-mail)

Modifica as propriedades de uma integração de notificação existente para envio de mensagens de e-mail.

Consulte também:

CREATE NOTIFICATION INTEGRATION (e-mail), DESCRIBE INTEGRATION, DROP INTEGRATION, SHOW INTEGRATIONS

Sintaxe

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  [ ALLOWED_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_RECIPIENTS = ( '<email_address>' [ , ... '<email_address>' ] ) ]
  [ DEFAULT_SUBJECT = '<subject_line>' ]
  [ COMMENT = '<string_literal>' ]

ALTER [ NOTIFICATION ] INTEGRATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER [ NOTIFICATION ] INTEGRATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET
  ENABLED            |
  ALLOWED_RECIPIENTS |
  DEFAULT_RECIPIENTS |
  DEFAULT_SUBJECT    |
  COMMENT
Copy

Parâmetros

name

Especifica o identificador para a integração a ser alterada.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

SET ...

Especifica uma ou mais propriedades/parâmetros a serem definidos para a integração (separados por espaços em branco, vírgulas ou novas linhas):

ENABLED = { TRUE | FALSE }

Especifica se deve iniciar a operação da integração ou suspendê-la.

  • TRUE permite a integração.

  • FALSE desabilita a integração para manutenção. Qualquer integração entre o Snowflake e um serviço de terceiro não funciona.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

ALLOWED_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )

(Para TYPE = EMAIL) Uma lista separada por vírgula de endereços de e-mail entre aspas que podem receber e-mails de notificação a partir desta integração.

Você deve especificar os endereços de e-mail dos usuários na conta atual. Estes usuários devem verificar seus endereços de e-mail.

O número máximo de endereços de e-mail que você pode especificar é 50.

Se você omitir esse parâmetro, poderá enviar notificações por e-mail para qualquer endereço de e-mail verificado na conta atual.

DEFAULT_RECIPIENTS = ( 'email_address' [ , ... 'email_address' ] )

Especifica a lista de destinatários padrão para mensagens enviadas com esta integração. Use uma lista separada por vírgulas de endereços de e-mail entre aspas para especificar os destinatários padrão.

Você deve especificar os endereços de e-mail dos usuários na conta atual. Estes usuários devem verificar seus endereços de e-mail.

Para substituir os destinatários padrão de uma determinada mensagem, use a função auxiliar EMAIL_INTEGRATION_CONFIG ao chamar o procedimento armazenado SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

DEFAULT_SUBJECT = 'subject_line'

Especifica a linha de assunto padrão para mensagens enviadas com esta integração.

O assunto não pode exceder 256 caracteres.

Padrão: “Notificação por e-mail do Snowflake”

Para substituir a linha de assunto padrão de uma determinada mensagem, use a função auxiliar EMAIL_INTEGRATION_CONFIG ao chamar o procedimento armazenado SYSTEM$SEND_SNOWFLAKE_NOTIFICATION.

COMMENT = 'string_literal'

Cadeia de caracteres (literal) que especifica um comentário da integração.

Padrão: sem valor

UNSET ...

Especifica um ou mais parâmetros/propriedades a serem desativados para a integração, o que os restaura aos seus padrões:

  • ENABLED

  • ALLOWED_RECIPIENTS

  • DEFAULT_RECIPIENTS

  • DEFAULT_SUBJECT

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Notas de uso

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.