Cas d’utilisation de Tableau Content Migration Tool

Tableau Content Migration Tool, comme son nom l’indique, est principalement utilisé pour déplacer le contenu de Tableau Cloud d’un projet vers un autre. L’outil contient également de nombreuses fonctionnalités qui le rendent fort utile pour plusieurs tâches liées à la migration de contenu et à la maintenance.

Remarque : dans de nombreux cas d’utilisation, nous appliquons le terme migration pour décrire le déplacement du contenu d’un environnement, d’un site ou d’un projet vers un autre. Toutefois, techniquement, Content Migration Tool copie le contenu et ne supprime pas et n’archive pas automatiquement le contenu original ou source.

Les renseignements ci-dessous décrivent certains cas d’utilisation courants où vous pouvez utiliser le Content Migration Tool.

Promotion du contenu

Vous pouvez utiliser Content Migration Tool pour créer un contenu pour des projets de développement et effectuer des migrations de routine pour promouvoir le contenu sur des projets intermédiaires ou de production sur votre site.

Procédez comme suit pour migrer le contenu sur des projets de production :

  1. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Dans cet exemple, nous décrivons une migration entre projets sur le même site, choisissez donc le même site Tableau comme site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

    Si vous migrez des classeurs entre deux projets sur le même site, vos identifiants de connexion pour les sites source et de destination peuvent être très similaires ou identiques. Dans ce scénario, nous vous recommandons d’utiliser des jetons d’accès personnels pour rendre la connexion plus réutilisable. Pour plus d’informations, consultez Jetons d’accès personnels.

  2. Sélectionnez le projet de développement avec le contenu que vous souhaitez migrer. Vous pouvez sélectionner des projets entiers, des classeurs et des sources de données spécifiques et des autorisations utilisateur. Pour plus d’informations, consultez Planification dans la rubrique Présentation du plan de migration.

    Si vous devez apporter des modifications ou des transformations au contenu au cours de cette migration, vous pouvez également le configurer dans le plan. Cette opération est appelée Mappage.

  3. Sélectionnez Modifier le projet dans le menu Ajouter un mappage pour ajouter un mappage de projet. Sélectionnez votre projet de développement comme source et votre projet de production comme destination, ou cliquez sur Ajouter nouveau pour créer un nouveau projet.

    Les autres types de mappage incluent :

    • Modifications apportées aux classeurs : incluent le renommage des classeurs et la modification du projet de destination. Pour une liste complète des transformations de classeurs, consultez Plans de migration : Classeurs.

    • Modifications apportées aux sources de données : incluent le remplacement des noms de table ou de schéma, les formules de calcul des paramètres et la définition de l’information de connexion. Pour une liste complète des transformations de sources de données, consultez Plans de migration : Classeurs (sources de données intégrées) et Plans de migration : Sources de données publiées (sources de données publiées).

    • Modifications apportées aux utilisateurs: incluent les modifications de nom de domaine, d’utilisateur et de groupe dans la destination.

  4. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

  5. Pour programmer cette exécution régulièrement, vous pouvez la scripter en tant que travail à l’aide de l’utilitaire d’exécution de Content Migration Tool et la programmer. Pour plus d’information sur l’utilisation de l’utilitaire d’exécution de Content Migration Tool, consultez Utilisation de l’utilitaire d’exécution de console Tableau Content Migration Tool.

Adapter le contenu pour les clients

Lorsque vous travaillez dans un scénario de conseil, vous pouvez personnaliser le contenu pour chacun de vos clients à l’aide de Content Migration Tool. Chaque classeur fonctionne comme un modèle pour votre plan de migration, vous permettant d’appliquer le style (texte, images, etc.) et de remplacer les sources de données pour des clients spécifiques.

Dans cet exemple, nous décrivons une migration entre projets; un projet interne dans lequel vous stockez des modèles et un projet externe que vous partagez avec les clients.

