Gerenciar pipelines

Explore as tarefas de gerenciamento de pipeline essenciais para trabalhar com pipelines do OCI GoldenGate.

Exibir detalhes do pipeline

Selecione um pipeline na página Pipelines para exibir seus detalhes. Na página de detalhes do pipeline, você pode exibir o status do pipeline, que pode ser um dos seguintes:
  • Criando
  • Ativo (Interrompido)
  • Ativo (Em execução)
  • Atualizando
  • Requer atenção
  • Com Falha
Você também pode editar o pipeline ou usar o menu Ações para executar outras ações, como: Alterne para outra guia para exibir outras informações de pipeline relacionadas.

Informações de pipeline

A página de informações do Pipeline exibe informações gerais sobre esse recurso, como seu OCID, compartimento no qual ele reside, quando ele foi criado e atualizado pela última vez etc.

Regras de mapeamento

Adicione, remova ou visualize regras de mapeamento que alteram o mapeamento um a um padrão de tabelas de origem e esquemas para o destino.

Inicialização

Exibir etapas de inicialização que exibem o status atual das etapas do pipeline. Você pode selecionar qualquer etapa para exibir seus detalhes.

Runtime

Exiba o status e a latência de tempo de execução.

Serviço Monitoring

Exiba métricas de pipeline, ative ou desative logs de eventos críticos e crie e exiba notificações.

Solicitações de serviço

Exiba o status das solicitações de serviço do pipeline. As operações de pipeline que criam solicitações de serviço incluem:

  • Criar
  • Início
  • Interromper
  • Atualização
  • Excluir
  • Mover
  • Coletar diagnósticos

Marcas

As tags ajudam a localizar recursos em sua tenancy. Você pode adicionar e ver as tags de um pipeline na página Pipelines e da página de detalhes do pipeline. Consulte gerenciar tags.

Editar um pipeline

Para editar um pipeline, clique em Editar na página de detalhes do pipeline. No painel de edição, você pode editar:

  • Nome
  • Descrição
  • Opções do processo:

    Observação:

    Reinicie o pipeline para que as alterações entrem em vigor.
    • 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.

Iniciar um pipeline

Para iniciar um pipeline, selecione Iniciar no menu Ações de um pipeline inativo em sua página de detalhes. Clique em Iniciar na caixa de diálogo Iniciar pipeline para confirmar essa ação. Em seguida, o pipeline executa as etapas de inicialização com base nas opções de processo selecionadas na criação (ou quando atualizado, se você editou o pipeline) antes de iniciar os processos Capturar e Aplicar.

Interromper um pipeline

Para interromper um pipeline, selecione Interromper no menu Ações de um pipeline Ativo em sua página de detalhes. Clique em Interromper na caixa de diálogo Interromper pipeline para confirmar essa ação. Depois que o pipeline for interrompido e estiver no estado inativo, você poderá clicar em Iniciar para reiniciar o pipeline.

Observação:

Quando você interrompe um Pipeline, ainda é cobrado pelos recursos usados porque uma implantação ainda é executada em segundo plano. Para evitar custos recorrentes, exclua o pipeline.

Coletar diagnósticos

Colete diagnósticos para analisar ou compartilhar informações sobre o pipeline da GoldenGate da OCI. O arquivo de diagnóstico contém registros descartados, se houver, para os processos Capturar e Aplicar.

Para coletar diagnósticos sobre seu pipeline:
  1. Na página de detalhes do pipeline, no menu Ações, selecione Coletar diagnósticos.
  2. No painel Coletar diagnósticos, selecione o compartimento e o bloco no qual salvar o arquivo de diagnóstico.
  3. Informe um prefixo de nome para o arquivo de diagnóstico.
  4. Clique em Coletar diagnósticos.
Após a conclusão do processo de coleta, você poderá fazer download do arquivo de diagnóstico na página de detalhes do pipeline.

Monitorar métricas de pipeline

Na página de detalhes do pipeline, selecione Monitoramento para exibir métricas do pipeline, como utilização de CPU, consumo de OCPU, utilização de Memória e integridade Geral do pipeline. Para obter mais informações sobre métricas disponíveis, consulte

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

Exibir etapas de inicialização

