Adicionar uma Extração para MongoDB

Extract é um processo que é executado mediante a conexão da origem de dados de origem e que extrai ou captura dados. Aprenda a adicionar uma Extração para MongoDB.

Tópicos Relacionados

Adicionar uma Extração (26ai)

Antes do início, verifique se você:
  • Revise os detalhes específicos deste tipo de conexão de origem.
  • Configure um conjunto de replicados MongoDB:
    • O OCI GoldenGate para Big Data usa o log de operações (plog) para ler registros do Change Data Capture (CDC). O oplog é uma coleção limitada no MongoDB que mantém um registro incremental de todas as operações que modificam o banco de dados. Os arquivos Oplog são criados quando um conjunto de réplicas é ativado em MongoDB.
    • MongoDB O Atlas vem pré-configurado com um conjunto Replicat. Para implantações MongoDB on-premises, configure e implante manualmente um conjunto Replicat para ativar a funcionalidade oplog e CDC. Para o MongoDB on-premises, você precisa implantar um conjunto de Réplicas.
  • Ter o MongoDB versão 3.6 ou posterior.
  • Ter suporte ao OCI GoldenGate para capturar as seguintes operações: INSERT, UPDATE, DELETE.
Para adicionar um processo Extract em MongoDB:
  1. No menu da navegação da console de implantação do OCI GoldenGate, clique em Extrações.
  2. No painel Adicionar Extract, na página Informações de Extração, preencha os seguintes campos conforme necessário e clique em 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.
  3. Na página Opções de Extração, preencha os seguintes campos conforme necessário e clique em 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 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. Apelido
      3. Quando/onde Iniciar
  4. Na página Opções Gerenciadas, preencha os seguintes campos opcionais conforme necessário e clique em 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.

  5. 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.
  6. Clique emCriar e Executar para criar e iniciar o processo de Extract. Se você clicar em Criar, poderá iniciar manualmente o processo Extract mais tarde na página Extracts.

Adicionar um Processo de Extração (21c)

Aprenda a adicionar um processo de Extract para uma origem MongoDB no OCI GoldenGate

Para adicionar um processo Extract para MongoDB:
  1. Na console de implantação do OCI GoldenGate, certifique-se de estar na página Visão Geral do Serviço de Administração e, em seguida, clique em Adicionar Extract (ícone de adição).
  2. Na página Adicionar Extração, para o tipo de Extração, selecione uma das seguintes opções e clique em Próximo:
    • Carga Inicial
    • Alterar Captura de Dados
  3. Na página Opções de Extração, preencha os campos da seguinte forma e clique em Próximo:
    1. Em Nome do Processo, informe um nome para o processo Extract.
    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 três caracteres no mínimo 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.
  4. 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.
  5. Clique emCriar e Executar.
Volte para a página Visão Geral do Serviço de Administração. Clique no nome do processo Extract para exibir detalhes e relatórios do processo Extract.

Problemas conhecidos

Replicats falha ao usar Trail file do MongoDB Extract com BINARY_JSON_FORMAT

Quando um Replicat usa uma Trail file gerada de uma MongoDB Extract com BINARY_JSON_FORMAT no arquivo de parâmetros Extract, a 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 Extract, o Replicat é executado com êxito e os documentos são representados no formato JSON estendido.