Adición de un Extract

Obtenga información sobre los requisitos previos y las consideraciones para agregar un Extract.

Antes de comenzar a agregar un Extract, asegúrese de que se han configurado los siguientes valores:

Ahora, ya está listo para agregar un Extract para su despliegue.

Consideraciones para crear una extracción cuando existen archivos de pista de extracción anteriores

Pantalla de información de extracción

Después de conectarse a la página inicial de microservicios, haga clic en el signo + en la columna Crear para abrir el asistente Agregar extracciones.

En la pantalla Información de extracción, seleccione el tipo de extracción. Según la plataforma de base de datos, los tipos de extracciones disponibles pueden ser Extracción integrada, Extracción de captura de cambio de datos y Extracción de carga inicial.

Si necesita configurar la Extracción descendente para Oracle AI Database, active el conmutador Extracción descendente.

Seleccione el tipo de extracción que desea crear y especifique lo siguiente:

Haga clic en Siguiente.

Pantalla Register Extract: PostgreSQL y bases de datos de Yugabyte

Nota: Es necesario registrar Oracle GoldenGate Extract para Oracle, diferentes tipos PostgreSQL y la base de datos de Yugabyte. Sin embargo, las opciones de configuración para registrar el Extract se muestran en diferentes pantallas al agregar el Extract.

Nota: Consulte también las Directrices y limitaciones para el tipo de plugin PGOUTPUT.

En la pantalla Registrar extracción, configure las siguientes opciones y haga clic en Registrar:

Haga clic en Siguiente después de que el registro de Extract se haya realizado correctamente.

Se muestra un mensaje que indica que el Extract se ha registrado correctamente.

Haga clic en Siguiente.

Registro de Extract para bases de datos PostgreSQL y Yugabyte desde el cliente de administración

Se debe registrar un Extract para PostgreSQL con la base de datos y se le debe otorgar una ranura de replicación reservada. Las ranuras de replicación se asignan mediante el valor de configuración de base de datos max_replication_slots y se pueden configurar como se describe en Configuración de base de datos.

Siga estas instrucciones para registrar un Extract. El registro de extracción se debe realizar antes de crear un Extract. Consulte REGISTER EXTRACT en la Referencia de interfaz de línea de comandos para Oracle GoldenGate para obtener más información.

  1. Conéctese al despliegue y, a continuación, conéctese al alias de credencial de la base de datos origen.

    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 el Extract, que crea internamente un espacio de replicación para el Extract. Los nombres de extracción no pueden tener más de 8 caracteres alfanuméricos.

    REGISTER EXTRACT *extname*

    Para registrar explícitamente Extract con el plugin pgoutput, debe especificar el tipo de plugin pgoutput:

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

También puede registrar un Extract desde la interfaz web de Oracle GoldenGate MA. Consulte Adición de un Extract.

Directrices y limitaciones para el tipo de plugin PGOUTPUT

Directrices para configurar el tipo de plugin PGOUTPUT

Siga estas directrices al definir el tipo de plugin para PostgreSQL:

Limitaciones

Se aplican las siguientes restricciones al seleccionar un tipo de plugin para PostgreSQL:

Pantalla Opciones de extracción

Nota: Esta pantalla proporciona opciones para registrar Extract para Oracle AI Database. Si va a agregar un Extract para PostgreSQL, el registro de Extract se completa en la pantalla Registrar Extract.

En la pantalla Extract Options (Opciones de extracción), configure los siguientes valores:

Registrar extracción para Oracle desde el cliente de administración

Siga estas instrucciones para registrar un Extract. El registro de extracción se debe realizar antes de crear un Extract.

Asegúrese de que está conectado a la base de datos mediante el comando DBLOGIN.

Consulte [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3) en la Referencia de interfaz de línea de comandos para Oracle GoldenGate para obtener más información.

  1. Mediante el cliente de administración, conéctese al despliegue y, a continuación, conéctese al alias de credencial de la base de datos origen.

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

    Al ejecutar el comando CONNECT, el símbolo del sistema cambia de "no conectado" a "https://servername:port deployment_name", como se muestra en el siguiente ejemplo:

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

  2. Conéctese a la base de datos mediante el comando DBLOGIN:

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

  3. Registre el Extract. Los nombres de Extract no pueden tener más de 8 caracteres alfanuméricos.

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

También puede registrar un Extract en segundo plano al crear un Extract desde la interfaz web de Oracle GoldenGate MA. Consulte Agregar un Extract para obtener más información.

Pantalla de captura descendente

Válido solo para Oracle.

Si ha seleccionado la captura descendente en la pantalla Información de extracción, se muestra la pantalla de opciones Captura descendente. Configure la conexión a la base de datos de minería descendente para el Extract descendente mediante esta pantalla.

Nota: La captura descendente con ADG no soporta la extracción por PDB.

Haga clic en Siguiente.

Pantalla de opciones gestionadas

En la pantalla Opciones Gestionadas, configure las opciones de inicio automático y reinicio automático para el proceso de extracción. En la tabla siguiente se proporcionan estas opciones:

En la tabla siguiente se proporcionan estas opciones:

Opción Descripción
Nombre del perfil

Proporciona el nombre del perfil de inicio automático y reinicio automático. Puede seleccionar las opciones por defecto o personalizadas.

Si ya ha creado un perfil, también puede seleccionarlo. Si selecciona la opción Personalizado, puede configurar un nuevo perfil desde esta sección.
Crucial para estado de despliegue

(Solo Oracle) Active esta opción si el perfil es crítico para el estado de despliegue.

Nota:

Esta opción solo aparece al crear el Extract o Replicat y no al configurar los procesos gestionados en la página Perfiles.

