Manage ChatBI datasets - DataWorks - Centre de documentation Alibaba Cloud

Avant de démarrer une session interactive dans ChatBI, vous devez utiliser un jeu de données pour définir le périmètre des données à analyser. Un jeu de données peut être une table issue d'une source de données cible ou un fichier local.

Prérequis

Un groupe de ressources serverless a été créé dans la région où vous utilisez ChatBI.

Notes d'utilisation

Pour les jeux de données issus d'une source de données, seules les sources Hologres, MaxCompute, StarRocks et MySQL sont prises en charge.
Pour les jeux de données issus de fichiers locaux, seuls les formats xls, xlsx et csv sont pris en charge. Vous pouvez importer au maximum 10 fichiers, dont la taille unitaire ne doit pas dépasser 1 Go.
Les membres de l'espace de travail, quel que soit leur rôle, peuvent créer et utiliser des jeux de données à partir des sources de données DataWorks. Auparavant, cette fonctionnalité était réservée aux administrateurs de l'espace de travail.

Créer un jeu de données

Accédez à la page ChatBI.

Connectez-vous à Alibaba Cloud et ouvrez la page ChatBI Intelligent Data Insights. Sélectionnez le point d'accès correspondant à la région de vos ressources DataWorks, telles que votre jeu de données et votre groupe de ressources serverless.

Point d'entrée ChatBI Chine (Hangzhou)	Point d'entrée ChatBI Chine (Shanghai)	Point d'entrée ChatBI Chine (Shenzhen)	Point d'entrée ChatBI Chine (Hong Kong)
Point d'entrée ChatBI Chine (Chengdu)	Point d'entrée ChatBI Chine (Pékin)	Point d'entrée ChatBI Chine (Zhangjiakou)	Point d'entrée ChatBI Indonésie (Jakarta)

Dans le volet de navigation de gauche, cliquez sur Dataset pour accéder à la page Datasets. Puis, cliquez sur Create Dataset.

Sur la page Create Dataset, configurez les paramètres suivants :

Si le type de jeu de données est Data Source :

Paramètre		Description
Basic Information	Name	Saisissez un nom personnalisé pour le jeu de données.
	Type	Type du jeu de données. Valeurs possibles : Data Source Local File Sélectionnez Data Source.
	Data Source Type	Type de la source de données. Valeurs possibles : Hologres MaxCompute StarRocks MySQL
	Informations sur la source de données	Les paramètres de configuration varient selon le type de source de données. Par exemple, pour Hologres, vous devez configurer les paramètres Region, Hologres Instance et Database Name.
	Resource Group	Sélectionnez un groupe de ressources serverless DataWorks, qui sera utilisé pour accéder à la source de données lors des requêtes de données dans les sessions ultérieures.
	Test Network Connectivity	Testez la connectivité réseau entre le groupe de ressources serverless DataWorks sélectionné et la source de données.
	Semantic Analysis	(Affiché uniquement lorsque le type de source de données est MaxCompute) Indique si l'analyse sémantique doit être activée pour le jeu de données. Après avoir sélectionné Enable Semantic Analysis, la plateforme crée ou met automatiquement à jour une tâche sémantique pour analyser les tables de données du jeu de données lorsque vous créez ou modifiez un jeu de données et l'enregistrez. Cette fonction permet la restitution des connaissances sémantiques lors des sessions ChatBI, améliorant ainsi la précision des réponses aux questions. Une fois cette fonctionnalité activée, l'onglet Semantic Analysis s'affiche sur la page des détails du jeu de données. Cette option est sélectionnée par défaut lors de la création d'un jeu de données.
Select Destination Table	Sélectionnez les tables de destination	Une fois la configuration des Basic Information terminée, cliquez sur Next pour accéder à l'étape Select Destination Table. Dans la liste To Be Selected, sélectionnez les tables de destination et cliquez sur pour les ajouter à la liste Selected. Les tables sélectionnées sont ajoutées au jeu de données actuel.

Si le type de jeu de données est Local File :

Paramètre		Description
Basic Information	Name	Saisissez un nom personnalisé pour le jeu de données.
	Type	Type du jeu de données. Valeurs possibles : Source de données Fichier local Sélectionnez Local File.
	Importer des fichiers locaux	Seuls les formats `xls`, `xlsx` et `csv` sont pris en charge. Vous pouvez importer au maximum 10 fichiers, dont la taille unitaire ne doit pas dépasser 1 Go.

Une fois la configuration du jeu de données terminée, cliquez sur Next pour accéder à l'étape Data Insight. Le système analyse automatiquement le jeu de données pour extraire les caractéristiques de valeur des données, ce qui améliore la précision de l'analyse pendant les sessions.
L'analyse Data Insight peut prendre beaucoup de temps. Vous pouvez cliquer directement sur Completed et consulter les résultats dans le jeu de données ultérieurement.

Consulter un jeu de données

Dans le volet de navigation de gauche, cliquez sur Dataset pour accéder à la page Datasets.
Repérez la carte du jeu de données cible et cliquez dessus pour accéder à la page des détails du jeu de données.

