Adicionar um processo Replicat para o Oracle Object Storage

Aprenda a adicionar e configurar um processo Replicat para uma meta de Oracle Object Storage.

Antes de começar

Antes de adicionar o processo Replicat, verifique se você:

• Considerações de Configuração e Melhores Práticas para o Oracle Object Storage Revisadas

• OCID do Compartimento

  Dica: Você pode encontrar o OCID do compartimento na página de detalhes do Compartimento.

  1. Abra o menu, selecione Identidade e Compartimentos da console do Oracle Cloud.

  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 Oracle Object Storage

  Dica: A Oracle recomenda que você crie seu próprio bucket do Oracle Object Storage.

  1. Abra o menu para navegação na console do Oracle Cloud, selecione Armazenamento e, em seguida, Buckets.

  2. Selecione Criar Bucket.

  3. No painel Criar Bucket, informe um nome e, em seguida, selecione Criar.

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

Adicionar um Processo de Replicat (26ai)

Certifique-se de revisar pré-requisitos específicos para este tipo de destino.

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

2. Na página Replicat, selecione Adicionar Replicat.

3. No painel Adicionar Replicat, na página Informações de Replicat, preencha os campos conforme necessário e selecione 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.

4. Na página Opções de Replicat, preencha os campos conforme necessário e selecione 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.

     • Para Iniciar, selecione o ponto inicial para o processamento de dados:

       • Posição no Log (padrão)

       • Now

       • Horário Personalizado

   • Posição da Trilha:

     • Informe o Nº da Sequência.

     • Insira o Deslocamento de RBA.

     • Selecione seu Destino no menu suspenso.

       Observação: Dependendo da 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 Checkpoint. Deixe a seleção padrão ou selecione a tabela de Checkpoint criada para a implantação do destino.

     • Selecione o Número Máximo de Threads (somente Replicats Coordenados).

5. Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário e selecione Próximo:

   • Selecione um Nome de Perfil, se houver um disponível.

   • Ative Crítico para a integridade da implantação.

   • Habilite e configure as configurações de início automático.

6. Na página Arquivo de Parâmetro, você pode adicionar parâmetros para configurar ainda mais seu processo Replicat. Por exemplo:

   table source.table1;

   Observação:

   O GoldenGate usa o GTM (Greenwich Mean Time, Tempo médio de Greenwich) por padrão. Use SETENV para substituir a definição padrão do processo de Replicat. Esta alteração não se aplica a implantações. Por exemplo:

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

7. Na página Arquivo de Propriedades, configure as propriedades Handler de Arquivos e Handler de Eventos do OCI conforme necessário e selecione 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 para o Oracle Object Storage para obter detalhes.

   2. gg.handler.name.fileNameMappingTemplate: Gera nome de arquivo dinamicamente usando Palavras-chave do Modelo.

   3. gg.handler.name.inactivityRollInterval: O GoldenGate cria um arquivo e o mantém aberto para gravação. Esta propriedade fecha o arquivo após o período designado de inatividade (sem transações recebidas) e, em seguida, é carregado no Oracle Object Storage.

   4. gg.eventhandler.name.compartmentID: Informe o OCID do compartimento.

   5. gg.eventhandler.name.bucketMappingTemplate: Informe o nome da definição do Object Storage.

   Saiba mais sobre as propriedades Manipulador do Gravador 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.

8. Selecione Criar e Executar. Se você selecionar Criar, poderá iniciar manualmente o processo Replicat posteriormente na página Replicats.

Adicionar um Processo de Replicat (21c)

1. Na console de implantação da OCI GoldenGate, na página Visão Geral do Serviço de Administração, selecione Adicionar Replicat (ícone de adição).

2. Na página Adicionar Processo de Replicat, selecione um tipo de Processo de Replicat e, em seguida, selecione Próximo

   Os tipos de Replicats são:

   • Replicat Clássico

   • Replicat Coordenado

3. Na página Opções de Replicação, preencha os seguintes campos e selecione 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 Destino, selecione Oracle Object Storage na lista drop-down.

   5. Para aliases Disponíveis para o OCI, selecione seu alias na lista drop-down.

4. Na página Arquivo de Parâmetros, adicione e configure parâmetros do Replicat conforme necessário e selecione Próximo.

   table source.table1;

   Observação:

   O GoldenGate usa o GTM (Greenwich Mean Time, Tempo médio de Greenwich) por padrão. Use SETENV para substituir a definição padrão do processo Extract. Essa alteração só se aplica ao processo Extract e não à implantação.

   setenv (TZ="US/Eastern")
   setenv (TZ="GMT+5")

5. Na página Arquivo de Propriedades, configure as propriedades Handler de Arquivos e Handler de Eventos do OCI conforme necessário e selecione 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 para o Oracle Object Storage para obter detalhes.

   2. gg.handler.name.fileNameMappingTemplate: Gera nome de arquivo dinamicamente usando Palavras-chave do Modelo.

   3. gg.handler.name.inactivityRollInterval: O GoldenGate cria um arquivo e o mantém aberto para gravação. Esta propriedade fecha o arquivo após o período designado de inatividade (sem transações recebidas) e, em seguida, é carregado no Oracle Object Storage.

   4. gg.eventhandler.name.compartmentID: Informe o OCID do compartimento.

   5. gg.eventhandler.name.bucketMappingTemplate: Informe o nome da definição do 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. Selecione Adicionar 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. Selecione o nome do processo para exibir seus detalhes e acessar relatórios.

Conteúdo relacionado

• Detalhe do alvo do Oracle Object Storage

Problemas Conhecidos com conexões do Oracle Object Storage

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

Se a conexão do Oracle Object Storage usar a autenticação do Controlador de Recursos, o processo Replicat falhará com 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

Solução alternativa: para contornar esse problema, edite a conexão e selecione outro método de autenticação.

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

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

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

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