Procédez comme suit pour personnaliser le contenu pour vos clients :

  1. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Choisissez le même site Tableau comme votre site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

    Si vous migrez des classeurs entre deux projets sur le même site, vos identifiants de connexion pour les sites source et de destination peuvent être très similaires ou identiques. Dans ce scénario, nous vous recommandons d’utiliser des jetons d’accès personnels pour rendre la connexion plus réutilisable. Pour plus d’informations, consultez Jetons d’accès personnels.

  2. Sélectionnez le projet interne qui contient le contenu du modèle que vous souhaitez migrer. Vous pouvez sélectionner des projets entiers, des classeurs et des sources de données spécifiques et des autorisations utilisateur. Pour plus d’information, consultez Planification dans la rubrique Présentation du plan de migration.

    Si vous devez apporter des modifications ou des transformations au contenu au cours de cette migration, vous pouvez également le configurer dans le plan. Cette opération est appelée Mappage.

  3. Sélectionnez Modifier le projet dans le menu Ajouter un mappage pour ajouter un mappage de projet. Sélectionnez votre projet interne comme source et votre projet de production comme destination, ou cliquez sur Ajouter nouveau pour créer un nouveau projet.

  4. Dans l’étape Classeurs du Plan de migration, utilisez des mappages et des transformations de classeur pour personnaliser votre contenu. Vous trouverez ci-dessous deux exemples de transformations fréquemment utilisées. Pour une liste complète des transformations de classeurs, consultez Plans de migration : Classeurs.

    • Pour personnaliser le contenu, vous pouvez utiliser les transformations Remplacer l’image et Remplacer le texte pour mettre à jour le classeur avec le nom et le logo d’une entreprise cliente.

    • En ce qui concerne les sources de données, vous pouvez utiliser les transformations Remplacer le nom de la table/du schéma ou Définir SQL personnalisé pour modifier le contenu pour votre client.

  5. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

Migration d’environnement

Vous pouvez utiliser Content Migration Tool pour migrer du contenu entre les environnements Tableau Cloud et Tableau Server avec une licence Advanced Management valide.

Procédez comme suit pour migrer du contenu entre des déploiements de Tableau :

  1. Créez un plan et sélectionnez le site depuis lequel vous souhaitez migrer en tant que site source. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

  2. Sélectionnez le contenu à migrer depuis votre site source. Vous pouvez sélectionner des projets entiers, des classeurs et des sources de données spécifiques et des autorisations utilisateur.

  3. Créez des mappages d’autorisations utilisateur pour personnaliser et sécuriser le contenu. Pour plus d’informations, consultez Plans de migration : autorisations et propriété.

  4. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

Conseils
- Avant d’effectuer une migration de l’environnement, assurez-vous de bien comprendre les Limitations de la migration en cas d’utilisation de Content Migration Tool.
- Vous pouvez migrer votre contenu par étapes, tester et valider le contenu de manière itérative avant l’achèvement de la migration finale.
- La migration à l’aide de Content Migration Tool ne gère pas les identifiants intégrés, les abonnements et les vues personnalisées. Ceux-ci devront être migrés manuellement.

Partage de contenu externe

Vous pouvez utiliser Content Migration Tool pour partager un contenu interne avec des collaborateurs externes, sans les autoriser à accéder à votre projet. Vous préservez ainsi la sécurité de vos données et vous ne publiez qu’une sélection de classeurs et de sources de données. Une fois le contenu partagé, les collaborateurs se connectent à leur site Tableau Cloud pour afficher et apporter des modifications, sans affecter le contenu stocké sur votre projet interne.

Avant de continuer, assurez-vous que le contenu que vous partagez est compatible entre les projets interne et externe.

