SHOW NOTIFICATION INTEGRATIONS

Lista as integrações de notificação em sua conta.

A saída inclui metadados e propriedades de cada integração de notificação.

Consulte também:

CREATE NOTIFICATION INTEGRATION , ALTER NOTIFICATION INTEGRATION , DESCRIBE NOTIFICATION INTEGRATION, DROP INTEGRATION

Sintaxe

SHOW NOTIFICATION INTEGRATIONS [ LIKE '<pattern>' ]
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

Saída

A saída do comando inclui as seguintes colunas, que descrevem as propriedades e metadados do objeto:

Coluna

Descrição

name

Nome da integração da notificação.

type

Tipo de integração da notificação. O valor pode ser um dos seguintes:

category

Categoria da integração. Para integrações de notificação, isso é sempre NOTIFICATION.

enabled

Indica se a integração de notificação está ativada ou não:

  • Se true, a integração de notificação será ativada.

  • Se false, a integração de notificações será desativada.

comment

Comentário sobre a integração da notificação.

created_on

Data e hora em que a integração da notificação foi criada.

direction

Indica se a integração oferece suporte ao envio ou o recebimento de notificações. O valor pode ser um dos seguintes:

  • OUTBOUND: o Snowflake usa a integração para enviar notificações a um serviço de mensagens de terceiros.

    Esse valor aparece para integrações de notificação com qualquer uma das seguintes propriedades:

    • TYPE=QUEUE e DIRECTION=OUTBOUND

    • TYPE=EMAIL

    • TYPE=WEBHOOK

  • INBOUND: o Snowflake usa a integração para receber notificações de um serviço de mensagens de terceiros.

    Esse valor aparece para integrações de notificação que não especificam DIRECTION=OUTBOUND.

Requisitos de controle de acesso

Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:

Privilégio

Objeto

Notas

USAGE

Integração

OWNERSHIP

Integração

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

Exemplos

Mostrar todas as integrações de notificação:

SHOW NOTIFICATION INTEGRATIONS;
Copy
+-----------------------------+-----------------------------+--------------+---------+---------+-------------------------------+-----------+
| name                        | type                        | category     | enabled | comment | created_on                    | direction |
|-----------------------------+-----------------------------+--------------+---------+---------+-------------------------------+-----------|
| MY_AZURE_INBOUND_QUEUE_INT  | QUEUE - AZURE_STORAGE_QUEUE | NOTIFICATION | true    | NULL    | 2025-03-08 11:34:55.861 -0800 | INBOUND   |
| MY_GCP_INBOUND_QUEUE_INT    | QUEUE - GCP_PUBSUB          | NOTIFICATION | true    | NULL    | 2025-03-08 11:35:35.163 -0800 | INBOUND   |
| MY_GCP_OUTBOUND_QUEUE_INT   | QUEUE - GCP_PUBSUB          | NOTIFICATION | true    | NULL    | 2025-03-08 11:37:06.487 -0800 | OUTBOUND  |
| MY_AWS_OUTBOUND_QUEUE_INT   | QUEUE - AWS_SNS             | NOTIFICATION | true    | NULL    | 2025-03-08 11:36:13.072 -0800 | OUTBOUND  |
| MY_EMAIL_INT                | EMAIL                       | NOTIFICATION | true    | NULL    | 2025-03-08 11:38:55.866 -0800 | OUTBOUND  |
| MY_AZURE_OUTBOUND_QUEUE_INT | QUEUE - AZURE_EVENT_GRID    | NOTIFICATION | true    | NULL    | 2025-03-08 11:36:40.822 -0800 | OUTBOUND  |
| MY_WEBHOOK_INT              | WEBHOOK                     | NOTIFICATION | true    | NULL    | 2025-03-08 11:40:17.336 -0800 | OUTBOUND  |
+-----------------------------+-----------------------------+--------------+---------+---------+-------------------------------+-----------+
Linguagem: Português