Adicionar um processo de Extract para o MySQL

Extract é um processo que é executado novamente na conexão da origem de dados de origem e que extrai ou captura dados. Learn to add an Extract for MySQL Database Server, HeatWave, Azure Database for MySQL, HeatWave on AWS, Amazon Aurora MySQL, Amazon RDS for MySQL, Amazon RDS for MariaDB, Google Cloud SQL for MySQL, SingleStoreDB, SingleStoreDB Cloud, HeatWave on AWS, and HeatWave on Azure technologies.

Adicionar um Extract (23ai)

Antes de adicionar e executar um Extract, certifique-se de preparar seu banco de dados para o Oracle GoldenGate 23ai.
Para adicionar um Extract para uma origem MySQL no Oracle GoldenGate 23ai:
  1. No menu de navegação Administration Service, clique em Extracts.
  2. Na página Extracts, clique em Adicionar Extract (ícone de mais).
  3. O formulário Adicionar Extract consiste em quatro páginas. Preencha o formulário Adicionar Extract conforme necessário:
    1. Na página Informações de Extract:
      1. Selecione um tipo Extract:
        • Change Data Capture Extract
        • Initial Load Extract
      2. Informe um Nome do Processo.
      3. (Opcional) Digite uma Descrição.
      4. Clique em Próximo.
    2. Na página Opções Extract:
      1. Selecione quando Iniciar:
        • Now
        • Horário personalizado
        • Posição no Log
        • Final do Log
      2. Informe os detalhes de Extract Trail:
        • Nome (só pode ter dois caracteres.)
        • Subdiretório
        • Tamanho da Trilha
        • Sequência de Trilhas
        • Deslocamento da trilha
      3. Selecione o Domínio e o Alias das Credenciais de Origem nas listas suspensas.
      4. Clique em Próximo.
    3. Na página Opções Gerenciadas, preencha os campos opcionais conforme necessário:
      1. Selecione um Nome do Perfil.
      2. Ative Crítico para integridade da implantação.
      3. Ative Início Automático.
      4. Ativar Reinicialização Automática.
      5. Clique em Próximo.
    4. Na página Arquivo de parâmetro, é possível editar o arquivo de parâmetro na área de texto para listar os detalhes da tabela a serem capturados. Por exemplo:
      table source.table1;

      Observação:

      GoldenGate usa o GMT (Greenwich Mean Time) por padrão. Use SETENV para substituir a definição padrão para Extract. Essa alteração se aplica somente ao processo Extract, e não à implantação.
      setenv (TZ="US/Eastern")
      setenv (TZ="GMT+5")
  4. Clique em Criar e Executar para iniciar o Extract. Se você clicar em Criar, poderá iniciar manualmente o Extract mais tarde na página Extracts.
Você retorna à página Extracts, na qual pode selecionar o processo Extract para exibir seus detalhes.

Adicionar um processo de Extract (21c)

Antes de adicionar e executar um processo de Extract, certifique-se de preparar e configurar o sistema do Oracle GoldenGate.

Para adicionar uma extração para o banco de dados MySQL no Oracle GoldenGate 21c:
  1. Na console de implantação do OCI GoldenGate, verifique se você está na página Visão Geral do Serviço de Administração e clique em Adicionar Extract (ícone de mais).
  2. Na página Adicionar Extract, para Tipo de Extract, selecione uma das opções a seguir e clique em Próximo.
    • Captura de Dados de Alteração
    • Carga Inicial
  3. Na página Opções de Extract, em Informações Básicas, preencha os campos conforme necessário:
    1. Para Nome do Processo, informe um nome para o processo de Extract, com até 8 caracteres.
    2. (Opcional) Para Descrição, digite uma descrição resumida para ajudar a distinguir esse processo de outros.
    3. Para Intenção, selecione a opção que melhor descreve a finalidade do processo de Extract:
      • Unidirecional (padrão)
      • Disaster Recovery
      • N-Way
    4. Só ative Remoto se estiver capturando dados de um banco de dados MySQL que não use identificadores de transação global (GTIDs).
    5. Em Domínio de Credencial, selecione Oracle GoldenGate.
    6. Em Apelido da Credencial, selecione sua conexão MySQL de origem.
    7. Para Nome da Trilha, informe um nome de dois caracteres para o arquivo de Trilha.
    8. (Opcional) Para Subdiretório de Trilhas, defina um local personalizado para o arquivo de Trilha gerado.
    9. (Opcional) Para Trail Size, defina o tamanho máximo para o arquivo de trilha gerado.
  4. (Opcional) Em Perfil de Criptografia, informe a descrição do perfil de criptografia. O perfil Wallet Local será selecionado por padrão se um perfil de criptografia não tiver sido criado.
    1. Selecione o nome do perfil na lista drop-down. Você pode selecionar a Wallet Local ou um perfil personalizado.
    2. Selecione o perfil de criptografia na lista drop-down.
    3. Especifique a chave principal para o perfil de criptografia.
  5. (Opcional) Em Opções Gerenciadas, você pode configurar o seguinte:
    • Nome do Perfil
    • Iniciar Automaticamente
    • Reinício Automático

    Observação:

    A adição de um perfil e a configuração das opções Iniciar Automaticamente e Reiniciar Automaticamente permitem que sua implantação seja reiniciada automaticamente após uma interrupção da rede. Consulte Configurar processos gerenciados para obter mais informações.
  6. Clique em Próximo.
  7. Na página Parâmetros de Extract, você pode editar o arquivo de parâmetro na área de texto para listar os detalhes da tabela a serem capturados. Por exemplo:
    table source.table1;

    Observação:

    GoldenGate usa o GMT (Greenwich Mean Time) por padrão. Use SETENV para substituir a definição padrão do processo Extract. Essa alteração se aplica apenas ao processo Extract, e não à implantação.
    setenv (TZ="US/Eastern")
    setenv (TZ="GMT+5")

    Saiba mais sobre SETENV.

  8. Selecione Registrar Extração em segundo plano para registrar a extração em segundo plano de forma assíncrona.
  9. Clique em Criar e Executar para criar e iniciar o Extract. Se você clicar em Criar, poderá iniciar o Extract manualmente mais tarde na página Visão Geral do Serviço de Administração.
Você é retornado para a página Visão Geral do Serviço de Administração, na qual pode exibir o status do processo de Extract. Selecione Detalhes no menu Ação do Extract para exibir informações do processo, checkpoint, estatísticas, parâmetros e relatórios.

Saiba mais

Interessado em saber mais sobre o processo de Extract e capturar dados? Consulte:

Problemas Conhecidos

Falha nos Extracts de captura de dados de alteração remota para bancos de dados ativados por GTID

Quando você cria um processo de Extract de Captura de Dados de Alteração com a opção Remota ativada para um banco de dados MySQL que usa identificadores de transação global (GTIDs), o processo de Extract falha e o seguinte erro é reportado:
ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

Solução alternativa: Na tela Arquivo de parâmetro do Extract de Captura de Dados de Alteração, remova a linha, TRANLOGOPTIONS ALTLOGDEST REMOTE.

Para obter mais informações, consulte Usando o Oracle GoldenGate para MySQL.