Procédez comme suit pour partager un contenu en externe :

  1. Préparer le contenu interne. Une meilleure pratique consiste à séparer le contenu sur le projet interne, avec des autorisations verrouillées et des règles de gouvernance strictes. Les classeurs et les sources de données doivent être clairement étiquetés pour indiquer que le contenu est destiné à une utilisation externe. Pour plus d’informations, consultez Utiliser des projets pour gérer l’accès au contenu.

    Remarque : le contenu partagé avec des projets externes doit utiliser des extraits de données à moins que la source de données ne soit accessible publiquement. Pour plus d’informations sur la création d’extraits et le remplacement de sources de données, consultez Extraire vos données et Remplacer des sources de données dans l’aide de Tableau Desktop.

    Si vous avez implémenté la sécurité au niveau des lignes, ces sources de données doivent être mises à jour de manière à refléter les filtres utilisateur et d’autres détails pour le projet externe. Pour plus d’informations sur la sécurité au niveau des lignes, consultez Restreindre l’accès au niveau des lignes de données dans l’aide de Tableau Desktop.

  2. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Choisissez le même site Tableau comme votre site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

    Si vous migrez des classeurs entre deux projets sur le même site, vos identifiants de connexion pour les sites source et de destination peuvent être très similaires ou identiques. Dans ce scénario, nous vous recommandons d’utiliser des jetons d’accès personnels pour rendre la connexion plus réutilisable. Pour plus d’informations, consultez Jetons d’accès personnels.

  3. Sélectionnez le projet interne qui contient le contenu du modèle que vous souhaitez migrer. Vous pouvez sélectionner des projets entiers, des classeurs et des sources de données spécifiques et des autorisations utilisateur. Pour plus d’information, consultez Planification dans la rubrique Présentation du plan de migration.

    Si vous devez apporter des modifications ou des transformations au contenu au cours de cette migration, vous pouvez également le configurer dans le plan. Cette opération est appelée Mappage.

  4. Sélectionnez Modifier le projet dans le menu Ajouter un mappage pour ajouter un mappage de projet. Sélectionnez votre projet interne comme source et votre projet externe comme destination, ou cliquez sur Ajouter nouveau pour créer un nouveau projet.

  5. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

Validation des migrations de bases de données

Dans ce cas d’utilisation, vous avez l’intention de valider le contenu après une migration des bases de données sous-jacentes. Un exemple de migration de base de données est le déplacement de SQL Server vers Snowflake. CMT peut vous aider à valider le contenu créé à partir des deux sources de données qui est le même avant que vous ne finalisiez votre migration, mais il ne peut pas effectuer la migration de la base de données réelle.

Utilisez les étapes suivantes pour valider les migrations de bases de données :

  1. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Choisissez le même site Tableau comme votre site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

  2. Sélectionnez le contenu dont vous souhaitez modifier les connexions de source de données ou de base de données.

  3. Configurez la migration pour copier votre contenu dans un nouveau projet. Appelons le projet source Projet A, et le nouveau projet ou le projet de destination Projet B.
    • Modifications apportées aux classeurs : créez un mappage de classeur pour remplacer le Projet A par le Projet B. Pour obtenir la liste complète des transformations de classeurs, consultez Plans de migration : Classeurs.

    • Modifications apportées aux sources de données : créez un mappage de source de données pour modifier le Projet A en Projet B. Pour obtenir la liste complète des transformations de source de données, consultez Plans de migration : Sources de données publiées.

  4. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

  5. Mettez à jour le contenu du Projet B avec les nouvelles connexions de base de données ou remplacez les sources de données. Cela doit être fait manuellement lors de la création.

  6. Testez chaque classeur dans le Projet A avec la copie dans le Projet B et examinez les incohérences dans les données résultant du changement de source de données.

  7. Après vous être assuré que tout fonctionne comme prévu, remplacez le contenu du projet A par le contenu mis à jour du projet B.

    Remarque : Si le contenu existe déjà dans le projet de destination et que vous ne sélectionnez pas les options de publication Remplacer les classeurs plus récents et Remplacer les sources de données plus récentes, le contenu ne sera pas copié sur le projet de destination.

Tâches de maintenance

Vous pouvez utiliser Content Migration Tool pour effectuer diverses tâches de maintenance.

Balisage du contenu obsolète

