Gestionar archivos de pista

A lo largo del tiempo se agregan rápidamente archivos de pista de OCI GoldenGate. Sin tareas de depuración que permitan gestionar estos archivos de pista, las copias de seguridad diarias tardarían un tiempo exponencialmente mayor en completarse y utilizarían recursos informáticos que, de otro modo, podrían utilizarse para otro fin.

Note:

Esta información solo se aplica a los despliegues de replicación de datos.

Visualización de archivos de pista

Puede ver los detalles de los archivos de pista, como el tamaño, la secuencia, los productores y los consumidores, en la página de detalles del despliegue.

Para ver los archivos de pista:

1. En la página Visión general de GoldenGate, haga clic en Despliegues.
2. En la página Despliegues, seleccione un despliegue para ver los detalles o seleccione Ver detalles en el menú Acción del despliegue.
3. En la página de detalles de despliegue, haga clic en Archivos de pista.

Utilice esta información para identificar los archivos de pista que ya no se utilizan o no son necesarios y, a continuación, cree tareas de depuración para gestionarlos.

Cifrar archivos de pista

Puede cifrar los archivos de pista mediante perfiles de cifrado en la consola de despliegue o creando carteras de claves de cifrado maestras. En este tema, se tratan los perfiles de cifrado con y sin principales de recursos. Para obtener información sobre las carteras de claves de cifrado maestras, consulte Gestión de carteras de claves de cifrado.

Antes de continuar, asegúrese de tener:

• Acceso al servicio Vault y a un almacén creado.

  Note:

  No se necesita un almacén privado virtual.
• Se han agregado las políticas mínimas necesarias para que OCI GoldenGate utilice el servicio Vault.

Cifrar con entidad de recurso

Una entidad de recurso es una función de Identity and Access Management (IAM) que autoriza a los recursos a actuar como actores principales que realizan acciones en los recursos. Cada recurso tiene su propia identidad y se autentica mediante los certificados que se le agregan. Estos certificados se crean, asignan a los recursos y rotan automáticamente, evitando la necesidad de que cree y gestione sus propias credenciales para acceder al recurso.

Puede utilizar entidades de recurso para acceder a su clave de almacén, que luego puede utilizar para cifrar archivos de pista. Para ello, el despliegue debe tener acceso a la clave de almacén seleccionada. Asegúrese de haber revisado los requisitos enumerados anteriormente en los archivos de pista de cifrado, especialmente las políticas mínimas necesarias para el servicio Vault.

Para cifrar archivos de pista mediante una entidad de recurso:

1. En la página de detalles del despliegue, haga clic en Iniciar consola.
2. En la consola de despliegue, en el menú de navegación, amplíe Cifrado y, a continuación, seleccione Perfiles.
3. En Oracle Cloud Infratstructure with Resource Principal, haga clic en Agregar perfil de cifrado de plugin.
4. En el panel Crear perfil de cifrado, complete los siguientes campos:
   1. En Nombre de perfil, introduzca un nombre para este perfil de cifrado.
   2. (Opcional) Agregue una descripción.
   3. Pegue el OCID de clave de OCI Vault de OCI Vault. Puede encontrarlo en la página de detalles de la clave de cifrado en el almacén.
   4. Introduzca el punto final criptográfico para OCI Vault en la página de detalles del almacén.
5. Haga clic en Enviar.

Cifrar sin entidad de recurso

Para cifrar archivos de pista sin utilizar una entidad de recurso:

1. En la página de detalles del despliegue, haga clic en Iniciar consola.
2. En la consola de despliegue, en el menú de navegación, amplíe Cifrado y, a continuación, seleccione Perfiles.
3. En Oracle Cloud Infratstructure, haga clic en Agregar perfil de cifrado de plugin.
4. En el panel Crear perfil de cifrado, complete los siguientes campos:
   1. Introduzca un nombre de perfil.
   2. Introduzca una Descripción.
   3. Pegue en la URL de punto final de criptografía, que puede encontrar en la página de detalles del almacén.
   4. Pegue el OCID de arrendamiento, que puede encontrar en la página de detalles del arrendamiento.
   5. Pegue el OCID de clave, que puede encontrar en la página de detalles de clave.
   6. Pegue el OCID de usuario, que puede encontrar en la página de perfil de usuario.
   7. Cargue o pegue la clave de API, que puede generar desde la sección Tokens and Keys de la página de perfil de usuario.
   8. Pegue su huella clave, que está asociada a su clave de API.
5. Haga clic en Enviar.

Para obtener más información, consulte Uso del cifrado del archivo de pista de OCI KMS en Oracle GoldenGate.

Depurar Archivos de Pista

A lo largo del tiempo se agregan rápidamente archivos de pista de OCI GoldenGate. Sin tareas de depuración que permitan gestionar estos archivos de pista, las copias de seguridad diarias tardarían un tiempo exponencialmente mayor en completarse y utilizarían recursos informáticos que, de otro modo, podrían utilizarse para otro fin.

Oracle recomienda crear primero una copia de seguridad antes de depurar los archivos de pista. Consulte Crear una copia de seguridad manual. A continuación, puede descargar la copia de seguridad y revisar su contenido (<deployment-name>/var/lib/data/).

