Gestisci file trail

I file OCI GoldenGate Trail vengono aggiunti 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.

• Per impostazione predefinita, ogni distribuzione di replica dati rimuove automaticamente i file trail più vecchi di 21 giorni.

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 di GoldenGate, selezionare 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, selezionare 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 iniziare

• Accesso al servizio Vault e a un Vault creato.

  Nota: non è necessario un vault privato virtuale.

• È stato aggiunto il criteri minimi richiesti per consentire a OCI GoldenGate di utilizzare il servizio Vault.

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 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 selezionare Avvia console.

2. Nel menu di navigazione della console di distribuzione espandere Cifratura, quindi selezionare Profili.

3. Per Oracle Cloud Infrastructure con principal risorsa, selezionare Aggiungi profilo di cifratura plugin.

4. Nel pannello Crea profilo di cifratura, completare i campi riportati di seguito.

   1. In 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. È possibile trovarlo 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. Selezionare Sottometti.

Cifra senza principal risorsa

Per cifrare i file trail senza utilizzare un principal risorsa:

1. Nella pagina dei dettagli della distribuzione selezionare Avvia console.

2. Nel menu di navigazione della console di distribuzione espandere Cifratura, quindi selezionare Profili.

3. Per Oracle Cloud Infrastructure, selezionare 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 endpoint crittografico, che è possibile trovare nella pagina dei dettagli del vault.

   4. Incollare l'OCID tenancy, che è possibile trovare nella pagina dei dettagli della tenancy.

   5. Incollare l'OCID chiave 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. Selezionare Sottometti.

Per ulteriori informazioni, vedere Uso della cifratura dei file trail di OCI KMS in Oracle GoldenGate.

Rimuovi file trail

I file OCI GoldenGate Trail vengono aggiunti 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 OCI GoldenGate Trail:

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, esaminare 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, selezionare Task, quindi selezionare Rimuovi trail.

   3. Selezionare Aggiungi task rimozione trail (icona più).

   4. In Crea un nuovo task Rimuovi trail completare i campi riportati di seguito, quindi selezionare Sottometti.

      1. In Nome operazione, immettere un nome per il task di rimozione.

      2. In Trail, immettere il nome di un file trail, quindi selezionare 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 specificato con MIN.

      Nota: i file di checkpoint isolati non possono essere eliminati nella console di distribuzione. Utilizzare le API REST per eliminare i file di checkpoint isolati.

      1. Per Conserva regola, specificare le ore, i giorni o il numero di file da conservare.

      2. 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 selezionare Avvia client di amministrazione.

      Se ci si connette a una distribuzione GoldenGate OCI 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 dell'API REST seguente alla distribuzione GoldenGate OCI. 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 selezionare 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

Rimuovi 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

Rimuovi tutti i file trail 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

Rimuove tutti i file trail i cui nomi corrispondono a "L1" ma conserva 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

Rimuove tutti i file trail estrazione L1 di 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

Rimuove tutti i file trail 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 } ]}'