> 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/data-migrator/data-migrator-pt-br/historico/revertendo-uma-migracao.md).

# Revertendo uma migração

## ![](https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcfMTqg4Brbm9baWutclZ%2FSummary2-Small-Icon.svg?alt=media\&token=d1cf162d-c02d-4184-988e-7f7350e450fc) Visão geral

Este artigo explica como funciona uma reversão de migração de dados e como realizá-la. Uma reversão restaura os registros migrados da sua organização para seus valores anteriores à migração: os registros atualizados são restaurados para seus valores anteriores, e os registros inseridos são excluídos.

### **Como a reversão funciona**

Uma reversão restaura os registros migrados ao estado anterior à migração. Para manter a integridade dos dados, uma reversão restaura todos os objetos, registros e campos definidos no modelo de migração.

O Data Migrator usa dois comandos para migrar registros: UPDATE e INSERT. Cada comando é tratado de forma diferente durante uma reversão.

**UPDATE**

O comando UPDATE se aplica a registros que são correspondidos entre as organizações de origem e de destino por meio do mapeamento de registros. Antes que o Data Migrator aplique a atualização ao registro de destino, ele salva um instantâneo desse registro. O instantâneo inclui apenas os campos definidos no modelo de migração. Durante uma reversão, o Data Migrator aplica o instantâneo ao registro de destino, retornando os campos migrados aos seus valores anteriores à migração.

**INSERT**

O comando INSERT migra um novo registro para a organização de destino. Quando um registro é inserido, o Data Migrator registra o ID do novo registro. Durante uma reversão, o Data Migrator usa esse ID para identificar o registro inserido e, como o registro não existia na organização de destino antes da migração, ele o exclui.

{% hint style="warning" %}

#### **Possível perda de dados**

Uma reversão restaura os registros para seus valores anteriores à migração, então quaisquer alterações feitas em um registro após a migração também são perdidas. Isso se aplica aos registros que foram atualizados ou inseridos durante a migração.
{% endhint %}

#### **Disponibilidade e limitações da reversão**

* As reversões estão atualmente disponíveis por tempo indeterminado. Uma futura atualização do Data Migrator poderá adicionar um limite de tempo para o período em que uma reversão permanece disponível. Se um limite for introduzido, esta nota será atualizada para refletir a mudança.
* Você não pode selecionar objetos específicos e revertê-los individualmente.
* Para migrações de dados realizadas antes do lançamento do recurso de reversão, o **Rollback** botão não estará disponível.

#### **Como os dados de reversão são armazenados**

O Data Migrator migra registros diretamente da organização de origem para a organização de destino em um único processo em trânsito. Ele persiste apenas os resultados da migração e o instantâneo de reversão.

Antes de uma migração ser executada, o Data Migrator armazena um instantâneo dos registros existentes para que a migração possa ser revertida. Os dados armazenados dependem do comando usado:

* **Registros inseridos:** Apenas os IDs dos registros são armazenados. Durante uma reversão, esses IDs são usados para excluir os registros inseridos.
* **Registros atualizados:** Apenas os valores dos campos necessários para restaurar cada registro ao seu estado anterior à migração são armazenados.

#### **Criptografia**

O instantâneo de reversão é criptografado em repouso usando SSE-S3 (chaves gerenciadas pela AWS) e armazenado no seu tenant do Data Migrator. Os dados também são criptografados em trânsito durante a migração. O Data Migrator atualmente não oferece suporte a Bring Your Own Key (BYOK).

## Migração de reversão

{% stepper %}
{% step %}

### Selecionar migração

1. Clique em **Histórico** no menu da barra lateral esquerda.
2. Clique no menu suspenso **Migrar** operação que você deseja reverter.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FqwHkiA9mKpFLbSIAS6vP%2FRollingBackAMigration-S01-01.png?alt=media&amp;token=8d4a07e6-3b4d-4ffc-b42a-4d372b506665" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Iniciar reversão

1. Clique em **Rollback**.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FtKrtEm24GmfWvjNk9hQQ%2FRollingBackAMigration-S02-01.png?alt=media&amp;token=3c34cdb2-6618-4693-a270-ee2db2a906fd" alt="" width="563"><figcaption></figcaption></figure></div>
2. Revise a tabela para ver o número total de registros a serem revertidos, quantos serão restaurados e quantos serão excluídos.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FWlh4DiuXTxoQPezD7kR8%2FRollingBackAMigration-S02-02.png?alt=media&amp;token=78dc71e2-810a-4b01-9cfc-18f2c5fd1521" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Durante uma reversão, cada registro é restaurado ou excluído, dependendo de como foi migrado.

