> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/pipeline/operacoes-do-pipeline/operacao-do-pipeline-migrar-dados.md). # Operação do pipeline: migrar dados {% hint style="warning" %} #### Escrito para a interface antiga Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo. {% endhint %} ## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral O **Migrar dados** A operação executa um trabalho de migração do Data Migrator como uma etapa em um pipeline de DevOps. Ela transfere registros entre uma organização de origem e uma de destino usando um modelo do Data Migrator, para que você possa mover dados automaticamente durante um pipeline, em vez de executar uma migração manualmente depois. Como a migração é executada no app Data Migrator, a operação usa seus modelos existentes. Esses modelos especificam quais objetos e registros serão transferidos, juntamente com quaisquer filtros e mapeamentos de registros. {% hint style="info" %} #### Melhores práticas * Teste seu modelo do Data Migrator no app Data Migrator antes de adicioná-lo a um pipeline de DevOps. * Use esta operação para popular uma organização de destino com configuração ou dados de referência após uma implantação. * Mantenha os registros consistentes entre ambientes incluindo uma operação Migrar dados. * Use o Mapeamento de registros no seu modelo para migrações repetidas e evitar duplicação de dados. * Aplique mascaramento de dados no seu modelo do Data Migrator para substituir dados sensíveis por valores semente aleatórios, garantindo que nenhum dado real apareça na organização de destino. {% endhint %} ### Pré-requisitos do Data Migrator Antes de adicionar uma operação Migrar dados, você deve configurar vários itens no app Data Migrator. As seções a seguir descrevem esses pré-requisitos e trazem links para artigos relacionados. ### Modelo Cada migração de dados é executada a partir de um modelo que define quais objetos e registros são migrados, junto com quaisquer filtros e mapeamentos de registros. Verifique se um modelo copia os registros corretos antes de usá-lo em um processo automatizado, como um pipeline. Para saber mais sobre modelos do Data Migrator, leia os artigos a seguir. * [Visão geral dos modelos](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/visao-geral-dos-modelos.md) * [Criando um modelo](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/criando-um-modelo.md) * [Adicionando objetos a um modelo](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/adicionando-objetos-a-um-modelo.md) * [Adicionando campos aos objetos](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/adicionando-campos-aos-objetos.md) * [Adicionando filtros aos objetos](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/adicionando-filtros-aos-objetos.md) * [Definindo o mapeamento de registros do objeto](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/definindo-o-mapeamento-de-registros-do-objeto.md) #### Organizações Uma migração de dados pode ser executada apenas entre organizações que tenham o app Data Migrator atribuído. Se uma organização que você deseja usar não estiver listada, atribua o Data Migrator a ela no app Configurações globais. Para detalhes, consulte o artigo a seguir sobre como atribuir apps a organizações. * [Atribuindo um aplicativo a uma organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/atribuindo-um-aplicativo-a-uma-organizacao.md) ### Operação Migrar dados vs migração do Data Migrator Como a operação Migrar dados usa o Data Migrator para criar e executar a migração, o resultado final é o mesmo. No entanto, há uma distinção importante entre as duas. No Data Migrator, uma migração é um processo de várias etapas que envolve criar, revisar e executar a migração. Em um pipeline de DevOps, a operação Migrar dados é um processo único que automatiza tanto a criação quanto a execução da migração. Como um pipeline é automatizado, ele ignora a etapa de revisão. Por esse motivo, confirme que a migração funciona corretamente antes de incluí-la em um pipeline crítico. ## Configuração da operação Migrar dados {% hint style="info" %} As instruções abaixo se aplicam à configuração desta operação de pipeline. Para instruções gerais sobre como adicionar uma etapa de pipeline e definir a próxima etapa, consulte o artigo a seguir. [Adicionando uma etapa ao pipeline](/devops/devops-pt-br/pipeline/configurando-as-etapas-do-pipeline/adicionando-uma-etapa-ao-pipeline.md) {% endhint %} {% stepper %} {% step %} ### Selecionar operação e nome do job 1. Clique no **menu suspenso** Operação. 2. Selecione **Migrar dados**.
3. No **campo de texto Nome do job** insira um nome para o job de migração a ser executado no Data Migrator.
{% endstep %} {% step %} ### Selecionar organizações de origem e destino {% hint style="info" %} Somente organizações com o app Data Migrator atribuído a elas estão disponíveis como origem e destino para migração de dados. Para migrar dados para ou a partir de uma organização que tenha apenas o DevOps atribuído, primeiro atribua o Data Migrator a essa organização no app Configurações globais. Para detalhes, consulte o artigo a seguir sobre como atribuir apps a organizações. * [Atribuindo um aplicativo a uma organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/atribuindo-um-aplicativo-a-uma-organizacao.md) {% endhint %} 1. Clique no **Organização de origem** Operação. 2. Selecione a organização a ser usada como origem da migração.
3. Clique no **Organização de destino** Operação. 4. Selecione a organização a ser usada como destino da migração. {% endstep %} {% step %} ### Selecionar modelo do Data Migrator {% hint style="info" %} Como você não pode ver modelos do Data Migrator no DevOps, você precisa saber o nome do modelo do Data Migrator que deseja usar para esta migração. Se não tiver certeza, abra o Data Migrator para encontrar o nome correto do modelo. Veja o artigo a seguir para saber mais sobre modelos do Data Migrator. * [Visão geral dos modelos](/data-migrator/data-migrator-pt-br/modelos/designer-de-modelos/visao-geral-dos-modelos.md) {% endhint %} 1. Clique no **Modelo** Operação. 2. Selecione o modelo a ser usado para a migração de dados.
{% endstep %} {% endstepper %} ## Resultados de Migrar dados {% hint style="info" %} Depois que um pipeline é iniciado, seu progresso e resultados podem ser visualizados na **Atividades** aba da branch que executou o pipeline. As instruções abaixo mostram como revisar os resultados desta operação. Para instruções gerais sobre como acessar os resultados do pipeline a partir da branch, consulte o artigo a seguir. * [Visualizando os resultados do pipeline](/devops/devops-pt-br/pipeline/acoes-do-pipeline/visualizando-os-resultados-do-pipeline.md) {% endhint %} {% stepper %} {% step %} ### Resumo e log Depois que o job Migrar dados for concluído, você pode ver o resumo dos შედეგados selecionando a **Migrar dados** etapa nos resultados do pipeline.
O **Resumo** dos resultados de Migrar dados exibe as seguintes informações:
CamposDescrição
Status

