Instanciar uma Extração de Carga Inicial Usando SOURCEISTABLE

Use este procedimento para um Extract de carga inicial com o parâmetro SOURCEISTABLE. Este procedimento não se destina à instanciação usando o Oracle Data Pump ou qualquer método de instanciação preciso. Este procedimento usa HANDLECOLLISIONS em vez de posicionamento preciso para que o banco de dados de origem possa permanecer ativo enquanto os dados iniciais são carregados.

Os exemplos usam uma origem e um destino Oracle, o esquema HR e estes nomes de trilha:

Observação: Substitua os exemplos de aliases, URLs, hosts, portas, nomes de esquema e nomes de trilha por valores do seu ambiente.

Etapa 1: Criar e iniciar a Extração de TRANLOG principal

Estabeleça conexão com a implantação de origem. Para uma origem Oracle, ative o registro em log complementar, crie e registre o processo Extract principal integrado e inicie-o antes de iniciar o carregamento inicial. Registre o SCN de registro retornado por REGISTER EXTRACT; não execute o comando novamente apenas para recuperar esse valor.

ADMINCLIENT: Source deployment
OGG (not connected) 1> CONNECT https://<source-admin-url> AS <deployment-user> PASSWORD "<deployment-password>"
OGG (https://<source-admin-url> source_deployment) > DBLOGIN USERIDALIAS <source-db-alias>
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD SCHEMATRANDATA hr

Se o registro em log for necessário para as tabelas selecionadas em vez do esquema inteiro, use ADD TRANDATA para essas tabelas, por exemplo:

ADD TRANDATA hr.*

Crie e registre o processo Extract principal e, em seguida, crie o arquivo de parâmetros:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTRACT extprim INTEGRATED TRANLOG BEGIN NOW
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > REGISTER EXTRACT extprim DATABASE
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > EDIT PARAMS extprim

Arquivo de parâmetros do Extract principal (EXTPRIM):

EXTRACT extprim
USERIDALIAS <source-db-alias>
EXTTRAIL AA
TABLE hr.*;

Crie a trilha de origem local e inicie o processo Extract principal:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTTRAIL AA EXTRACT extprim MEGABYTES 2000
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > START EXTRACT extprim

Para um banco de dados contêiner, use os nomes de objeto de três partes apropriados ou uma instrução SOURCECATALOG válida. Para outros tipos de banco de dados de origem, use a sintaxe de registro, registro e posição inicial específica do banco de dados.

Etapa 2: Criar e iniciar o processo Extract de carga inicial

O processo Extract de carga inicial é uma tarefa Extract. Ele lê as tabelas de origem e grava os registros na trilha de carga inicial local CC. A cláusula SQLPREDICATE "AS OF SCN" específica do sistema Oracle seleciona o conteúdo da tabela no ponto consistente escolhido.

Antes de iniciar o Replicat de carga inicial, certifique-se de que todas as transações que estavam abertas quando o Extract TRANLOG primário foi iniciado foram submetidas a commit. As transações que permanecem abertas não são capturadas pelo processo Extract de carga inicial ou pelo processo Extract de TRANLOG principal e podem ser perdidas.

Crie o processo Extract de carga inicial e seu arquivo de parâmetros:

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > ADD EXTRACT extinit SOURCEISTABLE
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > EDIT PARAMS extinit

Arquivo de parâmetros de Extract de carga inicial (EXTINIT):

EXTRACT extinit
USERIDALIAS <source-db-alias>
EXTFILE CC MEGABYTES 2000 PURGE
TABLE hr.*, SQLPREDICATE "AS OF SCN <instantiation-scn>";

A partir do Oracle GoldenGate 26ai, uma instrução TABLE com curinga em um Extract de carga inicial não resolve views. Para incluir uma view, especifique-a separadamente sem um curinga, por exemplo:

TABLE hr.employees_view;

Iniciar e monitorar o processo Extract de carga inicial:

OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > START EXTRACT extinit
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > INFO EXTRACT extinit DETAIL
OGG (https://<source-admin-url> source_deployment as <source-db-alias>) > VIEW REPORT extinit

Etapa 3: Criar e iniciar os caminhos do Distribution Service

Crie os caminhos da implantação de origem. O URI SOURCE identifica o Serviço de Distribuição de origem e a trilha local. O URI TARGET identifica o Serviço do Receptor de destino e a trilha de destino. Os nomes das trilhas de origem e de destino devem corresponder às trilhas criadas para o fluxo correspondente.

Crie o caminho para dados de alteração contínuos (AA a BB):

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment) > ADD DISTPATH aabb SOURCE trail://<source-dist-host>:<source-dist-port>/services/v2/sources?trail=AA TARGET wss://<target-recv-host>:<target-recv-port>/services/v2/targets?trail=BB
OGG (https://<source-admin-url> source_deployment) > START DISTPATH aabb
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH aabb DETAIL

Crie o caminho para dados de carga inicial (CC para DD):

OGG (https://<source-admin-url> source_deployment) > ADD DISTPATH ccdd SOURCE trail://<source-dist-host>:<source-dist-port>/services/v2/sources?trail=CC TARGET wss://<target-recv-host>:<target-recv-port>/services/v2/targets?trail=DD
OGG (https://<source-admin-url> source_deployment) > START DISTPATH ccdd
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH ccdd DETAIL

Para um destino seguro que requer autenticação de caminho, anexe a seguinte cláusula a cada comando ADD DISTPATH:

AUTHENTICATION USERIDALIAS <target-path-alias> DOMAIN <target-path-domain>

Omita DOMAIN quando o alias estiver no domínio padrão. O alias e o domínio devem ser configurados para autenticação de caminho de destino na implantação de origem.

Se você usar o protocolo ogg legado em vez de ws ou wss, especifique também a opção TARGETTYPE apropriada no comando ADD DISTPATH.

Etapa 4: Criar e iniciar o processo Replicat de carga inicial

Estabeleça conexão com a implantação de destino, crie a tabela de checkpoint e adicione um Replicat de carga inicial não integrado que leia a trilha de destino DD. O Replicat pode ser iniciado antes da chegada da trilha de carga inicial; ele aguarda os dados de DD após a execução do Caminho de Distribuição.

ADMINCLIENT: Target deployment
OGG (not connected) 1> CONNECT https://<target-admin-url> AS <deployment-user> PASSWORD "<deployment-password>"
OGG (https://<target-admin-url> target_deployment) > DBLOGIN USERIDALIAS <target-db-alias>
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD REPLICAT repinit EXTTRAIL DD CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > EDIT PARAMS repinit

Arquivo de parâmetros Replicat de carga inicial (REPINIT):

REPLICAT repinit
USERIDALIAS <target-db-alias>
MAP hr.*, TARGET hr.*;

Iniciar e monitorar o Replicat de carga inicial:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > START REPLICAT repinit
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repinit DETAIL

Etapa 5: Conclua a carga inicial e remova objetos ocasionais

Aguarde até que o Extract de carga inicial tenha atingido o fim da entrada. O caminho CC para DD entregou todos os registros para DD e REPINIT os aplicou. Use as seguintes verificações:

ADMINCLIENT: Source deployment
OGG (https://<source-admin-url> source_deployment) > INFO EXTRACT extinit DETAIL
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH ccdd DETAIL
ADMINCLIENT: Target deployment
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repinit DETAIL
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > SEND REPLICAT repinit, LOGEND

Depois de validar os resultados de carga inicial, remova apenas o caminho ocasional e os objetos de processo. Mantenha o Extract principal EXTPRIM e o caminho principal AABB.

Na implantação de origem:

STOP DISTPATH ccdd
DELETE DISTPATH ccdd
STOP EXTRACT extinit
DELETE EXTRACT extinit

Na implantação de destino, interrompa REPINIT se ele ainda estiver em execução e exclua-o:

STOP REPLICAT repinit
DELETE REPLICAT repinit

DELETE EXTRACT requer o log-in apropriado no banco de dados de origem para a Oracle e DELETE REPLICAT requer o log-in no banco de dados de destino. A exclusão de um grupo de processos não necessariamente exclui seu arquivo de parâmetros ou arquivos de trilha; gerencie artefatos retidos por meio das operações de administração suportadas da implantação.

Etapa 6: Criar e iniciar o processo Replicat principal com HANDLECOLLISIONS

Criar o processo Replicat principal no destino. Este procedimento usa HANDLECOLLISIONS enquanto o Replicat principal aplica alterações que podem se sobrepor aos dados de carga inicial.

Para um workflow HANDLECOLLISIONS, use um processo Replicat principal não integrado no qual haja suporte. Não use HANDLECOLLISIONS com um Oracle Replicat integrado; use um método de instanciação preciso quando um Replicat integrado for necessário.

ADMINCLIENT: Target deployment
OGG (https://<target-admin-url> target_deployment) > DBLOGIN USERIDALIAS <target-db-alias>
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > ADD REPLICAT repprim EXTTRAIL BB CHECKPOINTTABLE ggadmin.ggcheckpoint
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > EDIT PARAMS repprim

Arquivo de parâmetros do Replicat Principal (REPPRIM):

REPLICAT repprim
USERIDALIAS <target-db-alias>
HANDLECOLLISIONS
MAP hr.*, TARGET hr.*;

Iniciar e monitorar o processo de Replicat principal:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > START REPLICAT repprim
OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > INFO REPLICAT repprim DETAIL
OGG (https://<source-admin-url> source_deployment) > INFO DISTPATH aabb DETAIL

Depois que o Replicat principal tiver pego e processado as alterações enfileiradas durante a carga inicial, desative HANDLECOLLISIONS:

OGG (https://<target-admin-url> target_deployment as <target-db-alias>) > SEND REPLICAT repprim, NOHANDLECOLLISIONS

SEND REPLICAT ... NOHANDLECOLLISIONS desativa o tratamento de colisões para a execução atual, mas não remove HANDLECOLLISIONS do arquivo de parâmetros. Remova o HANDLECOLLISIONS do arquivo de parâmetros antes da próxima reinicialização ou adicione o NOHANDLECOLLISIONS antes das instruções MAP afetadas.