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:

• Editar

• Iniciar ou Interromper

• Coletar diagnósticos

• Mover recurso

• Adicionar tags

• Excluir

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 do 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 exibir 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, selecione 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 partir 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 tomar em relação aos esquemas existentes quando o processo encontrar um erro:

    • Encerrar: Reverta a transação e interrompa 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 tomada em relação aos dados existentes quando o processo encontrar um erro DML:

    • Encerrar

    • Descartar

    • Ignorar

  • Reiniciar após falha: Selecione esta opção para ativar o reinício automático 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 1:1 padrão. Se não for selecionada, você poderá configurar os mapeamentos de regras 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. Selecione Iniciar na caixa de diálogo Iniciar pipeline para confirmar essa ação. Em seguida, o pipeline é executado pelas 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 de Captura e Aplicação.

Pausar um pipeline

Você pode pausar um pipeline para interromper temporariamente os processos de Captura e Entrega. Pausar um pipeline não pausará o faturamento desses recursos. Enquanto um pipeline é pausado, você pode editar o pipeline, suas regras de mapeamento e visualizar regras de mapeamento.

Observação: Para interromper o faturamento, você deve interromper o pipeline.

Para pausar um pipeline, selecione Pausar no menu Ações do pipeline.

Quando estiver pronto para que o pipeline continue, selecione Iniciar no menu Ações do pipeline.

Se quiser interromper completamente o pipeline, selecione Interromper.

Interromper um pipeline

Para interromper um pipeline, selecione Interromper no menu Ações de um pipeline Ativo em sua página de detalhes. Selecione Interromper na caixa de diálogo Interromper pipeline para confirmar essa ação.

A interrupção de um pipeline também interrompe o faturamento desses recursos. Você não pode editar o pipeline, seus mapeamentos ou visualizar os mapeamentos quando um pipeline é interrompido e está em um estado Inativo.

Para reiniciar o pipeline, selecione Iniciar no menu Ações do pipeline.

Clonar um pipeline

Você pode clonar um pipeline cujo estado seja Ativo, Inativo ou Precisa de atenção.

Para clonar um pipeline:

• Na página Pipelines, selecione Clonar no menu Ações de um pipeline e siga as etapas abaixo.

• Na página de detalhes de um Pipeline, selecione Clonar no menu Ações.

  1. No painel Clonar pipeline, informe um Nome para o clone do pipeline.

  2. (Opcional) Informe uma descrição para a clonagem do pipeline.

  3. Selecione o Compartimento no qual será criado o clone do pipeline.

  4. (Opcional) Preencha as Opções avançadas conforme necessário.

  5. Selecione Clonar.

Coletar diagnósticos

Colete diagnósticos para analisar ou compartilhar informações sobre seu pipeline do OCI GoldenGate. 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 bucket no qual salvar o arquivo de diagnóstico.

3. Informe um prefixo de nome para o arquivo de diagnóstico.

4. Selecione Coletar diagnóstico.

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:

• Monitorar o desempenho

• Métricas do OCI GoldenGate

Gerenciar regras de mapeamento

Para visualizar, adicionar ou remover regras de mapeamento:

1. Na página 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: Analise como as regras de mapeamento afetam os esquemas e as tabelas incluídos na replicação.

   • Adicionar: Identifica tabelas e esquemas para incluir ou excluir. Você pode usar o nome do objeto totalmente qualificado ou os 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: Remova as regras de mapeamento.

Exibir etapas de inicialização

Se você estiver familiarizado com os processos do 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 os bancos de dados de origem e destino

• Preparar os objetos do banco de dados para extração

• Cria uma Tabela de Pulsação

• Cria e executa o Extract (Capturar)

• Verifique se existem esquemas e tabelas de destino

• Cria a Tabela de Checkpoint

• Cria e executa o 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 de Captura e Aplicação na seção Runtime da página de detalhes do pipeline. Você pode usar essas informações para observar o estado desses processos e agir quando necessário.

Configurar notificações

Você pode configurar notificações para serem mantidas informadas dos 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 Monitoramento, role para baixo até Notificações e selecione Criar notificação.

3. Na página Criar notificação, você pode selecionar:

   • Início Rápido e, em seguida, selecione um modelo de configurações de notificação pré-configuradas.

   • Notificação de evento avançada e selecione regras de Evento que acionem 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 assinaturas:

   1. Crie um novo tópico ou selecione um existente.

   2. Confirme inscrições para receber mensagens.

5. (Opcional) Para notificação de alarme Avançada, expanda Opções avançadas, configure o corpo do Alarme (corpo da mensagem) e o formato da mensagem da notificação.

6. Selecione Enviar.

Gerenciar logs de pipeline

Ativar ou desativar 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 selecione Ativar log:

   1. Para Nome de log, informe um nome para o log.

   2. Na lista drop-down Compartimento, selecione o compartimento no qual o log será criado.

   3. Selecione um Grupo de logs ou selecione 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, selecione 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. Selecione Mover recurso.

Gerenciar tags para 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 deseja excluir esse pipeline e selecione Excluir.

Essa ação não pode ser desfeita.