Adicionar uma Extração para o Amazon DocumentDB

Extract é um processo executado na conexão de origens de dados e extrai, ou captura, dados. Aprenda a adicionar um Extract para o Amazon DocumentDB.

Antes de começar

Certifique-se de verificar os detalhes específicos desse tipo de conexão de origem.

Adicionar a Extração

  1. No menu para navegação na console da implantação do OCI GoldenGate, selecione Extrações.

  2. Na página Extrações, selecione Adicionar Extração.

  3. 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.

  4. 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

  5. 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.

  6. 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.

  7. 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.

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.