Adicionar um processo de Replicat ao OCI Object Storage

Aprenda a adicionar e configurar um processo de Replicat para um destino do OCI Object Storage.

Tópicos Relacionados

Antes de começar

Antes de adicionar o Replicat, certifique-se de que você tem o seguinte:

  • OCID do Compartimento

    Dica:

    Você pode encontrar o OCID do compartimento na página Detalhes do Compartimento.
    1. Abra o menu de navegação da console do Oracle Cloud, selecione Identidade e Compartimentos.
    2. Selecione seu compartimento na lista para acessar a página Detalhes do Compartimento.
    3. Copie o OCID do compartimento na seção Informações do Compartimento.

    Para obter mais informações, consulte Localizar o OCID de um Compartimento.

  • Nome do bucket do OCI Object Storage

    Dica:

    A Oracle recomenda que você crie seu próprio bucket do OCI Object Storage.
    1. Abra o menu de navegação da console do Oracle Cloud, selecione Armazenamento e, em seguida, Buckets.
    2. Clique em Criar Bucket.
    3. No painel Criar Bucket, informe um nome e clique em Criar.

    Para obter mais informações, consulte Usando a Console para criar um bucket.

Adicionar um Replicat (23ai)

Antes de começar

Certifique-se de revisar pré-requisitos específicos desse tipo de alvo.

Para adicionar um Replicat em GoldenGate 23ai:
  1. Na console de implantação do OCI GoldenGate, na Home page do Serviço de Administração, clique em Adicionar Replicat (ícone de mais).
  2. No painel Adicionar Replicat, na página Informações do Replicat, preencha os campos conforme necessário e clique em Próximo:
    • Selecione um Tipo de Replicat:
      • Replicat Clássico
      • Replicat Coordenado
    • Informe um Nome do Processo, com no máximo 5 caracteres.
    • Informe uma Descrição para ajudar a distinguir esse processo de outros.
  3. Na página Opções de Replicado, preencha os campos conforme necessário e clique em Próximo:
    • Trilha de Replicat:
      • Informe um Nome.
      • Informe um Subdiretório, se você espera que o arquivo de Trilha esteja em um local diferente do padrão.
      • Selecione um Perfil de criptografia. Se um perfil de criptografia não tiver sido criado, a Wallet Local será selecionada por padrão.
      • Em Iniciar, selecione o ponto inicial do processamento de dados:
        • Posição no Log (padrão)
        • Now
        • Horário Personalizado
    • Posição da Trilha:
      • Informe o Número de Sequência.
      • Informe a Compensação de RBA.
      • Selecione seu Destino na lista drop-down.

        Observação:

        Dependendo da sua seleção de destino, você pode ter opções adicionais, como locais de Streaming, Estágio e Mesclagem e Preparação.
    • Credenciais do Alvo:
      • Selecione um Domínio.
      • Selecione um Alias dentro do Domínio especificado.
      • Selecione uma Tabela de Ponto de Verificação. Deixe a seleção padrão ou selecione a tabela de checkpoint que você criou para a implantação de destino.
      • Selecione o Número Máximo de Threads (somente Replicats Coordenados).
  4. Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário e clique em Próximo:
    • Selecione um Nome de Perfil, se houver um disponível.
    • Ativar Crítico para integridade da implantação.
    • Ativar e configurar definições de Início Automático.
  5. Na página Arquivo de Parâmetros, você pode adicionar parâmetros para configurar ainda mais o Replicat. Por exemplo:
    table source.table1;

    Se estiver usando o Replicat Coordenado, adicione TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties ao arquivo de parâmetros.

    Observação:

    GoldenGate usa o GMT (Greenwich Mean Time) por padrão. Use SETENV para substituir a definição padrão desse processo Replicat. Essa alteração não se aplica a implantações. Por exemplo: 

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
  6. Na página Arquivo de Propriedades, configure as propriedades Handler de Eventos e Handler de Eventos do OCI conforme necessário e clique em Próximo. Algumas propriedades a serem consideradas para modificação incluem:
    1. gg.handler.name.format: Selecione como formatar os dados de saída. As opções disponíveis incluem:
      • delimitedtext
      • json
      • json_row
      • xml
      • avro_row
      • avro_op
      • avro_row_ocf
      • avro_op_ocf

      Para parquet, você deve aplicar propriedades adicionais. Consulte Parquet do OCI Object Storage para obter detalhes.

    2. gg.handler.name.fileNameMappingTemplate: Gera nomes de arquivos dinamicamente usando Palavras-chave de Modelo.
    3. gg.handler.name.inactivityRollInterval: O GoldenGate cria um arquivo e o mantém aberto para gravação. Essa propriedade fecha o arquivo após o período designado de inatividade (sem transações de entrada) e depois é carregada no OCI Object Storage.
    4. gg.eventhandler.name.compartmentID: Informe o OCID do compartimento.
    5. gg.eventhandler.name.bucketMappingTemplate: Informe o nome do bucket do serviço Object Storage.

    Saiba mais sobre as propriedades Handler de Gravação de Arquivos e configuração do Handler de Eventos do OCI.

    Observação:

    Você também pode adicionar formatadores plugáveis conforme necessário. Para obter mais informações, consulte Formatadores Plugáveis.
  7. Clique em Criar e Executar. Se você clicar em Criar, poderá iniciar manualmente o processo de Replicação mais tarde na Home page do Serviço de Administração.

