Criador de consultas

Saiba como usar o Criador de consultas para gerar relatórios usando dados da Braze no Snowflake. O Criador de consultas vem com modelos de consultas de SQL pré-construídos para você começar, ou você pode escrever suas próprias consultas de SQL personalizadas para desbloquear ainda mais insights.

Pré-requisitos

Para usar o Criador de consultas, você precisará das seguintes permissões:

• Visualizar IPI: O Criador de consultas permite acesso direto a alguns dados de cliente.
• Visualizar relatórios do dashboard: Essa permissão é necessária para que usuários não administradores visualizem o Criador de consultas no dashboard.

Usando o Criador de consultas

Etapa 1: Criar uma consulta SQL

Para criar uma nova consulta, acesse Analytics > Query Builder e selecione Create SQL Query.

Se você precisar de inspiração ou ajuda para elaborar sua consulta, escolha Query Template e selecione um modelo pré-criado. Para começar com uma consulta em branco, selecione SQL Editor.

Seu relatório recebe automaticamente um nome com a data e hora atuais. Passe o mouse sobre o nome e selecione para dar um nome significativo à sua consulta SQL.

Etapa 2: Criar sua consulta

Ao criar sua consulta, você pode optar por receber ajuda da IA ou criá-la por conta própria.

• usando brazeai
• por conta própria

1
2
3

SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

1
2
3

SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Etapa 3: Gerar seu relatório

Quando terminar de criar sua consulta, selecione Run Query. Se não houver erros ou tempos limite de relatório, um arquivo CSV será gerado a partir da consulta.

Para baixar o relatório em CSV, selecione Export.

Importante

Cada relatório pode gerar resultados apenas uma vez por dia. Se você executar o mesmo relatório várias vezes em um único dia do calendário, verá os mesmos resultados em cada relatório.

Tempos limite de relatório

Relatórios que levam mais de seis minutos para ser executados sofrerão tempo limite. Se esta for a primeira consulta que você está executando em algum tempo, ela pode demorar mais para ser processada e, portanto, tem uma probabilidade maior de atingir o tempo limite. Se isso acontecer, tente executar o relatório novamente.

Se o seu relatório continuar atingindo o tempo limite após várias tentativas, entre em contato com o Suporte.

Consultando motivos de interrupção

Você pode consultar a coluna ABORT_TYPE em qualquer tabela USERS_MESSAGES_*_ABORT_SHARED para analisar por que as mensagens não foram enviadas. O campo ABORT_TYPE contém um valor da string descrevendo o motivo específico da interrupção, e o campo complementar ABORT_LOG contém detalhes adicionais (como a regra de limite de frequência que foi disparada).

Por exemplo, para contar interrupções de e-mail por tipo nos últimos 30 dias:

1
2
3
4
5

SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Para a lista completa dos valores de ABORT_TYPE e suas descrições, consulte Tipos de interrupção.

Dados e resultados

Todas as consultas exibem dados dos últimos 60 dias. Quando você exporta seus resultados, o arquivo conterá no máximo 1.000 linhas. Para relatórios que exigem volumes maiores de dados, você pode usar ferramentas como o Currents ou o endpoint de exportação da API.

Créditos do Snowflake

Cada empresa tem 5 créditos do Snowflake disponíveis por mês, compartilhados entre todos os espaços de trabalho. Uma pequena parte de um crédito do Snowflake é usada sempre que você executa uma consulta ou pré-visualiza uma tabela.

Nota

Os créditos do Snowflake não são compartilhados entre recursos. Por exemplo, os créditos das extensões de segmento SQL e do Criador de consultas são independentes entre si.

O uso de créditos está relacionado ao tempo de execução da sua consulta SQL. Quanto maior o tempo de execução, maior a parte de um crédito do Snowflake que a consulta consumirá. O tempo de execução pode variar dependendo da complexidade e do tamanho das suas consultas ao longo do tempo. Quanto mais complexas e frequentes forem as consultas executadas, maior será a alocação de recursos e mais rápido será o tempo de execução.

Os créditos não são usados ao escrever, editar ou salvar relatórios no editor SQL da Braze. Seus créditos serão redefinidos para 5 no primeiro dia de cada mês às 0h UTC. Você pode monitorar o uso mensal de créditos no topo da página do Criador de consultas.

Quando você atingir o limite de créditos, não será possível executar consultas, mas você pode criar, editar e salvar relatórios SQL. Se quiser adquirir mais créditos do Criador de consultas, entre em contato com seu gerente de conta.