ALTER NOTIFICATION INTEGRATION

Modifica as propriedades para uma integração de notificação existente.

Consulte também:

CREATE NOTIFICATION INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS

Sintaxe

Carregamentos de dados automatizadas ou atualizações de metadados

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]
Copy

Notificações por push

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  cloudProviderParamsPush
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]
Copy
Onde:
cloudProviderParamsPush (for Amazon Simple Notification Service) ::=
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'
Copy
cloudProviderParamsPush (for Google Pub/Sub) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'
Copy
cloudProviderParamsPush (for Microsoft Azure Event Grid) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_URL>'
  AZURE_TENANT_ID = '<directory_ID>';
Copy

Notificações por e-mail

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> SET
  [ ENABLED = { TRUE | FALSE } ]
  [ ALLOWED_RECIPIENTS = ( '<email_address_1>' [ , ... '<email_address_N>' ] ) ]
  [ TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] ]
  [ COMMENT = '<string_literal>' ]

ALTER [ NOTIFICATION ] INTEGRATION [ IF EXISTS ] <name> UNSET {
  ALLOWED_RECIPIENTS |
  COMMENT
}
Copy

Parâmetros

name

Identificador da 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.

SET ...

Especifica uma ou mais propriedades/parâmetros a serem definidos para a tabela (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: suspende 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_1' [, ... 'email_address_N'])

(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.

COMMENT = 'string_literal'

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

UNSET ...

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

  • ENABLED

  • TAG tag_name [ , tag_name ... ]

  • ALLOWED_RECIPIENTS

  • COMMENT

Parâmetros do provedor de nuvem para notificações por push (cloudProviderParamsPush)

Consulte descrições destes parâmetros na seção Parâmetros do provedor de nuvem para notificações por push (cloudProviderParamsPush) de CREATE NOTIFICATION INTEGRATION.

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.

  • Desabilitar ou descartar as integrações pode não ter efeito imediato, pois as integrações podem ser armazenadas em cache. Recomenda-se remover o privilégio de integração do provedor de nuvem para que entre em vigor mais cedo.

Exemplos

O exemplo a seguir inicia a operação de uma integração suspensa:

ALTER NOTIFICATION INTEGRATION myint SET ENABLED = TRUE;

ALTER NOTIFICATION INTEGRATION myint UNSET COMMENT;
Copy