Adicionar um Replicat (21c)

Para adicionar um processo de Replicat para um destino do OCI Object Storage:
  1. Na console de implantação do OCI GoldenGate, na página Visão Geral do Serviço de Administração, clique em Adicionar Replicat (ícone de mais).
  2. Na página Adicionar Replicat, selecione um Tipo de replicação e clique em Próximo.
    Os tipos de Replicats são:
    • Replicat Clássico
    • Replicat Coordenado
  3. Na página Opções de Replicat, preencha os seguintes campos e clique em Próximo:
    1. Para o Nome do Processo, informe um nome para o processo de Replicat.
    2. (Opcional) Para a Descrição, digite uma descrição curta para distinguir esse processo de outros.
    3. Para o Nome da Trilha, informe um nome com dois caracteres.
    4. Para o Destino, selecione Oracle Object Storage na lista suspensa.
    5. Para Aliases disponíveis ao OCI, selecione o alias na lista suspensa.
  4. Na página Arquivo de Parâmetros, adicione e configure parâmetros Replicat conforme necessário e clique em Próximo.

    Observação:

    • Se estiver usando o Replicat Coordenado, adicione os seguintes parâmetros na segunda linha do Arquivo de Parâmetros:
      TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties

      O uso de replicat coordenado resultará em vários arquivos criados.

      Se omitido, você encontrará o seguinte erro:

      OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
    • GoldenGate usa o GMT (Greenwich Mean Time) por padrão. Use SETENV para substituir a definição padrão. Por exemplo:
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      Saiba mais sobre SETENV.

  5. Na página Arquivo de Propriedades, configure as propriedades Handler de Eventos e Handler de Eventos do OCI conforme necessário e clique em Próximo. Algumas propriedades a serem consideradas para modificação incluem:
    1. gg.handler.name.format: Selecione como formatar os dados de saída. As opções disponíveis incluem:
      • delimitedtext
      • json
      • json_row
      • xml
      • avro_row
      • avro_op
      • avro_row_ocf
      • avro_op_ocf

      Para parquet, você deve aplicar propriedades adicionais. Consulte Parquet do OCI Object Storage para obter detalhes.

    2. gg.handler.name.fileNameMappingTemplate: Gera nomes de arquivos dinamicamente usando Palavras-chave de Modelo.
    3. gg.handler.name.inactivityRollInterval: O GoldenGate cria um arquivo e o mantém aberto para gravação. Essa propriedade fecha o arquivo após o período designado de inatividade (sem transações de entrada) e depois é carregada no OCI Object Storage.
    4. gg.eventhandler.name.compartmentID: Informe o OCID do compartimento.
    5. gg.eventhandler.name.bucketMappingTemplate: Informe o nome do bucket do serviço Object Storage.

    Saiba mais sobre as propriedades Handler de Gravação de Arquivos e Handler de Eventos do OCI.

    Observação:

    Você também pode adicionar formatadores plugáveis conforme necessário. Para obter mais informações, consulte Usando os Formatadores Plugáveis.
  6. Clique emAdicionar e Executar.
Você é retornado à página Visão Geral do Serviço de Administração, na qual pode monitorar o status do processo de Replicat. Clique no nome do processo para exibir seus detalhes e acessar relatórios.

Problemas Conhecidos

Erro de replicação do OCI Object Storage ao usar o Controlador de Recursos

Se um Controlador de Recursos for usado para autenticação, o processo Replicat falhará e encontrará o seguinte erro:
ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Incompatibilidade de OCID do Usuário na conexão do OCI Object Storage (Somente usuários federados)

Se um usuário federado selecionar Utilizar usuário atual ao criar uma conexão do OCI Object Storage, seu OCID não corresponderá ao OCID selecionado pelo sistema.

Solução alternativa: ao criar uma conexão do OCI Object Storage, escolha Especificar outro usuário e, em seguida, informe o OCID do usuário federado.

Para localizar o OCID do usuário, clique em Perfil no cabeçalho global da Console do Oracle Cloud e selecione o nome do usuário. Na página Detalhes do Usuário, em Informações do Usuário, clique em Mostrar para OCID.