Concluído se o job de migração tiver terminado de executar. Uma migração ainda é considerada concluída mesmo que ela tenha Registros com falha.

Exceção se um problema impediu que o job de migração fosse executado. Verifique os logs para solucionar o problema.

DuraçãoTempo que o job Migrar dados levou para ser concluído, mostrado em horas, minutos e segundos.
Data de início/términoA data e a hora em que o job Migrar dados foi iniciado e concluído.
Total de objetosNúmero total de objetos incluídos na migração.
Total de registrosNúmero total de registros na migração, incluindo registros bem-sucedidos e com falha.
Registros com falhaNúmero de registros que falharam na migração.
LogEntradas de log do job Migrar dados. Use o log para revisar o status do job e quaisquer mensagens de erro.
Exemplo de um log de Migrar dados: {% code overflow="wrap" expandable="true" %} ``` [1º de jun. de 2026 16:00]: [info] Job iniciado [1º de jun. de 2026 16:02]: [info] Job concluído ``` {% endcode %} {% endstep %} {% step %} ### Ver resultados Para ver mais detalhes sobre a migração, abra os resultados. 1. Clique **Ver resultado**.
2. Uma nova guia do Data Migrator é aberta e exibe os resultados do job de migração.
3. Para obter instruções detalhadas sobre como revisar os resultados da migração, veja o artigo abaixo. 1. [Visualizando os resultados da migração](/data-migrator/data-migrator-pt-br/historico/visualizando-os-resultados-da-migracao.md) {% hint style="info" %} Você pode reverter uma migração de dados no app Data Migrator. Para obter instruções, veja o artigo abaixo. * [Revertendo uma migração](/data-migrator/data-migrator-pt-br/historico/revertendo-uma-migracao.md) {% endhint %} {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.flosum.com/devops/devops-pt-br/pipeline/operacoes-do-pipeline/operacao-do-pipeline-migrar-dados.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.