ALTER NOTIFICATION INTEGRATION¶

Sintaxe¶

Carregamentos de dados automatizadas ou atualizações de metadados

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

Onde:

cloudProviderParamsAuto (for Google Cloud Storage) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

cloudProviderParamsAuto (for Microsoft Azure Storage) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_URL>'
  AZURE_TENANT_ID = '<directory_ID>';

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

Onde:

cloudProviderParamsPush (for Amazon Simple Notification Service) ::=
  AWS_SNS_TOPIC_ARN = '<topic_arn>'
  AWS_SNS_ROLE_ARN = '<iam_role_arn>'

cloudProviderParamsPush (for Google Pub/Sub) ::=
  GCP_PUBSUB_SUBSCRIPTION_NAME = '<subscription_id>'

cloudProviderParamsPush (for Microsoft Azure Event Grid) ::=
  AZURE_STORAGE_QUEUE_PRIMARY_URI = '<queue_URL>'
  AZURE_TENANT_ID = '<directory_ID>';

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

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

Estes devem ser endereços de e-mail dos usuários na conta atual. Estes endereços de e-mail devem ser verificados.

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

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

• COMMENT

Parâmetros do provedor de nuvem para carregamentos de dados automatizados ou atualizações de metadados (cloudProviderParamsAuto)¶

Consulte descrições destes parâmetros na seção Parâmetros do provedor de nuvem para carregamentos de dados automatizados ou atualizações de metadados (cloudProviderParamsAuto) de CREATE NOTIFICATION INTEGRATION.

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.

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;