Criar recursos de pipeline

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

Tópicos Relacionados

Criar conexões

Os Pipelines do OCI GoldenGate suportam conexões do Oracle Database. Antes de criar um pipeline, certifique-se de primeiro preparar seu banco de dados para o GoldenGate e, em seguida, criar conexões com seus bancos de dados de origem e de destino.

Observação:

Se você estiver replicando de uma origem do Autonomous AI Database para um destino que não seja um Autonomous AI Database, descompacte a wallet do Autonomous AI Database de origem em /u01/targetwallet no banco de dados de destino. DBLINK é criado do banco de dados de destino para o banco de dados de origem.

Você também pode criar conexões de origem e destino de conexão no workflow Criar pipeline.

Criar pipelines

Antes de começar:
Verifique se:
  • Verifique as versões do banco de dados de origem e de destino. A versão do banco de dados de destino deve ser uma versão maior que a do banco de dados de origem.
  • 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;
    Além disso, para bancos de dados não Autonomous AIs, adicione o seguinte para Carga Inicial:
    GRANT DATAPUMP_EXP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT DATAPUMP_IMP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT CREATE DATABASE LINK TO GGADMIN CONTAINER=CURRENT;
    Para Capturar e Aplicar em bancos de dados não Autonomous AIs, analise Preparar usuários e privilégios de banco de dados para a Oracle.
  • 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.

Observação:

Se estiver replicando dados do Autonomous AI Database para um não Autonomous AI Database, você deverá desativar GLOBAL_NAMES no seu não Autonomous AI Database. Execute o seguinte comando:
ALTER SYSTEM SET GLOBAL_NAMES = FALSE;

Consulte a etapa 4 de Criar Links de Banco de Dados de Outros Bancos de Dados para o Autonomous AI Database para saber mais.

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:

      • Se você ainda não tiver criado conexões, clique em Criar conexão para começar.
      • Se estiver usando uma conexão com um ponto final Compartilhado como origem ou destino, você também deverá selecionar uma sub-rede.
    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.