Extensions de tables
Les extensions de tables vous permettent désormais de créer de nouvelles tables de données avec un script d’extensions d’analytique. Vous pouvez rédiger un script personnalisé TabPy ou Rserve et ajouter éventuellement une ou plusieurs tables d’entrée.
Remarque : Une extension de table est actualisée chaque fois que vous ouvrez un classeur ou que vous actualisez une source de données.
Avantages
Les extensions de tables présentent les avantages suivants pour les utilisateurs novices et expérimentés.
- Intégrez facilement des scripts ou des fonctions avancées dans Tableau
- Faites glisser facilement des données depuis les connexions de données Tableau en tant qu’entrées dans des scripts
- Un éditeur de code réduit facilite l’ajout de code aux sources de données
- S’intègre avec Guide des données et Expliquer les données
- S’intègre à TabPy, Rserve et à d’autres extensions d’analytiques
- Les résultats permettent de créer des tableaux de bord ou des visualisations
Conditions préalables
Avant de pouvoir utiliser les extensions de tables, vous devez remplir la liste suivante.
- Ouvrez une source de données dans Desktop ou Web Authoring.
- Configurer une extension d’analytique
- Pour connaître les étapes de configuration des connexions d’extension d’analytique, consultez Transmettre des expressions avec les extensions d’analytiques.
Créer une extension de table
Pour créer une extension de table, procédez comme suit.
- Ouvrez un classeur.
- Ouvrez une source de données ou créez-en une.
- Sous Connexions, choisissez Nouvelle extension de table.
- Faites glisser la feuille dans le modèle de données.
- (Facultatif) Faites glisser les tables de la connexion de données vers le volet d’extension de table pour les utiliser comme entrée dans votre script ou fonction d’extensions d’analytiques.
Par défaut, les données de Tableau sont transmises à l’extension d’analytique et définies comme
variable _arg1
, une structure de type dictionnaire telle que :{‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5]
- Données d’entrée Python : les données d’entrée peuvent être converties en une trame de données pandas en utilisant ce qui suit :
import pandas as pddf = (pd.DataFrame(_arg1))
- Données d’entrée RServe : les données d’entrée sont définies comme
variable.arg1
et le type de données est une liste nommée de listes. - Données d’entrée SQL personnalisées : pour les sources de données relationnelles prises en charge, vous pouvez utiliser SQL personnalisé comme entrée dans une extension de table. Lorsque des paramètres sont utilisés dans la requête SQL personnalisée, la modification du paramètre entraîne la réexécution de la requête et le recalcul du script. Cela crée un chemin pour mettre à jour dynamiquement les paramètres dans un tableau de bord et filtrer ou transmettre des valeurs au script d’extension de table.
Remarque : Si un paramètre est utilisé dans une extension de table, ce paramètre ne peut pas être supprimé tant qu’il n’est pas supprimé de l’extension. La suppression d’un paramètre appelé en extension de table peut déclencher une erreur fatale.
- Données d’entrée Python : les données d’entrée peuvent être converties en une trame de données pandas en utilisant ce qui suit :
- Sous Scénario, saisissez votre script ou appel de fonction. Le script doit renvoyer un dictionnaire ou une liste de listes, comme un objet JSON. Un script pour RServe doit renvoyer un data.frame ou une liste de listes nommées. Un script pour Python doit renvoyer un dictionnaire.
- Exemple Python : utilisez la commande de retour explicite suivante :
return df.to_dict(orient='list')
Remarque : les extensions de table ne prennent pas en charge l’appel direct des points de terminaison TabPy si TABPY_EVALUATE_ENABLE est désactivé dans TabPy.
- Exemple Python : utilisez la commande de retour explicite suivante :
- Sélectionnez Appliquer pour exécuter le script.
- (Facultatif) Si vous associez l’extension de table à une autre table dans le modèle de données, définissez la relation entre au moins un champ de chaque table.
- Dans la grille de données sous Table de sorties, choisissez Mettre à jour maintenant. Les résultats apparaissent dans l’onglet Table de sorties.
Remarque : si vous ne définissez pas de relation avec une table dans le modèle de données, l’onglet Table d’entrées est vide et affiche le message « Aperçu des données non disponible ».
- (Facultatif) Dans le champ Nom, saisissez un nom unique pour votre nouvelle extension de table.
- Accédez à l’onglet Feuille pour commencer à explorer et à visualiser les données.
- Publiez le classeur pour le partager. La destination de publication doit avoir une extension d’analyse du type approprié activée et configurée.
Conseil de dépannage: Si votre extension de table rencontre une erreur, assurez-vous d’abord que tout le code et le formatage sont corrects. Essayez ensuite d’utiliser le bouton circulaire Actualiser la source de données situé dans la barre d’outils, ou cliquez à nouveau sur Appliquer.
Comparer les types d’extensions
Bien que certains des produits suivants ne soient pas liés, les extensions de table et les extensions d’analyse partagent plusieurs fonctionnalités. Pour fonctionner, les extensions de tables doivent être connectées aux extensions d’analytiques. Présentons chaque fonctionnalité de manière succincte.
Extensions de tableau de bord
Les extensions de tableau de bord autorisent l’ajout d’applications Web personnalisées aux tableaux de bord à l’aide du SDK d’extension de tableau de bord.
Extensions de tables
Les extensions de table vous permettent de créer une table dans une source de données qui peut envoyer des données et un script à votre extension d’analytique et renvoyer une table complète comme résultat. Les résultats obtenus sont affichés sous forme de table dans le modèle de données et sous forme de mesures et de dimensions dans un classeur.
Extensions d’analytiques
Les extensions d’analytiques vous permettent de développer les calculs dynamiques de Tableau avec des langages de programmation comme Python, des outils externes et des plateformes externes.
Après avoir créé une connexion à une extension d’analyse, vous pouvez communiquer avec votre serveur externe via des champs calculés appelés SCRIPT_X
ou MODEL_EXTERNAL_X
, où X
est le type de données des valeurs de retour attendues. Pour plus d’informations, consultez Transmettre des expressions avec les extensions d’analytiques.