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 predefinido. 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 cursor sobre o nome e selecione para dar à sua consulta SQL um nome significativo.

Etapa 2: Construir sua consulta

Ao construir sua consulta, você pode optar por contar com a ajuda da IA ou construí-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 construir 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 CSV, selecione Export.

Importante

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

Tempo limite de relatórios

Relatórios que levam mais de seis minutos para serem executados expirarão por tempo limite. Se essa é a primeira consulta que você está executando depois de algum tempo, o processamento pode demorar mais e, portanto, há uma probabilidade maior de expirar. Se isso acontecer, tente executar o relatório novamente.

Se o seu relatório continuar expirando 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 que descreve 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 ver a lista completa de 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. Ao exportar 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 visualiza uma prévia de 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 que você executar, 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 poderá executar consultas, mas poderá criar, editar e salvar relatórios SQL. Se quiser comprar mais créditos do Criador de consultas, entre em contato com seu gerente de conta.