Gestisci file trail

I file trail OCI GoldenGate si sommano rapidamente nel tempo. Senza i task di rimozione in atto per gestire questi file trail, il completamento dei backup giornalieri richiederà in modo esponenziale più tempo e l'utilizzo di risorse di computazione che altrimenti potrebbero essere utilizzate altrove.

Nota

Queste informazioni si applicano solo alle distribuzioni di replica dei dati.

Argomenti correlati

Visualizza file trail

È possibile visualizzare i dettagli dei file trail, ad esempio dimensione, sequenza, producer e consumer, nella pagina dei dettagli della distribuzione.

Per visualizzare i file trail:
  1. Nella pagina Panoramica GoldenGate, fare clic su Distribuzioni.
  2. Nella pagina Distribuzioni, selezionare una distribuzione per visualizzarne i dettagli oppure selezionare Visualizza dettagli dal menu Azione della distribuzione.
  3. Nella pagina Dettagli distribuzione, fare clic su File trail.

Utilizzare queste informazioni per identificare i file trail non più utilizzati o necessari, quindi creare i task di rimozione per gestirli.

Cifra file trail

È possibile cifrare i file trail utilizzando i profili di cifratura nella console di distribuzione o creando wallet di chiavi di cifratura master. Questo argomento descrive i profili di cifratura con e senza principal risorsa. Per informazioni sui wallet delle chiavi di cifratura master, vedere Gestisci wallet delle chiavi di cifratura.

Prima di procedere, assicurarsi di disporre dei seguenti elementi:

Cifra con principal risorsa

Un principal risorsa è una funzione di IAM (Identity and Access Management) che autorizza le risorse ad agire come attori principali che eseguono azioni sulle risorse. Ogni risorsa ha la propria identità e la risorsa esegue l'autenticazione utilizzando i certificati aggiunti. Questi certificati vengono creati automaticamente, assegnati alle risorse e ruotati, evitando la necessità di creare e gestire le proprie credenziali per accedere alla risorsa.

È possibile utilizzare i principal risorsa per accedere alla chiave del vault, che sarà quindi possibile utilizzare per cifrare i file trail. A tale scopo, la distribuzione deve disporre dell'accesso alla chiave vault selezionata. Assicurarsi di aver esaminato i requisiti elencati in precedenza nei file trail di cifratura, in particolare i criteri obbligatori minimi per il servizio Vault.

Per cifrare i file trail utilizzando un principal risorsa:
  1. Nella pagina dei dettagli della distribuzione fare clic su Avvia console.
  2. Nella console di distribuzione, nel menu di navigazione, espandere Cifratura, quindi selezionare Profili.
  3. Per Oracle Cloud Infratstructure with Resource Principal, fare clic su Aggiungi profilo di cifratura plugin.
  4. Nel pannello Crea profilo di cifratura, completare i campi riportati di seguito.
    1. Per Nome profilo, immettere un nome per questo profilo di cifratura.
    2. (Facoltativo) Aggiungere una descrizione.
    3. Incollare l'OCID chiave del vault OCI del vault OCI. Lo puoi trovare nella pagina dei dettagli della chiave di cifratura nel vault.
    4. Immettere l'endpoint crittografico per OCI Vault dalla pagina dei dettagli del vault.
  5. Fare clic su Sottometti.

Cifra senza principal risorsa

Per cifrare i file trail senza utilizzare un principal risorsa:
  1. Nella pagina dei dettagli della distribuzione fare clic su Avvia console.
  2. Nella console di distribuzione, nel menu di navigazione, espandere Cifratura, quindi selezionare Profili.
  3. Per Oracle Cloud Infratstructure, fare clic su Aggiungi profilo di cifratura plugin.
  4. Nel pannello Crea profilo di cifratura, completare i campi riportati di seguito.
    1. Immettere un nome profilo.
    2. Inserire una descrizione.
    3. Incollare l'URL dell'endpoint crittografico, disponibile nella pagina dei dettagli del vault.
    4. Incollare l'OCID tenancy, che è possibile trovare nella pagina dei dettagli della tenancy.
    5. Incolla nell'OCID chiave, disponibile nella pagina dei dettagli della chiave.
    6. Incollare l'OCID utente, che è possibile trovare nella pagina del profilo utente.
    7. Caricare o incollare la chiave API, che è possibile generare dalla sezione Tasti e chiavi della pagina del profilo utente.
    8. Incolla nella tua impronta digitale, associata alla tua chiave API.
  5. Fare clic su Sottometti.

Rimuovi file trail

I file trail OCI GoldenGate si sommano rapidamente nel tempo. Senza i task di rimozione in atto per gestire questi file trail, il completamento dei backup giornalieri richiederà un tempo esponenziale maggiore e l'utilizzo di risorse di computazione che altrimenti potrebbero essere utilizzate altrove.

