Skip to content

Criador de consultas

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

Pré-requisitos

Você precisará de permissões “View IPI” para usar o Query Builder, pois ele permite acesso direto a alguns dados de clientes.

Uso do Query Builder

Etapa 1: Criar uma consulta de SQL

Para criar uma nova consulta, acesse Análise de dados > Query Builder e selecione Criar consulta de SQL.

As opções "Query Template" (Modelo de consulta) e "SQL Editor" (Editor de SQL) encontram-se no menu suspenso "Create SQL Query" (Criar consulta SQL).

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

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 de SQL um nome significativo.

Um exemplo de relatório chamado "Engajamento de canal para maio de 2025".

Etapa 2: Crie sua consulta

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

O Criador de consultas com IA usa o GPT, desenvolvido pela OpenAI, para recomendar SQL para sua consulta. Para gerar SQL com o Criador de consultas com IA:

  1. Depois de criar um relatório no Criador de consultas, selecione a guia Criador de consultas com IA.
  2. Digite seu prompt ou selecione um prompt de amostra e selecione Gerar para traduzir seu prompt para SQL.
  3. Revise o SQL gerado para ter certeza de que está correto e, em seguida, selecione Insert into Editor (Inserir no editor).

O construtor de consultas de SQL IA.

Dicas

  • Familiarize-se com as tabelas de dados disponíveis do Snowflake. A solicitação de dados que não existem nessas tabelas pode fazer com que o ChatGPT crie uma tabela falsa.
  • Familiarize-se com as regras de escrita SQL para esse recurso. O não cumprimento dessas regras causará um erro.
  • Você pode enviar até 20 prompts por minuto com o Criador de consultas com IA.

#### Como meus dados são usados e enviados para a OpenAI? {#ai-policy}

Para gerar a saída de IA por meio dos recursos de IA da Braze que a Braze identifica como alavancando a OpenAI (“Saída”), a Braze enviará seu prompt, como conteúdo de mensagens, diretrizes da marca, dados de campanhas anteriores ou qualquer outra entrada, conforme aplicável (“Entrada”) para a OpenAI. Os dados enviados para a OpenAI pelo Braze não identificam você ou seus Usuários, a menos que você opte por incluir informações exclusivamente identificáveis em seus dados. De acordo com os compromissos da plataforma API da OpenAI, os dados enviados à API da OpenAI via Braze não são usados para treinar ou aprimorar os modelos da OpenAI e serão excluídos após 30 dias pela OpenAI de seus sistemas. Entre você e a Braze, a saída é sua propriedade intelectual. A Braze não fará nenhuma reivindicação de propriedade de direitos autorais sobre tais Produtos. A Braze não oferece nenhuma garantia de qualquer tipo com relação a qualquer conteúdo gerado por IA em geral, incluindo o Resultado.

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

Para visualizar os detalhes da tabela no Query Builder:

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

Restringir sua consulta a um período de tempo específico o ajudará a gerar resultados mais rapidamente. 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()));

Essa consulta recupera 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, suas colunas de nome associadas serão automaticamente incluídas na tabela de resultados. Não é necessário incluí-los na própria consulta SELECT.

Nome do ID Coluna de nome associado
CANVAS_ID Nome do canva
CANVAS_VARIATION_API_ID Nome da variante da tela
CAMPAIGN_ID Nome da campanha

Essa consulta recupera todos os três IDs e suas colunas de nome associadas com um máximo de 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 em sua consulta de SQL
  • Tempo limite de processamento (após 6 minutos)
    • Os relatórios que demorarem mais de 6 minutos para serem executados serão encerrados.
    • Se um relatório não atingir o tempo limite, tente limitar o intervalo de tempo em que está consultando os dados ou consulte um conjunto de dados mais específico.

Etapa 3: Gerar seu relatório

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

Para baixar o relatório CSV, selecione Exportar.

O Query Builder mostra os resultados da consulta modelada "Engajamento do canal e receita nos últimos 30 dias".

Relatar timeouts

Os relatórios que demorarem mais de seis minutos para serem executados serão encerrados. Se esta for a primeira consulta que você está executando em algum tempo, ela poderá levar mais tempo para ser processada e, portanto, terá uma probabilidade maior de atingir o tempo limite. Se isso acontecer, tente executar o relatório novamente.

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

Dados e resultados

Todas as consultas apresentam dados dos últimos 60 dias. Quando você exportar seus resultados, eles conterão apenas até 1.000 linhas. Para relatórios que exigem grandes quantidades de dados, você pode usar ferramentas como o Currents ou o endpoint da API de exportação.

Créditos para Snowflake

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

O uso de crédito está correlacionado ao tempo de execução de sua consulta de SQL. Quanto maior for o tempo de execução, maior será a porção de crédito do Snowflake que uma consulta custará. O tempo de execução pode variar de acordo com a complexidade e o tamanho de 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 Braze SQL. Seus créditos serão redefinidos para 5 no primeiro dia de cada mês, às 12 horas UTC. Você pode monitorar o uso de seu crédito mensal na parte superior da página do Criador de consultas.

O Construtor de consultas mostra a quantidade de créditos usados no mês atual.

Quando você atinge o limite de crédito, não pode executar consultas, mas pode criar, editar e salvar relatórios de SQL. Se quiser comprar mais créditos do Criador de consultas, entre em contato com o gerente da sua conta.

New Stuff!