Préparation de l’exécution du collecteur de tableau

Rversion finale: Australia

Mis à jour 12 mars 2026

4 minutes de lecture

Configurez l’accès à l’API, l’authentification et les autorisations avant d’exécuter le collecteur.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Le collecteur utilise l’API Tableau Metadata pour collecter les métadonnées. Vous devez activer l’API (pour Tableau Server), configurer les autorisations utilisateur et choisir une méthode d’authentification. Vous pouvez également configurer le mappage de nom d’hôte pour les alias de base de données.

Procédure

Activez l’API de métadonnées sur Tableau Server.

Consultez Activer l’API des métadonnées de tableau.

Remarque :
L’API Metadata est activée par défaut pour Tableau Cloud. Cette étape s’applique uniquement à Tableau Server.
Configurez les autorisations utilisateur et créez un jeton d’accès personnel.

Consultez Configurer les autorisations utilisateur Tableau.
Facultatif : Configurez l’authentification JWT à l’aide d’une application connectée.

Consultez Configurer l’authentification Tableau JWT.
Facultatif : Configurez le mappage de nom d’hôte pour les alias de base de données.

Consultez Configurer un fichier YAML pour le mappage des noms d’hôtes.

Activer l’API des métadonnées de tableau

Activez l’API de métadonnées sur Tableau Server pour autoriser la collecte de métadonnées.

Avant de commencer

Rôle requis : admin

Vous devez avoir :

Tableau Server 2019.3 ou version ultérieure
Compte avec rôle d’administrateur de serveur dans Tableau Server
API REST activée (non désactivée)

Remarque :

L’API Metadata est activée par défaut pour Tableau Cloud. Cette procédure s’applique uniquement à Tableau Server.

Pourquoi et quand exécuter cette tâche

Le collecteur Tableau utilise l’API Metadata pour collecter les métadonnées à partir de Tableau Server. Par défaut, cette API est désactivée sur Tableau Server et doit être activée à l’aide de l’interface de ligne de commande Tableau Services Manager (TSM).

Procédure

Ouvrez une invite de commande en tant qu’administrateur sur le nœud initial sur lequel Tableau Services Manager (TSM) est installé dans la grappe.
Exécutez la commande suivante pour activer l’API de métadonnées.
```
tsm maintenance metadata-services enable
```
Activez les autorisations dérivées si vous ne disposez pas de la licence de gestion des données.

Les autorisations dérivées vous permettent de voir les actifs externes associés. Pour des instructions détaillées, consultez la documentation Tableau.

Résultats

L’API de métadonnées est maintenant activée sur Tableau Server et prête pour la collecte de métadonnées.

Configurer les autorisations utilisateur Tableau

Créez un utilisateur Tableau avec les autorisations administrateur et générez un jeton d’accès personnel.

Avant de commencer

Rôle requis : admin

Vous devez disposer des autorisations nécessaires pour créer des utilisateurs et affecter des rôles dans Tableau Server ou Tableau Cloud.

Pourquoi et quand exécuter cette tâche

Le collecteur Tableau nécessite un compte utilisateur doté de privilèges administratifs pour accéder aux métadonnées et les récolter. Créez un compte d’utilisateur dédié et générez un jeton d’accès personnel (PAT) pour l’authentification.

Procédure

Créez un nouvel utilisateur dans Tableau avec les autorisations administrateur.
- Pour Tableau Server, affectez le rôle d’administrateur de serveur. Voir la documentation Tableau pour plus de détails
- Pour Tableau Cloud, affectez le rôle d’administrateur de site. Voir la documentation Tableau pour plus de détails
Créez un jeton d’accès personnel (PAT) pour l’utilisateur.

Pour obtenir des instructions détaillées sur la création d’un PAT, consultez la documentation Tableau.
Conservez le jeton d’accès personnel en toute sécurité.

Vous aurez besoin de ce jeton lors de la configuration du collecteur de métadonnées Tableau.

Configurer l’authentification Tableau JWT

Configurer une application connectée dans Tableau pour l’authentification JWT

Avant de commencer

Rôle requis : admin

Vous devez disposer des autorisations nécessaires pour créer et gérer des applications connectées dans Tableau.

Important :

Les API permettant d’extraire les révisions des classeurs et des sources de données ne sont pas prises en charge par l’authentification JWT.

Pourquoi et quand exécuter cette tâche

Configurez une application connectée pour utiliser l’authentification JWT (JSON Web Token) avec Tableau collector. L’application connectée fournit l’ID client, l’ID secret et la valeur secrète nécessaires pour générer des jetons JWT.

Procédure

Connectez-vous à l’instance Tableau.
Accédez aux paramètres.
Créez une application connectée.

Pour des instructions détaillées, consultez la documentation Tableau.
Activez l’application connectée.
Générez une clé secrète dans l’application connectée.
Enregistrez les informations d’identification de l’application connectée.
Enregistrez les valeurs suivantes à utiliser lors de la configuration du collecteur Tableau :
- ID client
- Secret ID
- Valeur secrète
Ces informations d’identification sont utilisées pour générer des jetons JWT pour l’authentification.

Configurer un fichier YAML pour le mappage des noms d’hôtes

Créez un fichier YAML pour mapper les alias de nom d’hôte de base de données aux noms canoniques.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Utilisez un fichier de mappage de nom d’hôte lorsque vous avez plusieurs noms de serveur (alias) pour la même instance de base de données et que le collecteur de base de données utilise un alias différent de celui défini dans la connexion Tableau. Cette configuration facultative mappe les noms d’hôte de base de données aux noms canoniques pour une frappe IRI cohérente.

Procédure

Créez un fichier YAML nommé hostnames.yml.
Ajoutez des entrées de mappage de nom d’hôte au fichier.
Utilisez le format suivant :
```
mappingValues:
                        - originalHostname: "<Original_HostName>"
                        canonicalHostname: "<canonical_HostName>"
```
Exemple : si votre source Tableau utilise db-server-01.company.local, mais que vous souhaitez utiliser db.company.com comme nom d’hôte lors de la création d’IRI d’objet de base de données :
```
mappingValues:
                        - originalHostname: "db-server-01.company.local"
                        canonicalHostname: "db.company.com"
```
Remarque :
Vous pouvez utiliser des variables d’environnement dans le fichier pour les informations sensibles telles que les mots de passe.
Enregistrez le fichier hostnames.yml.
Transmettez le fichier YAML au collecteur à l’aide de l’option de fichier de mappage des noms d’hôte.

Utilisez l’option de fichier de mappage des noms d’hôtes lors de l’exécution du collecteur pour télécharger le fichier hostnames.yml.

Résultats

Le collectionneur utilisera le nom d’hôte canonique à la place du nom d’hôte d’origine lors de l’invention des IRI d’objets de base de données.