Crear consultas en el Generador de consultas

Aprende a utilizar el Generador de consultas, para que puedas generar informes utilizando datos de Braze en Snowflake. El Generador de consultas incluye plantillas de consultas SQL predefinidas para empezar, o puedes escribir tus propias consultas SQL personalizadas para obtener aún más información.

Requisitos previos

Para usar el Generador de consultas, necesitas estos permisos a nivel de espacio de trabajo:

Uso del Generador de consultas

Paso 1: Crea una consulta SQL

Para crear una nueva consulta, ve a Análisis > Generador de consultas y selecciona Crear consulta SQL.

Si necesitas inspiración o ayuda para redactar tu consulta, elige Plantilla de consulta y selecciona una plantilla prediseñada. Para empezar con una consulta en blanco, selecciona Editor SQL.

Tu informe recibe automáticamente un nombre con la fecha y hora actuales. Pasa el cursor por encima del nombre y selecciona para darle a tu consulta SQL un nombre significativo.

Paso 2: Crea tu consulta

Al crear tu consulta, puedes elegir que te ayude la IA o crearla por tu cuenta.

• uso de operator
• por tu cuenta

Nota

Esta característica ahora forma parte de BrazeAI Operator™, el asistente de IA unificado de Braze. Las capacidades de IA que antes estaban disponibles como asistentes independientes ahora son accesibles a través de Operator desde cualquier lugar en el que ya estés trabajando en el panel.

En el panel lateral del Generador de consultas, selecciona Preguntar a Operator y describe los datos que quieres obtener. Operator escribe SQL sobre las tablas de datos de Snowflake disponibles, y puedes revisar el SQL y obtener una vista previa de los resultados antes de ejecutar tu informe. Para usar Operator en el Generador de consultas, necesitas el permiso “Editar informes del panel”.

El SQL generado debe seguir las mismas reglas de escritura de SQL que las consultas que escribes tú mismo. Para más información, consulta Qué puedes hacer con Operator. Para saber cómo gestiona Operator tus datos, consulta Privacidad y seguridad de los datos en Operator.

Escribe tu consulta SQL utilizando la sintaxis de Snowflake. Consulta la referencia de tablas para ver una lista completa de las tablas y columnas que puedes consultar.

Para ver los detalles de las tablas en el Generador de consultas:

1. En la página Generador de consultas, abre el panel Referencia y selecciona Tablas de datos disponibles para ver las tablas de datos disponibles y sus nombres.
2. Selecciona Ver detalles para ver la descripción de la tabla e información sobre sus columnas, como los tipos de datos.
3. Para insertar el nombre de la tabla en tu SQL, selecciona .

Limitar tu consulta a un periodo de tiempo concreto te ayudará a generar resultados más rápido. A continuación se muestra un ejemplo de consulta que obtiene el número de compras y los ingresos generados en la ú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 obtiene el número de envíos de correo electrónico del último mes:

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

Si consultas CANVAS_ID, CANVAS_VARIATION_API_ID o CAMPAIGN_ID, sus columnas de nombre asociadas se incluirán automáticamente en la tabla de resultados. No necesitas incluirlas en la propia consulta SELECT.

Nombre del ID	Columna de nombre asociada
CANVAS_ID	Nombre del Canvas
CANVAS_VARIATION_API_ID	Nombre de la variante en Canvas
CAMPAIGN_ID	Nombre de la Campaign

Esta consulta obtiene los tres ID y sus columnas de nombre asociadas con un máximo de 100 filas:

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Solución de problemas

Tu consulta puede fallar por cualquiera de los siguientes motivos:

• Errores de sintaxis en tu consulta SQL
• Tiempo de espera de procesamiento agotado (después de 6 minutos)
  • Los informes que tarden más de 6 minutos en ejecutarse agotarán el tiempo de espera.
  • Si un informe agota el tiempo de espera, intenta limitar el intervalo de tiempo en el que consultas los datos o consulta un conjunto de datos más específico.

Paso 3: Genera tu informe

Cuando termines de crear tu consulta, selecciona Ejecutar consulta. Si no hay errores ni tiempos de espera agotados del informe, se genera un archivo CSV a partir de la consulta.

Para descargar el informe CSV, selecciona Exportar.

Importante

Cada informe solo puede generar resultados una vez al día. Si ejecutas el mismo informe varias veces en un mismo día natural, verás los mismos resultados en cada informe.

Tiempos de espera de los informes

Los informes que tarden más de seis minutos en ejecutarse agotarán el tiempo de espera. Si es la primera consulta que ejecutas en un tiempo, puede tardar más en procesarse y, por tanto, tiene más probabilidades de agotar el tiempo de espera. Si esto ocurre, intenta ejecutar el informe de nuevo.

Si tu informe sigue agotando el tiempo de espera después de varios intentos, ponte en contacto con el soporte.

Consultar los motivos de cancelación

Puedes consultar la columna ABORT_TYPE en cualquier tabla USERS_MESSAGES_*_ABORT_SHARED para analizar por qué no se enviaron los mensajes. El campo ABORT_TYPE contiene un valor de cadena que describe el motivo concreto de la cancelación, y el campo complementario ABORT_LOG contiene información adicional (como la regla de limitación de frecuencia que se activó).

Por ejemplo, para contar las cancelaciones de correo electrónico por tipo en los últimos 30 días:

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 la lista completa de valores de ABORT_TYPE y sus descripciones, consulta Tipos de cancelación.

Datos y resultados

Todas las consultas muestran datos de los últimos 60 días. Cuando exportes tus resultados, solo contendrán hasta 1000 filas. Para los informes que requieran mayores cantidades de datos, puedes utilizar herramientas como Currents o el endpoint de la API de exportación.

Créditos de Snowflake

Cada empresa dispone de 5 créditos de Snowflake al mes, compartidos entre todos los espacios de trabajo. Cada vez que ejecutas una consulta o previsualizas una tabla, se consume una pequeña parte de un crédito de Snowflake.

Nota

Los créditos de Snowflake no se comparten entre características. Por ejemplo, los créditos de las extensiones de segmento SQL y los del Generador de consultas son independientes entre sí.

El uso de créditos está relacionado con el tiempo de ejecución de tu consulta SQL. Cuanto más largo sea el tiempo de ejecución, mayor será la parte de un crédito de Snowflake que costará la consulta. El tiempo de ejecución puede variar según la complejidad y el tamaño de tus consultas con el tiempo. Cuanto más complejas y frecuentes sean las consultas que ejecutes, mayor será tu asignación de recursos y más rápido será tu tiempo de ejecución.

No se consumen créditos al escribir, editar o guardar informes en el editor SQL de Braze. Tus créditos se restablecerán a 5 el primer día de cada mes a las 12 a. m. UTC. Puedes supervisar tu uso mensual de créditos en la parte superior de la página del Generador de consultas.

Cuando alcanzas el límite de créditos, no puedes ejecutar consultas, pero sí puedes crear, editar y guardar informes SQL. Si quieres comprar más créditos para el Generador de consultas, ponte en contacto con tu director de cuentas.