Adicionar um processo de Extract

Saiba mais sobre os pré-requisitos e as considerações para adicionar um Extract.

Antes de começar a adicionar um Extract, certifique-se de que as seguintes configurações estejam configuradas:

Agora, você está pronto para adicionar um Extract para sua implantação.

Considerações para criar um Extract quando existirem arquivos de trilha do Extract anteriores

Tela Extrair Informações

Depois de fazer log-in na home page de Microsserviços, clique no sinal + na coluna Criar para abrir o assistente Adicionar Extratos.

Na tela Informações da Extração, selecione o tipo de Extração. Dependendo da plataforma de banco de dados, os tipos de Extrações disponíveis podem ser Extração Integrada, Extração de Captura de Dados de Alteração e Extração de Carga Inicial.

Se você precisar configurar o Downstream Extract para o Oracle AI Database, ative a chave de alternância Downstream Extract.

Selecione o tipo de Extract a ser criado e especifique o seguinte:

Clique em Próximo.

Tela de Extração de Registro - PostgreSQL e Bancos de Dados Yugabyte

Observação: é necessário registrar o Oracle GoldenGate Extract for Oracle, diferentes sabores PostgreSQL e o Banco de Dados Yugabyte. No entanto, as opções de configuração para registrar o Extract são exibidas em telas diferentes ao adicionar o Extract.

Observação: consulte também Guidelines and Limitations for PGOUTPUT Plugin Type.

Na tela Registrar Extração, configure as seguintes opções e clique em Registrar:

Clique em Próximo depois que o registro do Extract for bem-sucedido.

Uma mensagem exibe que o Extract foi registrado com sucesso.

Clique em Próximo.

Registrar Extract para Bancos de Dados PostgreSQL e Yugabyte no Admin Client

Um Extract para PostgreSQL deve ser registrado no banco de dados e ter um slot de replicação reservado. Os slots de replicação são alocados por meio da definição de configuração do banco de dados max_replication_slots e podem ser configurados conforme discutido em Configuração do Banco de Dados.

Siga estas instruções para registrar um Extract. O registro de extração deve ser feito antes da criação de um Extract. Consulte REGISTER EXTRACT na Referência de Interface de Linha de Comando do Oracle GoldenGate para obter mais informações.

  1. Conecte-se à implantação e, em seguida, conecte-se ao alias de credencial do banco de dados de origem.

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Registre o Extract, que cria internamente um slot de replicação para o Extract. Os nomes de extração não podem ter mais de 8 caracteres alfanuméricos.

    REGISTER EXTRACT *extname*

    Para registrar explicitamente o Extract no plug-in pgoutput, especifique o tipo de plug-in pgoutput:

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

Você também pode registrar um Extract na interface Web do Oracle GoldenGate MA. Consulte Adicionar um Extract.

Diretrizes e limitações para o tipo de plug-in PGOUTPUT

Diretrizes ao configurar o tipo de plug-in PGOUTPUT

Siga estas diretrizes ao definir o tipo de plug-in para PostgreSQL:

Limitações

As seguintes restrições se aplicam ao selecionar um tipo de plug-in para PostgreSQL:

Tela Opções de Extração

Observação: esta tela fornece opções para registrar o processo Extract para o Oracle AI Database. Se você estiver adicionando um Extract para PostgreSQL, o registro do Extract será concluído na Tela de Extract do Registro.

Na tela Opções de Extração, defina as seguintes configurações:

Registrar Extract para Oracle do Admin Client

Siga estas instruções para registrar um Extract. O registro de extração deve ser feito antes da criação de um Extract.

Certifique-se de estar conectado ao banco de dados usando o comando DBLOGIN.

