Créer des requêtes dans le Générateur de requêtes
Découvrez comment utiliser le Générateur de requêtes pour générer des rapports à partir des données de Braze dans Snowflake. Le Générateur de requêtes inclut des modèles de requêtes SQL prédéfinis pour vous aider à démarrer, mais vous pouvez aussi écrire vos propres requêtes SQL personnalisées pour obtenir encore plus d’informations.
Conditions préalables
Pour utiliser le Générateur de requêtes, vous devez disposer des autorisations suivantes au niveau de l’espace de travail :
| Autorisation | Ce qu’elle permet |
|---|---|
| « Afficher les rapports du tableau de bord » | Ouvrir le Générateur de requêtes dans le tableau de bord |
| « Afficher les PII » | Accéder aux données du Générateur de requêtes, qui peuvent inclure des données client |
| « Modifier les rapports du tableau de bord » | Créer, modifier et exécuter des rapports du Générateur de requêtes |
Utiliser le Générateur de requêtes
Étape 1 : Créer une requête SQL
Pour créer une nouvelle requête, accédez à Analyse > Générateur de requêtes, puis sélectionnez Créer une requête SQL.

Si vous avez besoin d’inspiration ou d’aide pour rédiger votre requête, choisissez Modèle de requête et sélectionnez un modèle prédéfini. Pour partir d’une requête vierge, sélectionnez Éditeur SQL.
Votre rapport reçoit automatiquement un nom comprenant la date et l’heure actuelles. Survolez le nom et sélectionnez pour donner un nom explicite à votre requête SQL.

Étape 2 : Créer votre requête
Pour créer votre requête, vous pouvez vous faire aider par l’IA ou la rédiger vous-même.

Cette fonctionnalité fait désormais partie de BrazeAITM Operator, l’assistant d’IA unifié de Braze. Les fonctionnalités d’IA auparavant disponibles sous forme d’assistants autonomes sont désormais toutes accessibles via Operator, où que vous travailliez dans le tableau de bord.
Dans le panneau latéral du Générateur de requêtes, sélectionnez Demander à Operator et décrivez les données que vous souhaitez obtenir. Operator rédige le code SQL à partir des tables de données Snowflake disponibles. Vous pouvez ensuite examiner le SQL et prévisualiser les résultats avant d’exécuter votre rapport. Pour utiliser Operator dans le Générateur de requêtes, vous devez disposer de l’autorisation « Edit Dashboard Reports ».
Le SQL généré doit respecter les mêmes règles de rédaction SQL que les requêtes que vous rédigez vous-même. Pour en savoir plus, consultez Ce que vous pouvez faire avec Operator. Pour savoir comment Operator traite vos données, consultez Confidentialité et sécurité des données d’Operator.
Rédigez votre requête SQL en utilisant la syntaxe Snowflake. Consultez la référence des tables pour obtenir la liste complète des tables et colonnes disponibles pour vos requêtes.
Pour afficher les détails des tables dans le Générateur de requêtes :
- Sur la page Générateur de requêtes, ouvrez le panneau Référence et sélectionnez Tables de données disponibles pour afficher les tables de données disponibles et leurs noms.
- Sélectionnez Voir les détails pour afficher la description de la table et des informations sur ses colonnes, comme les types de données.
- Pour insérer le nom de la table dans votre SQL, sélectionnez .
Limiter votre requête à une période précise vous permet d’obtenir des résultats plus rapidement. Voici un exemple de requête qui récupère le nombre d’achats et le chiffre d’affaires généré au cours de la dernière heure.
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()));
Cette requête récupère le nombre d’e-mails envoyés au cours du dernier mois :
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 votre requête porte sur CANVAS_ID, CANVAS_VARIATION_API_ID ou CAMPAIGN_ID, les colonnes de nom associées sont automatiquement incluses dans le tableau des résultats. Vous n’avez pas besoin de les inclure dans la requête SELECT elle-même.
| Nom de l’ID | Colonne de nom associée |
|---|---|
CANVAS_ID |
Canvas Name |
CANVAS_VARIATION_API_ID |
Canvas Variant Name |
CAMPAIGN_ID |
Campaign Name |
Cette requête récupère les trois ID et leurs colonnes de nom associées, avec un maximum de 100 lignes :
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100
Résolution des problèmes
Votre requête peut échouer pour l’une des raisons suivantes :
- Erreurs de syntaxe dans votre requête SQL
- Délai de traitement dépassé (au-delà de 6 minutes)
- Les rapports dont l’exécution dure plus de 6 minutes expirent.
- Si un rapport expire, essayez de réduire la période sur laquelle vous interrogez les données ou d’interroger un ensemble de données plus spécifique.
Étape 3 : Générer votre rapport
Une fois votre requête terminée, sélectionnez Exécuter la requête. En l’absence d’erreurs ou de délais d’expiration du rapport, un fichier CSV est généré à partir de la requête.
Pour télécharger le rapport CSV, sélectionnez Exporter.