Pour les jeux de données MaxCompute avec l'option Semantic Analysis activée, la carte du jeu de données affiche le statut de l'analyse sémantique, qui peut être « En attente d'analyse sémantique », « Analyse sémantique en cours », « Analyse sémantique terminée » ou « Échec de l'analyse sémantique ».
Sur la page des détails du jeu de données, la partie supérieure affiche les informations de base du jeu de données (y compris le type, le nombre de tables/fichiers et le créateur), la partie gauche affiche la liste des tables/fichiers et la partie droite affiche les informations de base ainsi qu'un aperçu des données de chaque table/fichier (jusqu'à 20 enregistrements peuvent être consultés).

Consulter les résultats de l'analyse sémantique

Pour les jeux de données MaxCompute avec l'option Semantic Analysis activée, après avoir accédé à la page des détails du jeu de données, vous pouvez cliquer sur l'onglet Semantic Analysis pour consulter le statut de la tâche sémantique et les résultats de l'analyse.

Remarque

L'onglet Semantic Analysis s'affiche uniquement lorsque le jeu de données remplit les deux conditions suivantes : le jeu de données utilise une source de données MaxCompute et l'option Enable Semantic Analysis a été sélectionnée lors de la création ou de la modification du jeu de données.

L'onglet Semantic Analysis présente la structure suivante :

Barre d'état (haut) : Affiche le statut actuel de l'analyse sémantique et le statut de synchronisation. Les statuts d'analyse sémantique incluent Semantic Parsing in Progress, Semantic Parsing Completed et Semantic Parsing Failed.
Result Files (volet gauche) : Répertorie les fichiers de résultats générés par l'analyse sémantique, y compris le fichier d'index (_index.json) et les fichiers YAML du modèle sémantique. Cliquez sur un nom de fichier pour afficher son contenu dans le volet droit.
Visionneuse de contenu (volet droit) : Affiche le contenu détaillé du fichier sélectionné. Pour les fichiers YAML du modèle sémantique, la visionneuse de contenu propose deux modes d'affichage :
- Semantic Graph : Affiche les relations entre les tables de données et les métriques du modèle sémantique sous forme de graphique visuel, ainsi que des statistiques telles que le nombre de tables et de métriques.
- YAML Source : Affiche le contenu brut du fichier YAML du modèle sémantique avec les numéros de ligne, vous permettant de consulter les définitions de champs, les formules de métriques et les descriptions métier du modèle.

Vous pouvez effectuer les opérations suivantes dans l'onglet Semantic Analysis :

Bouton	Description
Rerun	Déclenche à nouveau la tâche d'analyse sémantique. Utilisez cette option lorsque la structure des tables du jeu de données a changé et que le modèle sémantique doit être mis à jour.
Refresh	Actualise le statut de l'analyse sémantique et la liste des fichiers de résultats.
Download	Télécharge le fichier YAML du modèle sémantique sélectionné sur votre machine locale. Ce bouton n'est disponible qu'une fois l'analyse sémantique terminée.

Pour plus d'informations sur l'analyse sémantique (y compris la structure YAML des modèles sémantiques et l'utilisation des graphiques sémantiques), consultez la rubrique Analyse sémantique Data Agent.

Modifier un jeu de données

Dans le volet de navigation de gauche, cliquez sur Dataset pour accéder à la page Datasets.
Repérez la carte du jeu de données cible. Utilisez l'une des méthodes suivantes pour accéder à la page de modification du jeu de données.
- Survolez la carte du jeu de données cible et, dans le coin supérieur droit de la carte, cliquez sur > Edit.
- Cliquez sur la carte du jeu de données cible pour accéder à la page des détails du jeu de données, puis cliquez sur le bouton Edit dans le coin supérieur droit.
Modifiez la configuration du jeu de données. Les descriptions des paramètres sont identiques à celles de la section Créer un jeu de données.

Remarque
Lorsque vous modifiez la configuration d'un jeu de données existant, le type et le type de source de données ne peuvent pas être modifiés.
Une fois la modification du jeu de données terminée, cliquez sur Suivant pour accéder à l'étape Data Insight. L'analyse Data Insight est à nouveau effectuée sur les données du jeu de données.

Supprimer un jeu de données

Dans le volet de navigation de gauche, cliquez sur Dataset pour accéder à la page Datasets.
Survolez la carte du jeu de données cible et, dans le coin supérieur droit de la carte, cliquez sur > Delete. Après la suppression du jeu de données, les sessions et les graphiques associés ne pourront plus afficher correctement les données.

Étapes suivantes : Démarrer une session basée sur un jeu de données

Utilisez l'une des méthodes suivantes pour démarrer une session basée sur un jeu de données spécifique.
- Dans le volet de navigation de gauche, cliquez sur Dataset pour accéder à la page Datasets. Survolez la carte du jeu de données cible et, dans le coin supérieur droit de la carte, cliquez sur pour démarrer une session.
- Dans le volet de navigation de gauche, cliquez sur New Session pour ouvrir la fenêtre de session ChatBI. Ensuite, dans la fenêtre de session, cliquez sur Select Dataset.
Sur la page Chat, saisissez vos exigences ou questions pour démarrer l'analyse des données. Pour plus d'informations, consultez la rubrique Sessions ChatBI.

Remarque
Si la session utilise un jeu de données avec l'option Semantic Analysis activée, ChatBI effectue automatiquement la restitution des connaissances sémantiques pendant les questions-réponses afin d'améliorer la précision de l'analyse. Si le jeu de données est encore en cours d'analyse, vous pouvez commencer à poser des questions. Pour les questions complexes, nous vous recommandons de les poser à nouveau une fois l'analyse terminée pour obtenir des réponses plus précises.