[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Utilisation de SQL Report Builder

Voir la vidéo de formation pour en savoir plus.

SQL, ou langage de requête structuré, est un langage de programmation utilisé pour communiquer avec des bases de données. Dans Commerce Intelligence, SQL est utilisé pour interroger ou récupérer des données à partir de votre Data Warehouse. Examinez les rapports de votre tableau de bord : en coulisses, chacun est alimenté par une requête SQL.

Vous pouvez utiliser l’SQL Report Builder pour interroger directement votre Data Warehouse, afficher les résultats et les transformer en graphique. Vous pouvez commencer à créer un rapport avec le SQL Report Builder en cliquant sur Report Builder > SQL Report Builder.

Voir la vidéo de formation pour en savoir plus.

Le SQL Report Builder vous permet d’interroger directement votre Data Warehouse, d’afficher les résultats et de les transformer rapidement en graphique. Le meilleur aspect de l’utilisation de SQL pour créer des rapports est que vous n’avez pas besoin d’attendre les cycles de mise à jour pour effectuer une itération sur les colonnes que vous créez. Si les résultats ne s’affichent pas correctement, vous pouvez rapidement modifier et réexécuter la requête jusqu’à ce que les éléments correspondent à vos attentes.

Cette rubrique vous guide tout au long de l’utilisation de l’SQL Report Builder . Une fois que vous connaissez la méthode, consultez le tutoriel SQL pour les visualisations ou essayez d’optimiser certaines des requêtes que vous avez écrites.

Couvert dans cet article :

Intégrations SQL Report Builder

Google Analytics est la seule intégration qui ne peut pas être utilisée avec le SQL Report Builder. Cette fonctionnalité est en cours de développement.

Pour commencer à créer un rapport SQL, cliquez sur Report Builder ou Add Report en haut de n’importe quel tableau de bord. Dans l’écran Report Picker, cliquez sur SQL Report Builder pour ouvrir l’éditeur de SQL.

Prise en main

Pour modifier un rapport, cliquez sur l’icône d’engrenage ( ) dans le coin supérieur droit d’un graphique basé sur des SQL, puis cliquez sur Edit.

Écrire une requête writing

En suivant les instructions pour l’optimisation des requêtes, écrivez une requête dans l’éditeur de SQL.

Si la mesure est mise à jour ultérieurement, le rapport SQL ne reflète pas les modifications. Vous devez modifier manuellement le rapport pour que les modifications soient prises en compte.

À l’aide des boutons situés en haut de la barre latérale, vous pouvez basculer entre les listes de tableaux et de mesures disponibles dans le SQL Report Builder. Si vous ne voyez pas ce que vous recherchez dans la liste, essayez de le rechercher à l’aide de la barre de recherche située en haut de la barre latérale.

Vous pouvez également utiliser la barre latérale dans l’éditeur de SQL pour insérer des mesures, des tableaux et des colonnes directement dans vos requêtes en pointant dessus et en cliquant sur Insert :

En outre, tout type de JOIN est pris en charge, mais Adobe recommande de n'utiliser que la JOINTURE INTERNE, car il s'agit du type de JOIN le moins coûteux.

Exécution de la requête et affichage des résultats runquery

Une fois la requête rédigée, cliquez sur Run Query. Les résultats s'affichent dans un tableau sous l'éditeur SQL :

Si les résultats laissent à désirer, vous pouvez modifier la requête et l’exécuter à nouveau jusqu’à ce que vous soyez satisfait.

Il se peut que des messages s’affichent sous l’éditeur, avec la mention EXPLAIN. Si vous voyez l’un de ces éléments, cela signifie que votre requête n’a pas été exécutée et qu’elle nécessite quelques ajustements.

Une fois la modification de la requête terminée, vous pouvez passer à la création d’une visualisation ou à l’enregistrement de votre travail dans un tableau de bord.

Création d’une visualisation createviz

Pour créer une visualisation avec les résultats de votre requête, cliquez sur l’onglet Chart dans le volet Results. Dans cet onglet, vous sélectionnez :

Voici un aperçu rapide de ce à quoi ressemble le processus de visualisation :

Pour une présentation détaillée de la création d’une visualisation, reportez-vous au tutoriel Création de visualisations à partir de requêtes SQL.

Enregistrer le rapport save

Avant de pouvoir enregistrer votre travail, vous devez donner un nom au rapport. N’oubliez pas de suivre les directives relatives aux bonnes pratiques pour l’attribution de noms et de choisir quelque chose qui véhicule clairement le contenu du rapport.

Cliquez sur Save dans le coin supérieur droit de l’éditeur de SQL et sélectionnez le Type de rapport (Chart ou Table). Pour conclure, sélectionnez le tableau de bord dans lequel enregistrer le rapport et cliquez sur Save to Dashboard.

Analyse des données

SQL Report Builder

SQL Report Builder vous permet d’interroger directement vos Data Warehouse, d’afficher les résultats et de les transformer rapidement en rapport. L’utilisation de SQL vous permet également d’utiliser SQL fonctions qui ne sont pas disponibles dans le Visual ou Cohort Report Builder, ce qui vous permet de mieux contrôler vos données.

Les colonnes calculées créées à l’aide de SQL ne dépendent pas des cycles de mise à jour. Vous pouvez donc effectuer une itération sur ces colonnes comme bon vous semble et consulter immédiatement les résultats.

Résultats de la comparaison entre la base de données et l’éditeur SQL

La plupart du temps, les différences de résultats peuvent être attribuées aux cycles de mise à jour. Si Commerce Intelligence est en train de répliquer les données de votre base de données vers votre Data Warehouse, il se peut que vous obteniez des résultats différents même si vous utilisez la même requête.

Les problèmes de connexion peuvent également entraîner des incohérences. Accédez à la page Connections en cliquant sur Manage Data > Connections pour l’extraire. L’intégration de base de données en question génère-t-elle une erreur ? Si tel est le cas, vous devrez peut-être réauthentifier l’intégration pour que les choses fonctionnent à nouveau.

Si toutes vos intégrations sont connectées avec succès et que vous n’êtes pas au milieu d’un cycle de mise à jour, une autre erreur peut se produire.

La suppression d’un rapport SQL supprime-t-elle également les colonnes sous-jacentes de mon Data Warehouse ?

Non, vous ne perdez aucune colonne de votre Data Warehouse, quelle que soit la manière dont vous les avez créées.

Les colonnes créées à l’aide du Data Warehouse Manager ne sont pas affectées si vous supprimez un rapport ou une requête qui les utilise.

Les colonnes créées à l’aide du SQL Report Builder ne sont pas enregistrées dans votre Data Warehouse.

Report Builder contre SQL Report Builder

Le SQL Report Builder vous offre davantage de flexibilité lors de la création et de la structuration de vos graphiques. Vous pouvez, par exemple, sélectionner les valeurs à afficher sur les axes X et Y. Pour plus d’informations sur la création de graphiques dans le SQL Report Builder, consultez le tutoriel Création de visualisations à partir SQL requêtes.

Cohort Report Builder cohortrb

Contrairement à la Visual Report Builder, la Cohort Report Builder a un seul objectif : analyser et identifier les tendances comportementales de groupes d’utilisateurs similaires au fil du temps. L'utilisation de la Cohort Report Builder ne nécessite pas de savoir-faire SQL, vous pouvez donc plonger sans hésitation si vous débutez.

Reconstruction des requêtes après le cycle de mise à jour

Vous n’avez pas à recréer vos requêtes. Les rapports créés à l’aide du SQL Report Builder sont enregistrés comme ceux créés dans le Report Builder traditionnel. Le processus de mise à jour des graphiques SQL est le même : une fois vos données mises à jour, les valeurs de vos graphiques sont recalculées et réaffichées.

Conclusion wrapup

Si vous souhaitez essayer quelque chose d’un peu plus difficile, pourquoi ne pas essayer d’écrire une requête optimisée pour la visualisation ? Consultez le tutoriel Création de visualisations à partir SQL requêtes pour commencer.