Iniciar automáticamente Activa el inicio automático para el proceso.
Retraso de inicio Tiempo de espera, en segundos, antes de iniciar el proceso
Reinicio automático Configura cómo reiniciar el proceso si termina.
Máximo de Reintentos Especifique el número máximo de reintentos para iniciar el proceso
Retraso de reintento Tiempo de retraso al intentar iniciar el proceso
Período de reintentos Intervalo de duración para intentar iniciar el proceso
Reiniciar solo si hay fallos Si tiene el valor true la tarea solo se reinicia si falla.
Desactivar tarea tras agotar reintentos Si es true, la tarea se desactiva después de agotar todos los intentos de reinicio del proceso.

Haga clic en Siguiente.

Pantalla Extraer archivo de parámetros

En la pantalla Archivo de Parámetros, puede editar el archivo de parámetros en el área de texto para mostrar los detalles de la tabla que le interesa capturar. A continuación, se muestra un archivo de parámetros de Extract de ejemplo:

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

Haga clic en Crear y ejecutar para crear e iniciar el Extract. Si selecciona Crear, se crea el Extract, pero debe iniciarlo mediante las opciones de Extract.

Vuelva a la página inicial del servicio de administración o a la página Extract donde se muestran todas las extracciones creadas.

Creación de un archivo de parámetros para extracción

Siga estas instrucciones para crear un archivo de parámetros para un Extract.

  1. (Solo MySQL) Cuando se ejecuta Oracle GoldenGate para MySQL en un servidor Windows y en un servidor Linux (para la versión de OGG inferior a 23.10.x), que está en un host remoto desde el servidor de base de datos, asegúrese de que sus zonas horarias son las mismas y, si no, utilice el parámetro SETENV(TZ) en Extract y defínalo en la zona horaria del servidor de base de datos.

    Para obtener más información sobre el formato TZ, consulte el parámetro SETENV en la Guía de referencia de parámetros y funciones.

    Consulte los siguientes enlaces como referencia:

    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. En el sistema de origen, ejecute el siguiente comando:

    EDIT PARAMS extract_name

    Dónde:

    extract_name es el nombre del Extract que ha creado con el comando ADD EXTRACT o el nombre totalmente cualificado del archivo de parámetros si ha definido una ubicación alternativa al crear el grupo.

  3. Introduzca los parámetros en el orden que se muestra en la siguiente tabla, iniciando una nueva línea para cada sentencia de parámetro. Algunos parámetros sólo se aplican a determinadas configuraciones.

    Parámetro Descripción
    EXTRACT group
    • group es el nombre del grupo Extract que ha creado con el comando ADD EXTRACT.
    		Permite configurar Extract como un proceso en línea con puntos de control.
    [, 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 las credenciales de la base de datos.
    ENCRYPTTRAIL algorithm Cifra todas las pistas que se especifican después de esta entrada.
    SOURCECATALOG Especifica un contenedor por defecto en una base de datos de contenedor multi-inquilino de Oracle o sentencias SEQUENCE. Permite el uso de nombres de dos partes (schema.object) en los que, de lo contrario, se necesitarían nombres de tres partes para esas bases de datos. Puede utilizar varias instancias de este parámetro para especificar diferentes contenedores o catálogos por defecto para diferentes juegos de parámetros TABLE o SEQUENCE.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    Especifica el nombre completo de un objeto o una especificación comodín totalmente cualificada para varios objetos. Si la base de datos es una base de datos de contenedor multiinquilino de Oracle, el nombre del objeto debe incluir el nombre del contenedor o catálogo, a menos que se utilice SOURCECATALOG.

    • schema es el nombre del esquema o un juego de esquemas con comodines.

    • object es el nombre de la tabla o un juego de tablas con comodines.

    • library es el nombre de la biblioteca IBM i o un conjunto de bibliotecas con comodines.

    • file es el nombre de archivo físico de IBM i o un conjunto de archivos físicos con comodines.

    • member es el nombre del miembro del archivo físico de IBM i o un conjunto comodín de nombres de miembros. Al utilizar el formato de nombre nativo de IBM i (biblioteca/archivo con miembro opcional), los únicos comodines válidos son un nombre con al menos un carácter válido seguido de un asterisco final (*) o *ALL que coincida con cualquier nombre.

    Nota:

    El nombre de miembro es opcional y se debe proporcionar si los nombres de miembro deben escribirse en la pista como parte del nombre de objeto. Sin nombres de miembros, todos los miembros de un archivo físico se fusionarán implícitamente como un único objeto en la pista.

    Consulte las directrices de Especificación de nombres de objetos en la entrada de Oracle GoldenGate para especificar nombres de objetos en archivos de parámetros.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 Parámetros que se pueden utilizar conjuntamente para excluir objetos específicos de una especificación de comodín en la sentencia TABLE asociada.

  4. Introduzca los parámetros de Extract opcionales adecuados que se muestran en los parámetros de Oracle GoldenGate.

  5. Guarde y cierre el archivo de parámetros.

El siguiente archivo de parámetros Extract de ejemplo explica varios parámetros de configuración y opciones para Extract:

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

Opciones de parámetro adicionales para extracción

Obtenga información sobre los parámetros adicionales que pueden ser necesarios para la configuración de Extract.

Extract utiliza un servidor de logmining de la base de datos de minería para extraer el flujo de redo de la base de datos origen. Puede definir parámetros específicos para el servidor de logmining mediante el parámetro TRANLOGOPTIONS con la opción INTEGRATEDPARAMS en el archivo de parámetros Extract.

Nota: Para obtener información detallada y orientación sobre el uso de estos parámetros, consulte la sección "DBMS_CAPTURE_ADM" en Oracle AI Database PL/SQL Packages and Types Reference.

Los siguientes parámetros se pueden definir con INTEGRATEDPARAMS:

Consulte Gestión de Recursos del Servidor.