Criar recursos de pipeline

Aprenda a criar os recursos necessários para usar Pipelines.

Tópicos Relacionados

Criar conexões

No momento, os Pipelines do OCI GoldenGate só suportam Oracle Autonomous Databases com pontos finais dedicados. Para obter melhores resultados, use o Autonomous Transaction Processing como banco de dados de origem e o Autonomous Data Warehouse como banco de dados de destino.

Antes de criar um pipeline, certifique-se de primeiro criar conexões com seus bancos de dados de origem e destino. Consulte Estabelecer Conexão com Oracle Autonomous Databases.

Criar pipelines

Antes de começar:
Verifique se:
  • Revise e configure a exclusividade de linha nas tabelas de banco de dados para evitar problemas de chave primária com espelhamento ZeroETL. Chaves primárias identificam exclusivamente um registro ou uma linha em uma tabela de banco de dados. Consulte Garantindo a exclusividade de linha em tabelas de origem e de destino.
  • Como usuário com privilégios de administrador para o banco de dados de destino, conceda os seguintes privilégios ao usuário GGADMIN para espelhamento ZeroETL:
    GRANT DWROLE TO GGADMIN
GRANT DATAPUMP_CLOUD_EXP TO GGADMIN
GRANT DATAPUMP_CLOUD_IMP TO GGADMIN
GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO GGADMIN
GRANT CREATE DATABASE LINK TO GGADMIN
  • Verifique a view DBA_GOLDENGATE_SUPPORT_MODE no banco de dados de origem que exibe informações sobre o nível de suporte do processo de captura do Oracle GoldenGate para as tabelas no banco de dados.
  • Adicione as políticas mínimas necessárias para pipelines GoldenGate.
  • As conexões de origem e destino que você está usando para o pipeline têm pontos finais Dedicados.
Para criar um pipeline:
  1. Na página Visão Geral do OCI GoldenGate, no menu GoldenGate, clique em Pipelines.

    Como alternativa, você pode clicar em Data Fabric e, em seguida, em Criar pipeline.

  2. Na página Pipelines, clique em Criar pipeline.
  3. No painel Criar pipeline, preencha os campos conforme a seguir e clique em Criar pipeline:
    1. Para Nome, digite um nome para o pipeline.
    2. (Opcional) Para Descrição, digite uma descrição para ajudar a distinguir esse pipeline de outros.
    3. Para Compartimento, selecione o compartimento no qual criar o pipeline.
    4. Selecione um tipo de licença.
    5. Selecione suas conexões de origem e destino nas listas suspensas.

      Observação:

      Atualmente, os pipelines suportam apenas conexões com pontos finais dedicados.
    6. (Opcional) Clique em Mostrar opções avançadas para configurar as opções de Processo:
      • Copiar dados existentes antes da replicação contínua: Selecione esta opção para executar um carregamento inicial dos dados. Para tabelas existentes, você pode optar por:
        • Truncar: Exclui linhas existentes e, em seguida, carrega linhas da origem.
        • Substituir: elimina a tabela existente e, em seguida, cria e carrega a tabela da origem.
        • Anexar: Deixa as linhas existentes inalteradas e carrega as linhas da origem.
        • Ignorar: Deixa a tabela como está e passa para o próximo objeto.
      • Substituir alterações de esquema (DDL): Quando selecionado, escolha qual ação executar nos esquemas existentes quando o processo encontrar um erro:
        • Encerrar: reverte a transação e interrompe o processamento.
        • Descartar: Registre o erro no arquivo de descarte e continue o processamento.
        • Ignorar: ignore o erro e continue o processamento.
      • Ação em caso de erro DML: Selecione a ação a ser executada nos dados existentes quando o processo encontrar um erro DML:
        • Encerrar
        • Descartar
        • Ignorar
      • Reiniciar após falha: Selecione esta opção para ativar a reinicialização automática caso o processo seja interrompido por qualquer motivo.
      • Iniciar pipeline usando mapeamento padrão: Inicia o pipeline imediatamente após a criação com as regras de mapeamento padrão 1:1. Se não estiver selecionada, você poderá configurar os mapeamentos de regra após a criação e, em seguida, iniciar manualmente o pipeline.

Adicionar regras de mapeamento

Para visualizar, adicionar ou remover regras de mapeamento:
  1. Na página de informações do Pipeline, selecione Regras de mapeamento.
  2. Na lista Regras de mapeamento, você pode revisar ou editar as regras de mapeamento atuais e:
    • Visualizar: Verifique como suas regras de mapeamento afetam os esquemas e tabelas incluídos na replicação.
    • Adicionar: Identifique tabelas e esquemas a serem incluídos ou excluídos. Você pode usar o nome do objeto totalmente qualificado ou curingas no lugar de qualquer parte do nome do objeto. Para obter mais informações, consulte Usando Curingas em Nomes de Objetos de Banco de Dados.
    • Remover: Remove regras de mapeamento.

Ativar logs de pipeline

  1. Na página Pipelines, selecione o pipeline para o qual você deseja ativar o registro em log.
  2. Na página Detalhes das pipelines, selecione Logs.
  3. Na lista de logs de pipeline, selecione Ativar log no menu Ações de Eventos Críticos.
  4. No painel Ativar log:
    1. Para Nome do log, digite um nome.
    2. Na lista drop-down Compartimento, selecione um compartimento.
    3. Para Grupo de logs, você pode:
      • Selecione um grupo na lista suspensa
      • Criar um novo grupo
      • Deixe-o em branco e um grupo padrão será atribuído automaticamente
    4. Para Retenção de log, selecione o número de meses na lista drop-down.
    5. Clique em Ativar log.
Aguarde até que o status se torne Ativo.

Iniciar o pipeline

Para iniciar o pipeline:
  1. No menu Ações da página de detalhes do pipeline, selecione Iniciar.
  2. Na página de detalhes do pipeline, selecione Inicialização.

    As etapas de Inicialização exibem o status atual das etapas do pipeline. Para cada etapa, você pode selecionar Exibir detalhes no menu Ações e verificar as mensagens correspondentes.

  3. Depois que o status do Pipeline for Ativo (Em Execução), selecione Runtime.

    Os processos de runtime exibem o estado e a latência dos processos Capturar e Aplicar.

Problemas conhecidos

O Oracle Data Pump falhará se a versão do arquivo de fuso horário do banco de dados de destino for inferior à do banco de dados de origem.

A opção de pipeline, "Copiar dados existentes para o banco de dados de destino antes de iniciar a replicação", usa o Oracle Data Pump. O Oracle Data Pump falhará se a versão do arquivo de fuso horário do banco de dados de destino for inferior à do banco de dados de origem.

Solução alternativa: Para contornar isso, você deve fazer upgrade da versão do fuso horário do banco de dados de destino. Consulte Gerenciar atualizações de arquivo de fuso horário no Autonomous Database.