Se você estiver familiarizado com os processos GoldenGate, um pipeline será uma abstração de um processo de replicação de dados. Quando você inicia o pipeline, as etapas de inicialização são executadas de forma linear, criando todos os recursos necessários e preparando bancos de dados para replicação de dados com base nas informações coletadas após a criação. As etapas de inicialização incluem:

  • Verificar o banco de dados de origem e de destino
  • Preparar os objetos de banco de dados para extração
  • Cria uma Tabela de Pulsação
  • Cria e executa o processo Extract (Capture)
  • Verificar se os esquemas e as tabelas de destino existem
  • Cria a Tabela de Checkpoints
  • Cria e executa o processo Replicat (Aplicar)

Você pode selecionar Exibir detalhes no menu Ações de cada etapa de inicialização para revisar o status e as mensagens do sistema correspondentes a cada etapa.

Runtime

Quando seu pipeline estiver Ativo e em execução, você poderá exibir o status e a latência dos processos Capturar e Aplicar na seção Tempo de Execução da página de detalhes do pipeline. Você pode usar essas informações para observar o estado desses processos e tomar medidas quando necessário.

Configurar notificações

Você pode configurar notificações para serem mantidas informadas sobre eventos do pipeline.

Para configurar notificações de evento de pipeline:
  1. Na página de detalhes do pipeline, selecione Monitoramento.
  2. Na página Monitoring, role para baixo até Notifications e clique em Criar notificação.
  3. Na página Criar notificação, você pode selecionar:
    • Início Rápido e selecione em um modelo de configurações de notificação pré-configuradas.
    • Notificação de evento avançada e selecione as regras de Evento que acionam ações para diferentes condições de evento.
    • Notificação de alarme avançada e selecione as métricas para rastrear e acionar regras para que o alarme seja acionado.
  4. Para Tópico e inscrições:
    1. Crie um novo tópico ou selecione um existente.
    2. Confirmar inscrições para receber mensagens.
  5. (Opcional) Para notificação de alarme Avançada, expanda Opções avançadas e configure o corpo do Alarme (corpo da mensagem) e o formato da mensagem da notificação.
  6. Clique em Enviar.

Gerenciar logs de pipeline

Ative ou desative logs de eventos críticos para pipelines do OCI GoldenGate.

Para ativar logs de eventos críticos:
  1. Na página de detalhes do pipeline, selecione Monitoramento.
  2. Na página Monitoramento, role para baixo até Logs.
  3. No menu Ações para Eventos Críticos, selecione Ativar log.
  4. No painel Ativar log, preencha os seguintes campos e clique em Ativar log:
    1. Para Nome do log, digite um nome para o log.
    2. Na lista drop-down Compartimento, selecione o compartimento no qual criar o log.
    3. Selecione um Grupo de logs ou clique em Criar novo grupo.
    4. Selecione um horário de Retenção de log.

Mover um pipeline

Você pode mover um pipeline de um compartimento para outro.

Para mover um pipeline:
  1. Na página Pipelines, selecione o pipeline que deseja mover.
  2. No menu Ações da página de detalhes do pipeline, clique em Mover recurso.
  3. Na caixa de diálogo Mover Recurso para Outro Compartimento, selecione o compartimento para o qual você deseja mover o pipeline.
  4. Clique em Mover recurso.

Gerenciar tags de um pipeline

Você pode adicionar e exibir as tags de um pipeline na página Pipelines e na página de detalhes do pipeline.

Na página Pipelines, no menu Ações de um pipeline, selecione Adicionar Tags ou Exibir Tags.

Na página de detalhes do pipeline, você pode selecionar Tags no menu Ações ou selecionar a guia Tags para exibir e gerenciar tags.

Saiba mais sobre tags.

Excluir um pipeline

Certifique-se de que seu pipeline esteja interrompido e em um estado inativo antes de excluir o pipeline.

Para excluir um pipeline:
  1. Na página Pipelines, selecione o pipeline que deseja excluir.
  2. No menu Ações da página de detalhes do pipeline, selecione Excluir.
  3. Na caixa de diálogo Excluir pipeline, confirme se você deseja excluir esse pipeline e clique em Excluir.
Essa ação não pode ser desfeita.