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

Necesitarás permisos de “Ver PII” para utilizar el Generador de consultas, ya que permite acceder directamente a algunos datos de clientes.

Utilizar el Generador de consultas

Paso 1: Crear una consulta SQL

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

Si necesitas inspiración o ayuda para elaborar tu consulta, elige Plantilla de consulta y selecciona una plantilla prefabricada. 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 ratón por encima del nombre y selecciona para dar un nombre significativo a tu consulta SQL.

Paso 2: Construye tu consulta

Cuando construyas tu consulta, puedes optar por obtener ayuda de la IA o construirla por tu cuenta.

• using brazeai
• on my own

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

Paso 3: Genera tu informe

Cuando hayas terminado de crear la consulta, selecciona Ejecutar consulta. Si no hay errores ni tiempos de espera del informe, se generará un archivo CSV a partir de la consulta.

Para descargar el informe CSV, selecciona Exportar.

Tiempos de espera del informe

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

Si tu informe sigue agotando el tiempo de espera tras varios intentos, ponte en contacto con Soporte.

Consultar 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 específico de la cancelación, y el campo complementario ABORT_LOG contiene detalles adicionales (como la regla de limitación de frecuencia que se desencadenó).

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 requieren mayores cantidades de datos, puedes utilizar herramientas como Currents o el punto de conexión de la API de exportación.

Créditos de Snowflake

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

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

Los créditos no se utilizan al escribir, editar o guardar informes dentro del editor SQL de Braze. Tus créditos volverán a ser 5 el primer día de cada mes a las 12 am UTC. Puedes controlar el uso mensual de tus créditos en la parte superior de la página del Generador de consultas.

Cuando alcances el límite de créditos, no podrás ejecutar consultas, pero podrás crear, editar y guardar informes SQL. Si deseas adquirir más créditos del Generador de consultas, ponte en contacto con tu director de cuentas.