Criar recursos de pipeline

Aprenda a criar recursos necessários para usar Pipelines.

Criar conexões

Os Pipelines do OCI GoldenGate suportam conexões do Oracle AI 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 igual ou superior à do banco de dados de origem.
Revise e configure a exclusividade de linhas nas tabelas do banco de dados para evitar problemas de chave primária com o espelhamento ZeroETL. As chaves primárias identificam exclusivamente um registro ou uma linha em uma tabela de banco de dados. Consulte Garantindo a exclusividade da linha nas 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 AI não autônomos, 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 AI não Autônomos, revise 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 do GoldenGate.

Observação:

Se estiver replicando dados do Autonomous AI Database para um AI Database não autônomo, você deverá desativar a opção GLOBAL_NAMES no seu AI Database não autônomo. 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:

Na página Visão Geral do OCI GoldenGate, no menu do GoldenGate, selecione Pipelines.

Como alternativa, você pode selecionar Data Fabric e, em seguida, Criar pipeline.
Na página Pipelines, selecione Criar pipeline.
No painel Criar pipeline, preencha os campos da seguinte forma e selecione Criar pipeline:
1. Para Nome, informe um nome para o pipeline.
2. (Opcional) Para Descrição, digite uma descrição para ajudar a distinguir esse pipeline de outros.
3. Em Compartimento, selecione o compartimento no qual o pipeline será criado.
4. Selecione um tipo de licença.
5. Selecione suas conexões de origem e destino nas listas drop-down.
  Observação:
  - Se você ainda não tiver criado conexões, selecione 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) Expanda Opções avançadas para configurar 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 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.
  - Tipo de Carga Inicial: Selecione o método para transferir um conjunto de dados completo da origem para o destino antes de iniciar a replicação contínua:
    - Link do Banco de Dados: Transfere dados diretamente do banco de dados de origem para o banco de dados de destino usando um link de banco de dados estabelecido, sem armazenamento intermediário. Funciona melhor para bancos de dados localizados na mesma rede ou conectados através de um link estável e de alta velocidade.
    - Object Storage: Prepara os dados de carregamento inicial no Oracle Object Storage antes de importá-los para o banco de dados de destino. Funciona melhor para migrações que envolvem grandes volumes de dados em diferentes regiões ou ambientes.
      
      Saiba mais sobre os tipos de Carga Inicial.
  - 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.

Adicionar regras de mapeamento

Para visualizar, adicionar ou remover regras de mapeamento:

Na página Informações do pipeline, selecione Regras de mapeamento.
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.

Ativar logs de pipeline

Na página Pipelines, selecione o pipeline cujo registro em log você deseja ativar.
Na página Detalhes das pipelines, selecione Logs.
Na lista de logs de pipeline, selecione Ativar log no menu Ações de Eventos Críticos.
No painel Ativar log:
1. Para Nome de log, informe um nome.
2. Na lista drop-down Compartimento, selecione um compartimento.
3. Para o grupo de logs, você pode:
  - Selecione um grupo no drop-down
  - 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 no menu suspenso.
5. Selecione Ativar log.

Aguarde o status se tornar Ativo.

Iniciar o pipeline

Para iniciar o pipeline:

No menu Ações da página de detalhes do pipeline, selecione Iniciar.
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.
Após o status do Pipeline ser Ativo (Em Execução), selecione Tempo de Execução.

Os processos de runtime exibem o estado e latência dos processos de Captura e Aplicação.

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 à versão 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 AI Database.