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.

Nota:

Esta información solo se aplica a los despliegues de replicación de datos.
Por defecto, cada despliegue de replicación de datos depura automáticamente los archivos de pista con una antigüedad superior a 21 días.

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:

En la página Visión general de GoldenGate, seleccione Despliegues.
En la página Despliegues, seleccione un despliegue para ver los detalles o seleccione Ver detalles en el menú Acción del despliegue.
En la página Detalles de despliegue, seleccione 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 empezar

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

Nota: No es necesario 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 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:

En la página de detalles del despliegue, seleccione Iniciar consola.
En la consola de despliegue, en el menú de navegación, amplíe Cifrado y, a continuación, seleccione Perfiles.
En Oracle Cloud Infrastructure con entidad de recurso, seleccione Agregar perfil de cifrado de plugin.
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 de Vault.
Seleccione Enviar.

Cifrar sin entidad de recurso

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

En la página de detalles del despliegue, seleccione Iniciar consola.
En la consola de despliegue, en el menú de navegación, amplíe Cifrado y, a continuación, seleccione Perfiles.
En Oracle Cloud Infrastructure, seleccione Agregar perfil de cifrado de plugin.
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.
Seleccione 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

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:

En la consola de implementación de OCI GoldenGate, revise los siguientes procesos que generan archivos del pista y tome nota de los archivos del pista que desea conservar:
- En el servicio de administración, revise los detalles de cada Extract y Replicat. (Seleccione 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.
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 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, seleccione Tareas y, a continuación, seleccione Depurar Pistas.
3. Seleccione Add Purge Trails Task (Icono de signo más).
4. En Crear una nueva tarea de depuración de pistas, complete los siguientes campos y, a continuación, seleccione 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, seleccione 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 depurar sin tener en cuenta el punto de control y se conserva un mínimo de archivo (si no se especifica ningún valor MIN) o el número de archivos especificados con MIN.
  Nota: 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 de punto de control huérfanos.
  1. En Mantener regla, especifique las horas, los días o la cantidad de archivos que desea conservar.
  2. 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.
Limpie los archivos de pista no utilizados mediante el cliente de administración.
1. En la página de detalles del despliegue, seleccione 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 Referencia de línea de comandos de GoldenGate.

Limpie los archivos de pista no utilizados mediante las API REST.

Abrir Cloud Shell.

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, seleccione Refrescar para revisar la lista de archivos de pista.
Cree otra copia del manual y compruebe en el contenido de la copia la seguridad de los archivos pista 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.

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

Depurar 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

Depurar todos los archivos de pista de extracción de 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

Depure 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 de 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 } ]}'