Consulte [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3) na Referência de Interface de Linha de Comando do Oracle GoldenGate para obter mais informações.

  1. Usando o Admin Client, conecte-se à implantação e, em seguida, conecte-se ao alias de credencial do banco de dados de origem.

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    Ao executar o comando CONNECT, o prompt de comando é alterado de "não conectado" para "https://servername:port deployment_name", conforme mostrado no seguinte exemplo:

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. Conecte-se ao banco de dados usando o comando DBLOGIN:

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Registre o processo Extract. Os nomes do Extract não podem ter mais de 8 caracteres alfanuméricos.

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

Você também pode registrar um Extract em segundo plano ao criar um Extract na interface Web do Oracle GoldenGate MA. Consulte Adicionar um Extract para obter detalhes.

Tela de Captura Downstream

Válido apenas para o sistema Oracle.

Se você tiver selecionado a Captura de Downstream na tela Informações de Extração, a tela de opções Captura de Downstream será exibida. Configure a conexão do banco de dados de mineração downstream para o Extract downstream usando esta tela.

Observação: A Captura Downstream com ADG não suporta a Extração por PDB.

Clique em Próximo.

Tela Opções Gerenciadas

Na tela Opções Gerenciadas, configure as opções de início automático e reinicialização automática para o processo Extract. A tabela a seguir fornece estas opções:

A tabela a seguir fornece estas opções:

Opção Descrição
Nome do Perfil

Fornece o nome do perfil de inicialização automática e de reinicialização automática. Você pode selecionar as opções padrão ou personalizadas.

Se já tiver criado um perfil, você também poderá selecioná-lo. Se você selecionar a opção Personalizado, poderá configurar um novo perfil nessa própria seção.
Crítico para a integridade da implantação

(Somente Oracle) Ative essa opção se o perfil for crítico para a integridade da implantação.

Observação:

Essa opção só aparece durante a criação do processo Extract ou Replicat, e não quando você configura os processos gerenciados na página Perfis.

Iniciar Automaticamente Ativa a inicialização automática do processo.
Atraso na Inicialização Tempo de espera em segundos antes de iniciar o processo
Reinício Automático Configura como reiniciar o processo se ele terminar
Máximo de Novas Tentativas Especifique o número máximo de novas tentativas para tentar iniciar o processo
Atraso na Repetição Atraso na tentativa de iniciar o processo
Janela de Novas Tentativas O intervalo de duração para tentar iniciar o processo
Reiniciar somente na Falha Se for verdadeiro, a tarefa só será reiniciada se ela falhar.
Desativar Tarefa após Novas Tentativas Esgotadas Se for verdadeiro, a tarefa será desativada depois de esgotar todas as tentativas de reiniciar o processo.

Clique em Próximo.

Tela Extrair Arquivo de Parâmetros

Na tela Arquivo de Parâmetro, você pode editar o arquivo de parâmetro na área de texto para listar os detalhes da tabela que está interessado em capturar. Veja a seguir um exemplo de arquivo de parâmetros do Extract:

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

Clique em Criar e Executar para criar e iniciar o processo de Extract. Se você selecionar Criar, a Extração será criada, mas você precisará iniciá-la usando as opções da Extração.

Você retorna à home page do Serviço de Administração ou à página Extrair, na qual todas as Extrações criadas são listadas.

Criar um Arquivo de Parâmetros para Extração