* **Restaurados**: Registros que existiam antes da migração foram migrados com uma operação UPDATE. Esses registros são restaurados aos seus valores anteriores.
* **Excluídos**: Registros adicionados durante a migração foram migrados com uma operação INSERT. Esses registros são excluídos porque não existiam antes da migração.
  {% endhint %}
  {% endstep %}

{% step %}

### (Opcional) Desativar automações

Ao executar uma reversão, os processos automatizados do Salesforce permanecem ativos por padrão. Para impedir que esses processos sejam acionados durante a reversão, você pode desativá-los seletivamente no nível do objeto. Desativar automações para um objeto afeta somente esse objeto.

Cada processo abaixo é desativado individualmente para cada objeto no modelo.

* **Triggers**
* **Fluxos de trabalho**
* **Fluxos**
* **Regras de validação**
* **Filtros de pesquisa**

Os processos automatizados são desativados apenas durante a reversão e são restaurados assim que a reversão é concluída.

{% hint style="warning" %}
As automações são desativadas apenas para os objetos em que foram selecionadas. Elas permanecem ativadas para os outros objetos no modelo. Desative as automações para cada objeto que você deseja afetar.
{% endhint %}

1. Para desativar as automações do Salesforce para um objeto, clique em **Automações**.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FWJrLVXDkSJo5MSh4qJyI%2FRollingBackAMigration-S03-01.png?alt=media&amp;token=a71ee296-ffb0-4dd5-bdcb-57938ab98231" alt="" width="563"><figcaption></figcaption></figure></div>
2. Marque quaisquer automações que você deseja desativar.
3. Clique em **Salvar**.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FRAvBwYkj0W729Neqn6N4%2FRollingBackAMigration-S03-02.png?alt=media&amp;token=cc8d49f7-11ae-4468-8f5c-166f10ce1133" alt="" width="375"><figcaption></figcaption></figure></div>
4. Quando as automações estão desativadas para um objeto, o **Automações** botão exibirá um ponto vermelho.
5. Repita isso para todos os objetos para os quais você deseja desativar as automações.
   {% endstep %}

{% step %}

### Executar reversão

1. Clique em **Executar** para iniciar a tarefa de reversão.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2Fo65HG6F5z8ts3ElD5Zr0%2FRollingBackAMigration-S04-01.png?alt=media&amp;token=d3adeee6-cc05-4540-a296-028d6aae46fe" alt="" width="563"><figcaption></figcaption></figure></div>
2. Depois que você iniciar a tarefa de reversão, ela aparecerá na página **Histórico** .

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FZtyNkDZHXRVSFa5r4YEW%2FRollingBackAMigration-S04-02.png?alt=media&amp;token=b5e36dac-1fa5-440a-9910-51a39c4193c8" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Revisar reversão

Depois que a reversão for concluída, você pode revisar os resultados para ver quais registros foram alterados e se ocorreu algum erro. A página de resultados da tarefa de reversão é muito semelhante à página de resultados da tarefa de migração, então as etapas abaixo fornecem apenas uma breve visão geral.

{% hint style="info" %}
Para mais detalhes, consulte o artigo a seguir sobre como visualizar os resultados da migração.

* [Visualizando os resultados da migração](/data-migrator/data-migrator-pt-br/historico/visualizando-os-resultados-da-migracao.md)
  {% endhint %}

1. Clique em **Histórico** no menu da barra lateral esquerda.
2. Clique no menu suspenso **Rollback** operação que você deseja revisar.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2Fed3CKhhgswoaoEavb6SL%2FRollingBackAMigration-S05-01.png?alt=media&amp;token=68683c94-f139-46b9-bd25-431cb359c574" alt="" width="563"><figcaption></figcaption></figure></div>
3. Verifique se há algum **Registros com falha**.
4. Clique em cada objeto na tela do modelo para ver os resultados detalhados do objeto.

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcDP0cBauc5rTSNOTt0pL%2FRollingBackAMigration-S05-02.png?alt=media&amp;token=5c6cfebb-14aa-4b6b-b236-587c33fca90e" alt="" width="563"><figcaption></figcaption></figure></div>
5. Cada registro que foi revertido indicará se ele foi excluído ou restaurado na coluna **Operação** .

   <div align="left"><figure><img src="https://3756291079-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FTnSO2pvDXXEFYeL6PYrd%2FRollingBackAMigration-S05-03.png?alt=media&amp;token=0b9e118f-84af-48ea-b694-445ec53cc828" alt="" width="563"><figcaption></figcaption></figure></div>

{% 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/data-migrator/data-migrator-pt-br/historico/revertendo-uma-migracao.md?ask=<question>&goal=<user_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.
