Skip to content

Construtor 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" e "SQL Editor" encontradas no menu suspenso "Create SQL Query".

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 com o nome "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 IA SQL.

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.

#### How is my data used and sent to OpenAI? {#ai-policy}

In order to generate AI output through Braze AI features that Braze identifies as leveraging OpenAI (“Output”), Braze will send your prompt, such as message content, brand guidelines, past campaign data, or any other input, as applicable (“Input”) to OpenAI. Input sent to OpenAI from Braze does not identify you or your Users unless you choose to include uniquely identifiable information in your Input. Per OpenAI’s API platform commitments, data sent to OpenAI’s API via Braze is not used to train or improve OpenAI models and will be deleted after 30 days by OpenAI from their systems. Between you and Braze, Output is your intellectual property. Braze will not assert any claims of copyright ownership on such Output. Braze makes no warranty of any kind with respect to any AI-generated content generally, including Output.

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, será gerado um arquivo CSV a partir da consulta.

Para baixar o relatório CSV, selecione Exportar.

O Criador de consultas mostra os resultados da consulta modelo "Engajamento e receita do canal nos últimos 30 dias".

Relatar tempos limite

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.

Construtor de consultas que 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.
Github   Editar esta página no GitHub
New Stuff!