Criar consultas no 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ê precisa das seguintes permissões no nível do espaço de trabalho:

Usando o Criador de consultas

Etapa 1: Criar uma consulta SQL

Para criar uma nova consulta, acesse Analytics > Criador de consultas e selecione Criar consulta SQL.

Se você precisar de inspiração ou de ajuda para criar sua consulta, escolha Modelo de consulta e selecione um modelo pronto. Para começar com uma consulta em branco, selecione Editor SQL.

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

Etapa 2: Criar sua consulta

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

• usando o operator
• por conta própria

Nota

Esse recurso agora faz parte do BrazeAI Operator™, o assistente de IA unificado da Braze. Os recursos de IA que antes estavam disponíveis como assistentes independentes agora podem ser acessados pelo Operator de qualquer lugar em que você já esteja trabalhando no dashboard.

No painel lateral do Criador de consultas, selecione Perguntar ao Operator e descreva os dados que você quer. O Operator escreve o SQL com base nas tabelas de dados do Snowflake disponíveis. Assim, você pode revisar o SQL e fazer uma prévia dos resultados antes de executar seu relatório. Para usar o Operator no Criador de consultas, você precisa da permissão “Edit Dashboard Reports”.

O SQL gerado deve seguir as mesmas regras de escrita de SQL das consultas que você escreve. Para saber mais, consulte O que você pode fazer com o Operator. Para entender como o Operator lida com seus dados, consulte Privacidade e segurança de dados do Operator.

Escreva sua consulta SQL usando a sintaxe do Snowflake. Consulte a referência de tabelas para ver a lista completa de tabelas e colunas disponíveis para consulta.

Para visualizar os detalhes das tabelas no Criador de consultas:

1. Na página Criador de consultas, abra o painel Referência e selecione Tabelas de dados disponíveis para ver as tabelas de dados disponíveis e seus nomes.
2. Selecione Ver detalhes para ver a descrição da tabela e informações sobre as colunas, como os tipos de dados.
3. Para inserir o nome da tabela no seu SQL, selecione .

Restringir sua consulta a um período específico ajuda a gerar resultados mais rápido. Veja a seguir um exemplo de consulta que obtém o número de compras e a receita gerada na última hora.

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()));

Esta consulta obtém o número de envios de e-mail no último mês:

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()));

Se você consultar CANVAS_ID, CANVAS_VARIATION_API_ID ou CAMPAIGN_ID, as colunas de nome associadas serão incluídas automaticamente na tabela de resultados. Não é preciso incluí-las na própria consulta SELECT.

Nome do ID	Coluna de nome associada
CANVAS_ID	Nome do Canvas
CANVAS_VARIATION_API_ID	Nome da variante do Canvas
CAMPAIGN_ID	Nome da Campaign

Esta consulta obtém os três IDs e suas colunas de nome associadas, com no máximo 100 linhas:

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Solução de problemas

Sua consulta pode falhar por qualquer um dos seguintes motivos:

• Erros de sintaxe na sua consulta SQL
• Tempo limite de processamento (após 6 minutos)
  • Relatórios que levam mais de 6 minutos para serem executados atingem o tempo limite.
  • Se um relatório atingir o tempo limite, tente limitar o intervalo de tempo dos dados consultados ou consultar um conjunto de dados mais específico.

Etapa 3: Gerar seu relatório

Quando terminar de criar sua consulta, selecione Executar consulta. Se não houver erros nem tempo limite do relatório atingido, um arquivo CSV será gerado a partir da consulta.

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

Importante

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

Tempo limite dos relatórios

Os relatórios que levarem mais de seis minutos para serem executados atingirão o tempo limite. Se esta for a primeira consulta que você executa depois de algum tempo, o processamento pode demorar mais e, portanto, há 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.

Consultar 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 de string que descreve o motivo específico da interrupção. Já o campo complementar ABORT_LOG traz detalhes adicionais, como a regra de limite de frequência que foi disparada.

Por exemplo, para contar as 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. Quando você exportar os resultados, a exportação terá 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 da API de exportação.

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 faz a 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 vai custar. O tempo de execução pode variar ao longo do tempo, dependendo da complexidade e do tamanho das suas consultas. Quanto mais consultas complexas e frequentes você executar, maior será a sua alocação de recursos e mais rápido ficará 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 voltam a 5 no primeiro dia de cada mês, à meia-noite (UTC). Você pode monitorar o uso mensal de créditos na parte superior da página do Criador de consultas.

Ao atingir o limite de créditos, você não poderá executar consultas, mas ainda 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.