Siga estas instruções para criar um arquivo de parâmetros para um processo de Extract.

  1. (Somente MySQL) Ao executar o Oracle GoldenGate for MySQL em um servidor Windows e em um servidor Linux (para a versão do OGG inferior a 23.10.x), que está em um host remoto do o servidor de banco de dados, certifique-se de que seus fusos horários sejam os mesmos e, caso contrário, use o parâmetro SETENV(TZ) dentro do Extract e defina-o como o fuso horário do servidor de banco de dados.

    Para obter mais detalhes sobre o formato TZ, consulte o parâmetro SETENV no Guia de Referência de Parâmetros e Funções.

    Consulte os seguintes links para referência:

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. No sistema de origem, execute o seguinte comando:

    EDIT PARAMS extract_name

    Onde:

    extract_name é o nome do processo Extract criado com o comando ADD EXTRACT ou o nome totalmente qualificado do arquivo de parâmetros se você tiver definido um local alternativo quando criou o grupo.

  3. Informe os parâmetros na ordem mostrada na tabela a seguir, iniciando uma nova linha para cada instrução de parâmetro. Alguns parâmetros se aplicam apenas a determinadas configurações.

    Parâmetro Descrição
    EXTRACT group
    • group é o nome do grupo de Extract criado com o comando ADD EXTRACT.
    		Configura a Extração como um processo on-line com checkpoints.
    [, USERIDALIAS alias options ] Consulte [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05) para especificar credenciais do banco de dados.
    ENCRYPTTRAIL algorithm Criptografa todas as trilhas que são especificadas após esta entrada.
    SOURCECATALOG Especifica um contêiner padrão em um banco de dados contêiner multitenant Oracle ou em instruções SEQUENCE. Permite o uso dos nomes de duas partes (schema.object) nos quais, caso contrário, os nomes de três partes seriam necessários para esses bancos de dados. Você pode usar várias instâncias desse parâmetro para especificar diferentes contêineres ou catálogos padrão para diferentes conjuntos de parâmetros TABLE ou SEQUENCE.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    Especifica o nome totalmente qualificado de um objeto ou uma especificação com curinga totalmente qualificada para vários objetos. Se o banco de dados for um banco de dados contêiner multitenant da Oracle, o nome do objeto deverá incluir o nome do contêiner ou catálogo, a menos que SOURCECATALOG seja usado.

    • schema é o nome do esquema ou um conjunto de esquemas com curinga.

    • object é o nome da tabela ou um conjunto de tabelas com curingas.

    • library é o nome da biblioteca IBM i ou um conjunto de bibliotecas com curinga.

    • file é o nome do arquivo físico IBM i ou um conjunto de arquivos físicos com curinga.

    • member é o nome do membro do arquivo físico IBM i ou um conjunto de nomes de membro com curinga. Ao usar o formato de nome nativo IBM i (biblioteca/arquivo com membro opcional), os únicos curingas válidos são um nome com pelo menos um caractere válido seguido por um asterisco à direita (*) ou *ALL que corresponde a qualquer nome.

    Observação:

    O nome do membro é opcional e deve ser fornecido se for necessário que os nomes do membro sejam gravados na trilha como parte do nome do objeto. Sem nomes de membros, todos os membros de um arquivo físico serão implicitamente mesclados como um único objeto na trilha.

    Consulte Especificando Nomes de Objetos na Entrada do Oracle GoldenGate para especificar nomes de objetos em arquivos de parâmetros.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 Parâmetros que podem ser usados em conjunto para excluir objetos específicos de uma especificação de curinga na instrução TABLE associada.

  4. Informe quaisquer parâmetros de Extract opcionais apropriados listados nos Parâmetros do Oracle GoldenGate.

  5. Salve e feche o arquivo de parâmetros.

O arquivo de parâmetros Extract de amostra a seguir explica vários parâmetros e opções de configuração para Extract:

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

Opções de Parâmetro Adicionais para Extração

Saiba mais sobre parâmetros adicionais que podem ser necessários para sua configuração do Extract.

O Extract usa um servidor de logmining de banco de dados no banco de dados de mining para minerar o fluxo de redo do banco de dados de origem. Você pode definir parâmetros específicos do servidor de logmining usando o parâmetro TRANLOGOPTIONS com a opção INTEGRATEDPARAMS no arquivo de parâmetros de Extract.

Observação: Para obter informações detalhadas e orientação de uso desses parâmetros, consulte a seção "DBMS_CAPTURE_ADM" em Referência de Tipos e Pacotes PL/SQL do Oracle AI Database.

Os seguintes parâmetros podem ser definidos com INTEGRATEDPARAMS:

Consulte Gerenciando Recursos do Servidor.