Chaque rapport ne peut générer des résultats qu’une fois par jour. Si vous exécutez le même rapport plusieurs fois au cours d’une même journée calendaire, vous obtenez les mêmes résultats à chaque fois.
Expiration des rapports
Les rapports dont l’exécution dépasse six minutes expirent. Si vous n’avez pas lancé de requête depuis un certain temps, son traitement peut prendre plus longtemps, ce qui augmente le risque d’expiration. Dans ce cas, relancez simplement le rapport.
Si votre rapport continue d’expirer après plusieurs tentatives, contactez l’assistance.
Interroger les motifs d’abandon
Vous pouvez interroger la colonne ABORT_TYPE de n’importe quelle table USERS_MESSAGES_*_ABORT_SHARED pour analyser les raisons pour lesquelles des messages n’ont pas été envoyés. Le champ ABORT_TYPE contient une valeur de chaîne de caractères décrivant le motif précis de l’abandon, et le champ associé ABORT_LOG fournit des détails supplémentaires (comme la règle de limite de fréquence qui a été déclenchée).
Par exemple, pour compter les abandons d’e-mails par type au cours des 30 derniers jours :
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
Pour obtenir la liste complète des valeurs ABORT_TYPE et leurs descriptions, consultez Types d’abandon.
Données et résultats
Toutes les requêtes affichent les données des 60 derniers jours. Lorsque vous exportez vos résultats, l’export ne contiendra que 1 000 lignes au maximum. Pour les rapports nécessitant de plus grands volumes de données, vous pouvez utiliser des outils tels que Currents ou l’endpoint d’exportation de l’API.
Crédits Snowflake
Chaque entreprise dispose de 5 crédits Snowflake par mois, partagés entre tous les espaces de travail. Une petite partie d’un crédit Snowflake est consommée chaque fois que vous exécutez une requête ou prévisualisez un tableau.

Les crédits Snowflake ne sont pas partagés entre les fonctionnalités. Par exemple, les crédits des extensions de segments SQL et ceux du Générateur de requêtes sont indépendants les uns des autres.
La consommation de crédits dépend de la durée d’exécution de votre requête SQL : plus elle est longue, plus la part de crédit Snowflake consommée par la requête est élevée. La durée d’exécution peut varier au fil du temps en fonction de la complexité et de la taille de vos requêtes. Plus vous exécutez de requêtes complexes et fréquentes, plus l’allocation de ressources est importante et plus la durée d’exécution diminue.
Aucun crédit n’est consommé lorsque vous rédigez, modifiez ou enregistrez des rapports dans l’éditeur SQL de Braze. Vos crédits sont réinitialisés à 5 le premier jour de chaque mois à minuit (UTC). Vous pouvez suivre votre consommation mensuelle de crédits en haut de la page du Générateur de requêtes.

Lorsque vous atteignez la limite de crédits, vous ne pouvez plus exécuter de requêtes, mais vous pouvez toujours créer, modifier et enregistrer des rapports SQL. Pour acheter des crédits supplémentaires pour le Générateur de requêtes, contactez votre gestionnaire de compte.