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 } ]
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 mais 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;