Para depurar los archivos de pista de OCI GoldenGate:

1. En la consola de despliegue OCI GoldenGate, revise los siguientes procesos que generan archivos del pista y tome nota de los archivos del seguimiento que desea conservar:
   • En el servicio de administración, revise los detalles de cada Extract y Replicat. (Haga clic en el nombre del proceso y, a continuación, seleccione Detalles).
   • En el Servicio de distribución, revise los detalles de cada ruta de distribución (si corresponde).
   • En el servicio de receptor, revise los detalles de cada ruta de receptor (si las hay).

   Todos los demás archivos de pista que no estén en la lista se pueden depurar.

2. Configure las tareas de depuración para limpiar los archivos de pista no utilizados en la consola de despliegue.
   1. En la consola de despliegue de la OCI GoldenGate, abra el menú del servicio de administración (icono de hamburguesas) y, a continuación, seleccione Configuración.
   2. En la página Configuración, haga clic en Tareas y, a continuación, haga clic en Depurar pistas.
   3. Haga clic en Agregar Tarea de Depuración de Pistas (icono más).
   4. En Crear una nueva tarea de depuración de pistas, complete los siguientes campos y, a continuación, haga clic en Enviar:
      1. En Nombre de la operación, introduzca un nombre para la tarea de depuración.
      2. En Pista, introduzca un nombre de archivo de pista y, a continuación, haga clic en Agregar pista (icono de signo mas). Repita este paso para agregar más archivos de pista. Pistas seleccionadas se rellena con los nombres de los archivos del pista a medida que los agrega.
      3. Mantenga habilitada la opción Usar Puntos de Control si desea depurar después de la finalización de todos los procesos de Extract y Replicat con los archivos, como se indica en los puntos. La desactivación de esta opción permite la depuración sin tener en cuenta los puntos de control y se conserva un mínimo de un archivo (si no se especifica ningún valor MIN) o el número de archivos especificado con MIN.

         Note:

         Los archivos huérfanos de punto de control no se pueden suprimir en la consola de despliegue. Utilice las API de REST para suprimir archivos huérfanos de punto de control.
      4. En Mantener regla, especifique las horas, los días o la cantidad de archivos que desea conservar.
      5. En Frecuencia a depurar, especifique la frecuencia para ejecutar esta tarea de depuración.

   Puede agregar más tareas de depuración o desactivarlas según sea necesario.

3. Limpie los archivos de pista no utilizados mediante el cliente de administración.
   1. En la página Detalle del despliegue, haga clic en Iniciar cliente de administración.
      Si se conecta a un despliegue de OCI GoldenGate con un punto final privado, siga las instrucciones de Conexión al cliente de administración a través de Cloud Shell.
   2. Ejecute el siguiente comando para depurar los archivos que ya no utilicen los Extracts:

      purge exttrail <trail-file-name>

      Para obtener más información, consulte PURGE EXTTRAIL en la guía GoldenGate Command Line Reference.
4. Limpie los archivos de pista no utilizados mediante las API REST.
   1. Abrir Cloud Shell.
   2. En Cloud Shell, ejecute la siguiente llamada de API de REST al despliegue de OCI GoldenGate. Asegúrese de sustituir los marcadores de posición por los valores reales del despliegue.

      curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type:
            application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ {
            "name": "<trail_file_name>" } ], "useCheckpoints": false, "keep": [ { "type":
            "min", "units": "files", "value": 0 } ]}'

Para asegurarse de que se suprimen todos los archivos de pista, puede realizar una de las siguientes acciones:

• En la página de detalles del despliegue de la consola de Oracle Cloud, seleccione Archivos de pista y, a continuación, haga clic en Refrescar para revisar la lista de archivos de pista.
• Cree otra copias de seguridad manual y compruebe en el contenido de la copia del seguimiento los archivos que deseaba conservar. Observe la reducción del tamaño agregado y la velocidad con la que se completa la copia de seguridad.

Ejemplos de REST

En los siguientes ejemplos se muestra cómo eliminar archivos de pista en diferentes condiciones:

• Por ejemplo 1
• Por ejemplo 2
• Por ejemplo 3
• Por ejemplo 4
• Por ejemplo 5
• Por ejemplo 6

Ejemplo 1: Depurar todos los archivos de pista cuyos nombres coincidan con "IL":

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "IL" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

Ejemplo 2: Purga de todos los archivos del pista, como indica el asterisco (*), dentro del subdirectorio, demo:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "*", "path": "/u02/Deployment/var/lib/data/demo" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

Ejemplo 3: Depuración de todos los archivos de pista de extracción L1:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

Ejemplo 4: Depure todos los archivos de pista cuyos nombres coincidan con "L1" pero mantenga los archivos de las últimas 10 horas:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "hours", "value": 10 } ]}'

Ejemplo 5: Depuración de todos los archivos de pista de extracción L1 con más de un día de antigüedad mediante USECHECKPOINTS:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": true, "keep": [ { "type": "min", "units": "days", "value": 1 } ]}'

Ejemplo 6: Depure todos los archivos de pista de extracción L1 que tengan más de un día de antigüedad:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "hours", "value": 23 } ]}'

---

Título e Información de Copyright

Copyright ©2022,

Oracle y/o sus filiales.