Adicionar uma Extração para MongoDB

Extract é um processo executado na conexão de origens de dados e extrai, ou captura, dados. Aprenda a adicionar uma Extração para MongoDB.

Adicionar uma Extração (26ai)

Antes do início, verifique se você:

Revise os detalhes específicos desse tipo de conexão de origem.
Configurar um conjunto de replicat do MongoDB:
- O OCI GoldenGate for Big Data usa o log de operações (oplog) para ler registros do Change Data Capture (CDC). O oplog é uma coleção limitada no MongoDB que mantém um registro contínuo de todas as operações que modificam o banco de dados. Os arquivos Oplog são criados quando um conjunto de réplicas é ativado no MongoDB.
- O MongoDB Atlas vem pré-configurado com um conjunto Replicat. Para implantações no MongoDB on-premises, você deve configurar e implantar manualmente um conjunto Replicat para ativar a funcionalidade oplog e CDC. Para MongoDB on-premises, você precisa implantar um conjunto de Réplicas.
Tem MongoDB versão 3.6 ou posterior.
Ter suporte do OCI GoldenGate para capturar as seguintes operações: INSERT, UPDATE, DELETE.

Para adicionar um Extract em para MongoDB:

No menu para navegação na console da implantação do OCI GoldenGate, selecione Extrações.
Na página Extrações, selecione Adicionar Extração.
No painel Adicionar Extract, na página Informações de Extração, preencha os seguintes campos conforme necessário e selecione Próximo:
- Informe um Nome do Processo, com no máximo 8 caracteres.
- Informe uma Descrição (opcional) para ajudá-lo a distinguir esse processo de outros.
- Selecione uma Origem na lista drop-down.
Na página Opções de Extração, preencha os seguintes campos conforme necessário e selecione Próximo:
1. Para Extrair Trilha:
  1. Informe um Nome para o processo de Extração.
  2. Digite um Nome de subdiretório para definir um local personalizado para o arquivo de Trilha gerado.
  3. Informe a Sequência de Trilha para definir o número inicial dos arquivos de Trilha.
  4. Informe um Tamanho de Trilha para definir o tamanho máximo do arquivo da trilha gerado.
  5. Selecione um Perfil de Criptografia. O perfil Wallet Local será selecionado por padrão se um perfil de criptografia não tiver sido criado.
  6. Selecione um Algoritmo de Criptografia:
    - NONE
    - AES256
    - AES192
    - AES128
2. Para Credenciais de Origem, selecione:
  1. Domínio
  2. Alias
  3. Quando/onde Begin
Na página Opções Gerenciadas, preencha os seguintes campos opcionais conforme necessário e selecione Próximo:
- Nome do Perfil
- Crítico para a integridade da implantação
- Iniciar Automaticamente
- Reinício Automático
  
  Observação: A adição de um perfil e a configuração das opções Início Automático e Reinicialização Automática permitem que sua implantação seja reiniciada automaticamente após uma interrupção da rede. Consulte Configurar processos gerenciados para saber mais.
Na página Arquivo de Parâmetros, atualize o mapeamento de origem com TABLE source.*;

Observação: Este é o mapeamento de banco de dados/coleta de origem. TABLE *.*; resulta na extração do processo de todos os bancos de dados/coleções.
Selecione Criar e Executar para criar e iniciar o processo de Extract. Se você selecionar Criar, poderá iniciar manualmente a Extração posteriormente na página Extrações.

Adicionar um processo de extração (21c)

Na console de implantação OCI GoldenGate, certifique-se de estar na página Visão Geral do Serviço de Administração e selecione Adicionar Extract (ícone de adição).
Na página Adicionar Extração, para o tipo de Extração, selecione uma das seguintes opções e, em seguida, selecione Próximo:
- Carga Inicial
- Alterar Captura de Dados
Na página Opções de Extração, preencha os campos da seguinte forma e selecione Próximo:
1. Para Nome do Processo, informe um nome para o processo de Extração.
2. Para Alias de Conexão, selecione o alias de conexão no menu suspenso.
3. Para Origem, selecione Arquivo.
4. Para Nome do Arquivo, digite no mínimo três caracteres para o nome do arquivo.
5. (Opcional) Em Opções Gerenciadas, você pode configurar o seguinte:
  - Nome do Perfil
  - Iniciar Automaticamente
  - Reinício Automático
  Observação: A adição de um perfil e a configuração das opções Início Automático e Reinicialização Automática permitem que sua implantação seja reiniciada automaticamente após uma interrupção da rede. Consulte Configurar processos gerenciados para obter mais informações.
Na página Arquivo de Parâmetros, atualize o mapeamento de origem com TABLE source.*;

Observação: Este é o mapeamento de banco de dados/coleta de origem. TABLE *.*; resulta na extração do processo de todos os bancos de dados/coleções.
Selecione Criar e Executar.

Volte para a página Visão Geral do Serviço de Administração. Selecione o nome do processo Extract para exibir detalhes e relatórios do processo Extract.

Problemas conhecidos

Falha nos processos Replicat ao usar o arquivo de Trilha do MongoDB Extract com BINARY_JSON_FORMAT

Quando um Replicat usa um arquivo de Trilha gerado de um Extract MongoDB com BINARY_JSON_FORMAT no arquivo de parâmetros do Extract, o Replicat falha com o seguinte erro:

ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
java.nio.charset.MalformedInputException: Input length = 1 at
java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
[ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread "main"
oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)

Solução alternativa: Quando BINARY_JSON_FORMAT é removido dos parâmetros de Extract, o Replicat é executado com sucesso e os documentos são representados no formato JSON Estendido.