Vous pouvez utiliser Content Migration Tool pour gérer l’archivage du contenu obsolète. Par exemple, vous pouvez établir un plan qui s’exécute selon un calendrier régulier pour récupérer automatiquement le contenu balisé comme contenu obsolète et le déplacer vers un projet Archive. À terme, le contenu de ce projet peut être purgé du système. Pour plus d’informations, consultez Plans de migration : Classeurs.

Restauration du contenu

Vous pouvez utiliser Content Migration Tool pour restaurer le contenu supprimé (accidentellement ou intentionnellement) d’un projet avec un contenu issu d’un projet de sauvegarde.

Procédez comme suit pour restaurer un contenu depuis un projet de sauvegarde :

  1. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Choisissez le même site Tableau comme votre site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

  2. Sélectionnez le contenu à restaurer depuis le projet de sauvegarde.

  3. Configurez la migration pour restaurer un contenu depuis votre projet de sauvegarde. Appelons le projet de sauvegarde Projet A et le projet à partir duquel vous souhaitez effectuer la restauration Projet B.

    • Modifications apportées aux classeurs : créez un mappage de classeurs pour remplacer le Projet A par le Projet B. Pour obtenir la liste complète des transformations, consultez Plans de migration : Classeurs.

    • Modifications apportées aux sources de données : créez un mappage de source de données pour modifier le Projet A en Projet B. Pour obtenir la liste complète des transformations de source de données, consultez Plans de migration : Sources de données publiées.

  4. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

  5. Vérifiez le contenu sur le site de production.

Sauvegarde partielle

Après avoir créé votre projet de sauvegarde, vous pouvez utiliser Content Migration Tool pour transférer le nouveau contenu du projet de production vers le projet de sauvegarde.

Remarques :
- avant d’effectuer une sauvegarde partielle, assurez-vous de bien comprendre les Limitations de la migration en cas d’utilisation de Content Migration Tool.
- Content Migration Tool ne doit pas être utilisé pour sauvegarder l’ensemble de votre site. Nous vous recommandons de hiérarchiser le contenu dont vous avez le plus besoin.

Suivez la procédure ci-après pour créer une sauvegarde partielle de votre contenu :

  1. Créez un plan et sélectionnez le site que vous voulez utiliser comme site source. Choisissez le même site Tableau comme votre site de destination. Pour plus d’informations, consultez Créer un plan dans la rubrique Présentation du plan de migration.

  2. Sélectionnez le contenu à sauvegarder depuis le projet de production. Vous pouvez sélectionner des projets entiers, des classeurs et des sources de données spécifiques et des autorisations utilisateur. Pour migrer uniquement un contenu nouveau, assurez-vous que les options de publication Remplacer les classeurs plus récents et Remplacer les sources de données plus récentes ne sont pas sélectionnées. Pour plus d’informations, consultez Plans de migration : Classeurs.

  3. Configurez la migration pour copier le contenu dans votre projet de sauvegarde. Appelons le projet source Projet A et le projet de sauvegarde Projet B.
    • Modifications apportées aux classeurs : créez un mappage de classeurs pour remplacer le Projet A par le Projet B. Pour obtenir la liste complète des transformations, consultez Plans de migration : Classeurs.

    • Modifications apportées aux sources de données : créez un mappage de source de données pour modifier le Projet A en Projet B. Pour obtenir la liste complète des transformations de source de données, consultez Plans de migration : Sources de données publiées.

  4. Vérifiez et exécutez le plan. Une fois prêt, cliquez sur Exécuter la migration pour terminer la phase de planification et vous préparer à exécuter votre plan.

  5. Pour programmer cette exécution sur une base régulière, vous pouvez la scripter en tant que travail à l’aide de l’utilitaire d’exécution de Content Migration Tool et la programmer. Pour plus d’information sur l’utilisation de l’utilitaire d’exécution de Content Migration Tool, consultez Utilisation de l’utilitaire d’exécution de console Tableau Content Migration Tool.