Instanciación de una extracción de carga inicial mediante SOURCEISTABLE

Utilice este procedimiento para un Extract de carga inicial con el parámetro SOURCEISTABLE. Este procedimiento no está destinado a la instanciación mediante Oracle Data Pump ni a ningún método de instanciación preciso. Este procedimiento utiliza HANDLECOLLISIONS en lugar de un posicionamiento preciso para que la base de datos origen pueda permanecer activa mientras se cargan los datos iniciales.

Los ejemplos utilizan un origen y un destino de Oracle, el esquema HR y estos nombres de pista:

Nota: Sustituya los alias, las URL, los hosts, los puertos, los nombres de esquema y los nombres de pista de ejemplo por valores de su entorno.

Paso 1: Crear e iniciar el extracto TRANLOG principal

Conéctese al despliegue de origen. Para un origen de Oracle, active el registro complementario, cree y registre el Extract primario integrado e inícielo antes de comenzar la carga inicial. Registre el SCN de registro devuelto por REGISTER EXTRACT; no vuelva a ejecutar el comando solo para recuperar ese 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

Si el registro es necesario para las tablas seleccionadas en lugar de para todo el esquema, utilice ADD TRANDATA para esas tablas, por ejemplo:

ADD TRANDATA hr.*

Cree y registre el Extract principal y, a continuación, cree su archivo 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

Archivo de parámetros de extracción principal (EXTPRIM):

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

Cree la pista de origen local e inicie el 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 una base de datos de contenedores, utilice los nombres de objeto de tres partes adecuados o una sentencia SOURCECATALOG válida. Para otros tipos de bases de datos de origen, utilice la sintaxis de registro, registro y posición de inicio específica de la base de datos.

Paso 2: Crear e iniciar el Extract de carga inicial

El Extract de carga inicial es un Extract de tarea. Lee las tablas de origen y escribe los registros en la pista de carga inicial local CC. La cláusula SQLPREDICATE "AS OF SCN" específica de Oracle selecciona el contenido de la tabla en el punto consistente elegido.

Antes de iniciar el Replicat de carga inicial, asegúrese de que todas las transacciones que estaban abiertas cuando se inició la extracción TRANLOG principal se hayan confirmado. Las transacciones que permanecen abiertas no se capturan mediante la extracción de carga inicial ni mediante la extracción TRANLOG principal y se pueden perder.

Cree el Extract de carga inicial y su archivo 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

Archivo de parámetros 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 de Oracle GoldenGate 26ai, una sentencia TABLE con comodín en un Extract de carga inicial no resuelve las vistas. Para incluir una vista, especifíquela por separado sin un comodín, por ejemplo:

TABLE hr.employees_view;

Inicie y controle el 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

Paso 3: Crear e iniciar las rutas del servicio de distribución

Cree las rutas desde el despliegue de origen. El URI SOURCE identifica el servicio de distribución de origen y la pista local. El URI TARGET identifica el servicio de receptor de destino y la pista de destino. Los nombres de pista de origen y destino deben coincidir con las pistas creadas para el flujo correspondiente.

Cree la ruta para los datos de cambio en curso (de 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

Cree la ruta para los datos de carga inicial (de CC a 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 un destino seguro que requiere autenticación de ruta de acceso, agregue la siguiente cláusula a cada comando ADD DISTPATH:

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

Omita DOMAIN cuando el alias esté en el dominio predeterminado. El alias y el dominio se deben configurar para la autenticación de ruta de destino en el despliegue de origen.

Si utiliza el protocolo ogg heredado en lugar de ws o wss, también especifique la opción TARGETTYPE adecuada en el comando ADD DISTPATH.

Paso 4: Crear e iniciar el Replicat de carga inicial

Conéctese al despliegue de destino, cree la tabla de puntos de control y agregue un Replicat de carga inicial no integrado que lea la pista de destino DD. El Replicat se puede iniciar antes de que llegue la pista de carga inicial; espera los datos de DD después de que se ejecute la ruta de distribución.

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

Archivo de parámetros de Replicat de carga inicial (REPINIT):

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

Inicie y controle el 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

Paso 5: Completar la carga inicial y eliminar objetos únicos

Espere hasta que el Extract de carga inicial haya llegado al final de la entrada, la ruta de acceso CC a DD haya entregado todos los registros a DD y REPINIT los haya aplicado. Utilice las siguientes comprobaciones:

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

Después de validar los resultados de carga inicial, elimine solo la ruta de acceso única y los objetos de proceso. Mantenga el Extract principal EXTPRIM y la ruta de acceso principal AABB.

Desde el despliegue de origen:

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

En el despliegue de destino, pare REPINIT si aún se está ejecutando y, a continuación, suprímalo:

STOP REPLICAT repinit
DELETE REPLICAT repinit

DELETE EXTRACT necesita la conexión a la base de datos de origen adecuada para Oracle y DELETE REPLICAT necesita la conexión a la base de datos de destino. La supresión de un grupo de procesos no necesariamente suprime su archivo de parámetros o sus archivos de pista; gestiona los artefactos retenidos mediante las operaciones de administración soportadas del despliegue.

Paso 6: Crear e iniciar el Replicat primario con HANDLECOLLISIONS

Cree el Replicat principal en el destino. Este procedimiento utiliza HANDLECOLLISIONS, mientras que el Replicat principal aplica cambios que pueden solaparse con los datos de carga inicial.

Para un flujo de trabajo HANDLECOLLISIONS, utilice un Replicat principal no integrado cuando esté soportado. No utilice HANDLECOLLISIONS con un Oracle Replicat integrado; utilice un método de instanciación preciso cuando se necesite un Replicat integrado.

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

Archivo de parámetros de Replicat principal (REPPRIM):

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

Inicie y controle el 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

Una vez que el Replicat principal haya recuperado y procesado los cambios en cola durante la carga inicial, desactive HANDLECOLLISIONS:

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

SEND REPLICAT ... NOHANDLECOLLISIONS desactiva el manejo de colisiones para la ejecución actual, pero no elimina HANDLECOLLISIONS del archivo de parámetros. Elimine HANDLECOLLISIONS del archivo de parámetros antes del siguiente reinicio o agregue NOHANDLECOLLISIONS antes de las sentencias MAP afectadas.