Oracle consiglia di creare un backup prima di rimuovere i file trail. Vedere Creare un backup manuale. È quindi possibile scaricare il backup e rivederne il contenuto (<deployment-name>/var/lib/data/).
Per rimuovere i file trail di OCI GoldenGate, procedere come segue.
  1. Nella console di distribuzione OCI GoldenGate, esaminare i processi seguenti che generano file trail e prendere nota dei file trail che si desidera conservare:
    • Nel servizio di amministrazione, esaminare i dettagli di ogni Extract e Replicat. Fare clic sul nome del processo, quindi selezionare Dettagli.
    • Nel servizio di distribuzione, rivedere i dettagli di ogni percorso di distribuzione (se presente).
    • Nel servizio ricevente, rivedere i dettagli di ogni percorso ricevente (se presente).

    È possibile rimuovere tutti gli altri file trail non presenti nell'elenco.

  2. Impostare i task di rimozione per eseguire il cleanup dei file trail non utilizzati nella console di distribuzione.
    1. Nella console di distribuzione OCI GoldenGate aprire il menu di navigazione (icona hamburger) per il servizio di amministrazione, quindi selezionare Configurazione.
    2. Nella pagina Configurazione fare clic su Task, quindi su Rimuovi trail.
    3. Fare clic su Aggiungi task Storico modifiche (icona più).
    4. In Crea un nuovo task Rimuovi trail, completare i campi riportati di seguito, quindi fare clic su Sottometti:
      1. In Nome operazione, immettere un nome per il task di rimozione.
      2. In Trail, immettere il nome di un file trail, quindi fare clic su Aggiungi trail (icona più). Ripetere questo passaggio per aggiungere altri file trail. Binari selezionati inserisce i nomi dei file trail quando vengono aggiunti.
      3. Mantenere abilitata l'opzione Usa checkpoint se si desidera eseguire la rimozione dopo che tutti i processi Extract e Replicat sono stati completati con i file, come indicato dai checkpoint. La disabilitazione di questa opzione consente la rimozione senza considerare i checkpoint e di conservare almeno un file (se non viene specificato alcun valore MIN) o il numero di file specificati con MIN.

        Nota

        Impossibile eliminare i file di checkpoint isolati nella console di distribuzione. Utilizzare le API REST per eliminare i file di checkpoint isolati.
      4. Per Conserva regola, specificare le ore, i giorni o il numero di file da conservare.
      5. Per Frequenza rimozione, specificare la frequenza di esecuzione del task di rimozione.

    È possibile aggiungere altri task di rimozione o disabilitarli in base alle esigenze.

  3. Eseguire il cleanup dei file trail non utilizzati mediante il client di amministrazione.
    1. Nella pagina dei dettagli della distribuzione, fare clic su Avvia client di amministrazione.
      Se ci si connette a una distribuzione OCI GoldenGate con un endpoint privato, seguire le istruzioni riportate in Connettersi al client di amministrazione tramite Cloud Shell.
    2. Eseguire il comando seguente per rimuovere i file trail non più utilizzati dalle estrazioni:
      purge exttrail <trail-file-name>
      Per ulteriori informazioni, vedere PURGE EXTTRAIL nella guida GoldenGate Command Line Reference.
  4. Esegue il cleanup dei file trail non utilizzati mediante le API REST.
    1. Apri Cloud Shell.
    2. In Cloud Shell eseguire la chiamata API REST seguente alla distribuzione OCI GoldenGate. Assicurarsi di sostituire i segnaposto con i valori effettivi della distribuzione.
      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 } ]}'

Per assicurarsi che tutti i file trail vengano eliminati, è possibile effettuare una delle operazioni riportate di seguito.

  • Nella pagina dei dettagli di distribuzione nella console di Oracle Cloud selezionare File trail, quindi fare clic su Aggiorna per rivedere la lista dei file trail.
  • Creare un altro backup manuale e controllare il contenuto del backup per i file trail che si desidera mantenere. Si noti la riduzione della dimensione aggregata e la velocità di completamento del backup.

Esempi REST

Gli esempi riportati di seguito mostrano come rimuovere i file trail in condizioni diverse.

Esempio 1: rimozione di tutti i file trail i cui nomi corrispondono a "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 } ]}'

Esempio 2: rimuovere tutti i file trail, come indicato dall'asterisco (*), nella sottodirectory, 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 } ]}'

Esempio 3: rimozione di tutti i file trail di estrazione 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 } ]}'

Esempio 4: rimuovere tutti i file trail i cui nomi corrispondono a "L1" ma conservano i file dalle ultime 10 ore:

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

Esempio 5: rimozione di tutti i file trail di estrazione L1 con più di un giorno utilizzando 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 } ]}'

Esempio 6: rimuovere tutti i file trail di estrazione L1 che risalgono a più di un giorno:

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