Créer et gérer des jeux de données de tableau de bord

Article
02/11/2025

Cet article explique comment créer et gérer des jeux de données de tableau de bord à l’aide de l’éditeur de jeu de données dans un tableau de bord IA/BI.

Définir les jeux de données

Pour définir ou accéder à des jeux de données existants, cliquez sur l’onglet Données près du coin supérieur gauche de votre tableau de bord. Vous pouvez définir jusqu’à 100 jeux de données par tableau de bord.

Vous pouvez définir des jeux de données comme suit :

Une nouvelle requête sur une ou plusieurs tables ou vues.
Une table ou une vue existante du catalogue Unity.

Tous les jeux de données sont définis par une requête. Lorsque vous choisissez une table ou une vue existante du catalogue Unity, la requête de ce jeu de données est une instruction SELECT * sur cette table ou vue. Vous pouvez modifier la requête pour affiner le jeu de données.

Un jeu de données doit être généré par une requête qui peut être encapsulée dans sql supplémentaire. Les sorties de commandes telles que DESCRIBE ou EXPLAIN ne sont pas valides en tant que jeux de données. En outre, les requêtes de tableau de bord sont en lecture seule, de sorte que les instructions qui modifient des données, telles que CREATE TABLE, INSERTou DELETE, ne sont pas prises en charge.

Après avoir défini un jeu de données, utilisez le menu kebab à droite du nom du jeu de données pour accéder aux options suivantes :

Renommer : donnez à votre ensemble de données un nom descriptif permettant à votre équipe et à vous-même d'identifier rapidement les requêtes que vous souhaitez modifier ou réviser.
Nom de suggestion : générez automatiquement un nom suggéré en fonction de la requête. Vous pouvez modifier ce nom après sa génération.
Clone : créez une copie sur place de votre requête. Vous pouvez modifier la requête après son clonage.
Supprimer : Supprimez un jeu de données. Cette option n’est pas disponible si le jeu de données est utilisé sur le canevas.
Télécharger : vous pouvez télécharger le jeu de données en tant que fichier CSV, TSV ou Excel.

Remarque

Les jeux de données actuellement utilisés sur le canevas apparaissent en gras avec une icône bleue, tandis que les jeux de données inutilisés ont une icône grise et des noms non gras.

Afficher la table des résultats

Lorsque vous créez un jeu de données, la requête s’exécute automatiquement et les résultats apparaissent sous la forme d’une table dans le volet sous l’éditeur. Chaque colonne inclut une icône indiquant son type de données.

Pour trier les valeurs de colonne :

Pointez sur chaque colonne pour afficher l'icône de tri .
Cliquez sur l’icône pour trier les valeurs dans l’ordre croissant ou décroissant.

Afficher le schéma de résultat de la requête

Pour afficher le schéma de votre jeu de données défini, cliquez sur Schéma à droite de la table de résultats. L’onglet Schéma répertorie tous les champs du jeu de données défini. Chaque champ est étiqueté avec une icône indiquant le type de données de la colonne. Si les tables ou vues sous-jacentes incluent des commentaires, ils apparaissent sous l’onglet Schéma.

Mesures calculées

Les mesures calculées offrent un moyen d’appliquer des calculs à un jeu de données existant sans modifier le code SQL qui crée le jeu de données. Pour en savoir plus sur la création et l’utilisation de mesures calculées, consultez Que sont les mesures calculées ?

Écrire des requêtes à plusieurs instructions

Dans certains cas, vous pouvez créer un jeu de données à l’aide de plusieurs instructions SQL. Pour exécuter plusieurs instructions, terminez chaque instruction par un point-virgule (;). Lorsque vous exécutez ces commandes pour créer le jeu de données, la sortie affiche les résultats de la dernière instruction dans l’éditeur. Ce jeu de données est utilisé pour toutes les visualisations associées sur le canevas.

Les déclarations sont locales au jeu de données où elles sont émises. Par exemple, si vous créez un jeu de données avec une instruction USE pour définir le catalogue ou le schéma, ce paramètre s’applique uniquement à ce jeu de données.

Exemples

Les exemples suivants illustrent des utilisations courantes pour les requêtes à plusieurs instructions.

Définir le catalogue et le schéma

Vous pouvez écrire une instruction USE pour déclarer le catalogue et le schéma de la table dans votre requête. La requête suivante contient trois instructions. Le premier définit le nom du catalogue. Le deuxième définit le schéma. L’instruction SELECT fait référence uniquement au nom de la table, car le catalogue et le schéma ont été définis. Consultez USE CATALOG.


USE CATALOG samples;
USE SCHEMA tpch;
SELECT * FROM customer;

Définir le mode ANSI

Vous pouvez paramétrer une requête à exécuter avec ANSI_MODE réglé sur TRUE ou FALSE. Pour Databricks SQL, la valeur par défaut du système pour ANSI_MODE est TRUE. Consultez ANSI_MODE.

La requête suivante définit ANSI_MODE sur FALSE afin que les entrées de type de données non valides retournent NULL plutôt que de provoquer une erreur.

SET ANSI_MODE = FALSE;
SELECT cast('a' AS INTEGER);

Paramétrer des requêtes complexes

Vous pouvez utiliser plusieurs instructions pour paramétrer le nom de la vue pour une expression de table commune ou une autre requête complexe.

La requête suivante crée deux vues temporaires. L’instruction SELECT utilise la clause IDENTIFIER pour interpréter la chaîne d’entrée en tant que nom de table. Consultez la IDENTIFIERclause .

CREATE TEMPORARY VIEW v1 AS SELECT 1;
CREATE TEMPORARY VIEW v2 AS SELECT 2;
SELECT * FROM IDENTIFIER(:view_name)

Définition des variables

La requête suivante déclare une variable et une valeur dans la première instruction. La deuxième instruction modifie la valeur de la variable. La troisième instruction indique que la valeur finale de la variable est 5. Consultez SET VARIABLE pour plus d’informations et une syntaxe complète concernant l’utilisation de variables temporaires.

DECLARE VARIABLE myvar1 INT DEFAULT 7;
SET VAR myvar1 = 5;
VALUES (myvar1);

Limiter l’accès aux données avec SQL

Les utilisateurs de tableaux de bord peuvent accéder à toutes les données d’un jeu de données, y compris celles qui ne figurent pas dans les visualisations. Pour empêcher l’exposition des données sensibles dans le navigateur, limitez les colonnes de la requête SQL qui définit le jeu de données. Par exemple, au lieu de sélectionner toutes les colonnes d’une table, incluez uniquement les champs spécifiques requis pour les visualisations.

Partager via