--- schema_version: "1" id: afc32c43db15ed60a38e47ff47422ec0facbe8a23623f38619353c3f608176df title: Casos de uso do Content Migration Tool do Tableau collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server/cmt-use-cases.md canonical_url: https://help.tableau.com/current/server/pt-br/cmt-use-cases.htm source_site: help.tableau.com content_type: documentation content_hash: d6eb8658bbc4644f27460268587d5f054d7e4fc531c5d4c8fec6328e0f31cba0 description: Explore Content Migration Tool use cases like content promotion, customization, and maintenance. --- [Pular para o conteúdo principal](#main-content) # Casos de uso do Content Migration Tool do Tableau O Content Migration Tool do Tableau, como o nome sugere, é usado principalmente para migrar o conteúdo do Tableau Server de um site para outro. No entanto, existem muitos recursos na ferramenta que a tornam ideal para realizar várias tarefas relacionadas à migração e manutenção de conteúdo. **Observação:** em muitos dos casos de uso, usamos o termo migração para descrever a movimentação de conteúdo de um ambiente, site ou projeto para outro. No entanto, tecnicamente o Content Migration Tool copia o conteúdo e não exclui nem arquiva automaticamente o conteúdo original ou de origem. As informações abaixo descrevem alguns casos de uso comuns para utilizar o Content Migration Tool. ## Promoção de conteúdo Você pode usar o Content Migration Tool para criar conteúdo em sites de desenvolvimento e fazer migrações rotineiras para promover o conteúdo em ambientes de preparo ou produção. Siga estas etapas para promover conteúdo em ambientes de produção: 1. **Crie um plano** e selecione o site usado para desenvolvimento como origem e o site de preparo ou produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). Quando você estiver migrando suas pastas de trabalho entre dois projetos no mesmo site, suas credenciais de entrada para a origem e o destino podem ser semelhantes ou idênticas. Nesse cenário, recomendamos o uso de tokens de acesso pessoal para uma conexão mais reutilizável. Para obter mais informações, consulte [Tokens de acesso pessoal](https://help.tableau.com/current/server/pt-br/security_personal_access_tokens.htm). 2. **Selecione o conteúdo** que você deseja migrar do site de origem. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. Para obter mais informações, consulte Planejamento no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-2-planning). 3. Se você precisar fazer **alterações ou transformações** no conteúdo durante essa migração, também pode fazer essa configuração no plano. Isso é conhecido como **Mapeamento**. Os tipos de mapeamento que você pode fazer incluem: - **Alterações nas pastas de trabalho:** inclui renomear as pastas de trabalho e alterar o projeto de destino. Para obter uma lista completa de transformações da pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm). ![Um menu suspenso na janela Migração que lista opções para renomear pastas de trabalho, projetos, prefixos e sufixos.](/tableau/current/pt-br/server/pt-br/Img/cmt-workbook-mapping-options.png) - **Alterações nas fontes de dados:** inclui a substituição dos nomes de tabela ou esquema, configurações de fórmulas de cálculo e definição das informações de conexão. Para obter uma lista completa de transformações das fontes de dados, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm#step-3-workbook-transformations) (fontes de dados inseridas) e [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm#step-3-data-source-transformations) (fontes de dados publicadas). ![O menu suspenso Adicionar transformação para transformações de fonte de dados.](/tableau/current/pt-br/server/pt-br/Img/cmt-datasource-mapping-options.png) - **Alterações nos usuários:** inclui alterações de domínio, usuário e nome de grupo no destino. 4. Quando estiver pronto, clique em **Executar a migração** para encerrar a fase de Planejamento e preparar-se para executar o plano. 5. **Para agendar** essa ação para ser executada regularmente, você pode [criar um script como trabalho](https://help.tableau.com/current/server/pt-br/cmt-scripting_migration_example.htm) usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm). ## Personalização de conteúdo para clientes Ao trabalhar em um cenário de consultoria, você pode personalizar o conteúdo para cada um dos clientes usando o Content Migration Tool. Cada pasta de trabalho funciona como modelo para o plano de migração, permitindo que você aplique estilo (texto, imagens, etc.) e substitua fontes de dados para clientes específicos. **Siga estas etapas para personalizar o conteúdo para os clientes:** 1. **Crie um plano** e selecione o site de produção como origem e o site do cliente como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Na etapa Pastas de trabalho** do Plano de migração, use mapeamentos e transformações de pasta de trabalho para personalizar o conteúdo. Veja abaixo os dois exemplos de transformações utilizadas com frequência. Para obter uma lista completa de transformações da pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm). - Para personalizar o conteúdo, você pode usar as transformações Substituir imagem e Substituir texto para atualizar a pasta de trabalho com o nome e logotipo da empresa de um cliente. - Quando se trata de fontes de dados, você pode usar as transformações Substituir nome de tabela/esquema ou Definir SQL personalizado para modificar o conteúdo do cliente. 3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. ## Migração de ambiente Você pode usar o Content Migration Tool para migrar conteúdo entre os ambientes do Tableau Server. Siga estas etapas para migrar conteúdo entre as implantações do Tableau: 1. **Crie um plano** e **selecione o site** em que deseja migrar como de origem. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Selecione o conteúdo** que você deseja migrar do site de origem. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. 3. **Crie mapeamentos de permissões do usuário** para personalizar e proteger o conteúdo. Para obter mais informações, consulte [Planos de migração: permissões e propriedade](https://help.tableau.com/current/server/pt-br/cmt-plan_users.htm). ![Um menu com opções para planejar, mapear e executar uma migração, com mapeamento de usuários destacado.](/tableau/current/pt-br/server/pt-br/Img/cmt-user-mapping-options.png) 4. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. > [!TIP] > > **Dicas** > \- Antes de realizar a migração de ambiente, entenda as [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm) ao usar o Content Migration Tool. > \- Você pode migrar o conteúdo em etapas, testar e validar o conteúdo iterativamente antes de concluir a migração final. Não há tempo de inatividade do servidor quando você usa esse método de migração. Pode ser uma substituição para importação/exportação do site. > \- A migração do Content Migration Tool não lida com credenciais inseridas, assinaturas e exibições personalizadas. Esses itens precisam ser migrados manualmente. ## Compartilhamento de conteúdo externo Você pode usar o Content Migration Tool para compartilhar conteúdo interno com colaboradores externos, sem permitir o acesso ao site. Isso mantém os dados seguros e permite que você publique apenas as pastas de trabalho e fontes de dados selecionadas. Após compartilhar o conteúdo, os colaboradores entram no site do Tableau Server para exibir e fazer alterações, sem afetar o conteúdo armazenado no servidor interno. Antes de continuar, verifique se o conteúdo que você está compartilhando é compatível entre os sites internos (origem) e externos (destino). O site externo deve estar executando a mesma versão do Tableau que o site interno ou posterior. Para obter mais informações sobre compatibilidade, consulte [Tornar as pastas de trabalho compatíveis entre as versões](https://help.tableau.com/current/desktopdeploy/pt-br/desktop_deploy_compatibility.htm) na ajuda do Tableau Desktop. **Siga estas etapas para compartilhar conteúdo externamente:** 1. **Trabalhe com** o administrador externo do site para determinar uma conta de usuário que tenha direitos de publicação no site. Você usará essa conta de usuário para criar o plano de migração. Para obter mais informações, consulte [Definir funções dos usuários no site](https://help.tableau.com/current/server/pt-br/users_site_roles.htm) e [Permissões](https://help.tableau.com/current/server/pt-br/permissions.htm). 2. **Prepare o conteúdo interno**. Como prática recomendada, é indicado separar o conteúdo no servidor interno para um projeto, com permissões bloqueadas e regras de governança rígidas. As pastas de trabalho e fontes de dados devem ser claramente rotuladas para indicar que o conteúdo é para uso externo. Para obter mais informações, consulte [Usar projetos para gerenciar o acesso ao conteúdo](https://help.tableau.com/current/server/pt-br/projects.htm). **Observação:** o conteúdo compartilhado com sites externos deve usar extrações de dados, a menos que a fonte de dados seja acessível publicamente. Para obter informações sobre a criação de extrações e a substituição de fontes de dados, consulte [Extrair os dados](https://help.tableau.com/current/pro/desktop/pt-br/extracting_data.htm) e [Substituir fontes de dados](https://help.tableau.com/current/pro/desktop/pt-br/connect_basic_replace.htm) na ajuda do Tableau Desktop. Se você implementou a segurança de nível de linha, essas fontes de dados devem ser atualizadas para refletir os filtros de usuário e outros detalhes do site externo. Para obter mais informações sobre a segurança de nível de linha, consulte [Restringir acesso no nível de linha dos dados](https://help.tableau.com/current/pro/desktop/pt-br/publish_userfilters.htm) na ajuda do Tableau Desktop. 3. **Crie um plano** e selecione o site interno como origem e o site externo como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 4. **Selecione o conteúdo** que você deseja compartilhar com o site externo. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. 5. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. ## Validação de migrações de banco de dados Este caso de uso é quando você pretende validar o conteúdo após uma migração dos bancos de dados subjacentes. Um exemplo de migração de banco de dados é a mudança do SQL Server para o Snowflake. O CMT pode ajudar você a validar se o conteúdo criado com base em ambas as fontes de dados é o mesmo antes de finalizar sua migração, mas não pode executar a migração real do banco de dados. Siga estas etapas para validar as migrações de banco de dados: 1. **Crie um plano** e selecione o site do Tableau para usar como origem. Neste exemplo, descrevemos uma migração entre projetos no mesmo site do Tableau, portanto, selecione o mesmo site para seu destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Configure a migração** para copiar o conteúdo para um novo projeto. Vamos chamar o projeto de **origem** de **Projeto A** e o novo ou o projeto de **destino** de **Projeto B**. - Alterações em pastas de trabalho: crie um mapeamento de pasta de trabalho para alterar o Projeto A para o Projeto B. Para obter uma lista completa de transformações de pasta de trabalho, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm). - Alterações em fontes de dados: crie um mapeamento de fonte de dados para alterar o Projeto A para o Projeto B. Para obter uma lista completa de transformações de fontes de dados, consulte [Planos de migração: fontes de dados publicadas](https://help.tableau.com/current/server/pt-br/cmt-plan_datasources.htm). 3. **Verifique e execute** o plano. Quando estiver pronto, clique em **Executar a migração** para encerrar a fase de Planejamento e preparar-se para executar o plano. 4. **Atualize o conteúdo** no **Projeto B** com as novas conexões de banco de dados ou substitua as fontes de dados. Isso precisa ser feito manualmente por meio da criação. 5. **Teste cada pasta de trabalho** no **Projeto A** com a cópia no **Projeto B** e revise quanto a inconsistências nos dados em decorrência da alteração na fonte de dados. 6. Após confirmar que tudo está funcionando como esperado, **substitua o conteúdo** no Projeto A pelo o conteúdo atualizado no Projeto B. **Observação:** se o conteúdo já existir no projeto de destino e você não selecionar as opções de publicação Substituir pastas de trabalho mais recentes e Substituir fontes de dados mais recentes, o conteúdo não será copiado para o projeto de destino. ## Migração de conteúdo geográfico Se você estiver mantendo um ambiente geograficamente distribuído de vários sites, você precisará que parte desse conteúdo seja compartilhada e acessada em todos os servidores. Este caso de uso descreve como migrar conteúdo entre servidores em diferentes regiões geográficas. O servidor pode estar no mesmo país ou em todos os continentes. > [!TIP] > > **Práticas recomendadas:** > \- Recomendamos priorizar o conteúdo que você mais precisa. O Content Migration Tool não deve ser usado para copiar ambientes de servidor inteiros para várias geografias. > \- Recomendamos migrar o conteúdo em uma direção, o que significa apenas Primário para Secundário. Neste caso, usamos o termo Primário para indicar o site de origem e Secundário para indicar o destino. Você pode ter um ou mais destinos criando vários planos de migração. Siga estas etapas para migrar entre os Tableau Server distribuídos em diferentes regiões geográficas: 1. **Crie um plano** e selecione o site Primário como origem e o site Secundário como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Selecione o conteúdo** que você deseja compartilhar entre o Primário e o Secundário. 3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. 4. **Para agendar** essa ação para ser executada regularmente, você pode [criar um script como trabalho](https://help.tableau.com/current/server/pt-br/cmt-scripting_migration_example.htm) usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm). 5. **Revise o conteúdo** na origem **periodicamente** para determinar se novos itens devem ser adicionados ao plano de migração. ## Consolidar sites Se você precisar combinar o conteúdo de vários sites em um único site (se, por exemplo, a reestruturação organizacional tiver mudado como os sites devem ser organizados), você poderá usar o Content Migration Tool para isso. **Observação:** antes de consolidar sites, verifique se compreendeu as limitações ao migrar conteúdo usando o Content Migration Tool. Para obter mais informações, consulte [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm). Use as etapas a seguir para copiar todas as pastas de trabalho e fontes de dados de um site para outro: 1. Crie um plano e selecione o site em que deseja consolidar como origem. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. Na página Projetos de origem, selecione Todos os projetos e clique em Avançar. Se existir um projeto com o mesmo nome no site de destino, o conteúdo será migrado para a mesma pasta. 3. Na página Opções do projeto, selecione suas preferências para o site de destino e clique em Avançar. Se o conteúdo já existir no projeto de destino e você não selecionar a opção substituir, o conteúdo não será copiado para o projeto de destino. 4. Na tela Seleção de pasta de trabalho, selecione Todas as pastas de trabalho. 5. (Opcional) Se você estiver copiando fontes de dados publicadas: - No menu de navegação à esquerda, em Fontes de dados publicadas, clique em Seleção. - Selecione Todas as fontes de dados. 6. Clique em Executar migração e revise o plano de migração. Quando estiver satisfeito, clique em Executar na parte inferior da tela para executar a migração. Repita essas etapas até que você tenha consolidado todos os sites. Para obter mais informações, consulte Planejamento no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-2-planning). ## Tarefas de manutenção Você pode usar o Content Migration Tool para executar diversas tarefas de manutenção. ### Marcação de conteúdo obsoleto Usando o Content Migration Tool, você pode gerenciar o conteúdo desatualizado para arquivamento. Por exemplo, construa um plano que seja executado em um cronograma regular que pode pegar automaticamente o conteúdo marcado como Conteúdo desatualizado e movê-lo para um Projeto de arquivamento. Depois de um certo período de tempo, as informações nesse projeto poderão ser eliminadas do sistema. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm). ### Restauração de conteúdo Você pode usar o Content Migration Tool para restaurar o conteúdo removido (acidentalmente ou de propósito) do Tableau Server de produção com o conteúdo de um servidor de backup. O processo de restauração é simples e não requer tempo de inatividade, em comparação à restauração com um arquivo de backup. Siga estas etapas para restaurar o conteúdo de um servidor de backup: 1. **Crie um plano** e selecione o Tableau Server de backup como origem e o servidor de produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Selecione o conteúdo** que você deseja restaurar do Tableau Server de backup. 3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. 4. **Revise o conteúdo** no servidor de produção. ### Backup parcial Depois de ter um ambiente de backup do Tableau Server, você pode usar o Content Migration Tool para transferir novo conteúdo da produção para o Tableau Server de backup. Se você não tiver configurado um ambiente do Tableau Server de backup, consulte o whitepaper [Recuperação de desastres do Tableau Server](https://www.tableau.com/learn/whitepapers/disaster-recovery-tableau-server) para obter mais informações **Observações:** \- Antes de executar um backup parcial, certifique-se de entender as [Limitações de migração](https://help.tableau.com/current/server/pt-br/cmt-migration_limitations.htm) ao usar o Content Migration Tool. Você ainda pode precisar realizar periodicamente um backup completo e uma restauração para fazer backup de todo o conteúdo do Tableau Server. Para obter mais informações, consulte [Executar um backup e uma restauração completos do Tableau Server](https://help.tableau.com/current/server/pt-br/backup_restore.htm). \- O Content Migration Tool não deve ser usado para realizar seu primeiro backup. Siga estas etapas para realizar um backup parcial do conteúdo: 1. **Crie um plano** e selecione o Tableau Server de backup como origem e o servidor de produção como destino. Para obter mais informações, consulte Criar um plano no tópico [Visão geral do plano de migração](https://help.tableau.com/current/server/pt-br/cmt-depl_plan_overview.htm#step-1-start). 2. **Selecione o conteúdo** em que você deseja fazer backup. Você pode selecionar projetos inteiros, pastas de trabalho específicas e fontes de dados, bem como as permissões do usuário. Para migrar apenas conteúdo novo, verifique se as opções de publicação Substituir pastas de trabalho mais recentes e Substituir fontes de dados mais recentes não foram selecionadas. Para obter mais informações, consulte [Planos de migração: pastas de trabalho](https://help.tableau.com/current/server/pt-br/cmt-plan_workbooks.htm). 3. **Verifique e execute** o plano. Quando estiver pronto, clique em Executar a migração para encerrar a fase de Planejamento e preparar-se para executar o plano. 4. **Para agendar** essa ação para ser executada regularmente, você pode criar um script como trabalho usando o Executor do Content Migration Tool e agendá-lo. Para obter mais informações sobre como usar o Executor do Content Migration Tool, consulte [Utilização do Runner de console Content Migration Tool do Tableau](https://help.tableau.com/current/server/pt-br/cmt-deployment_console_runner.htm).