Gerenciar arquivos da Trilha

Os arquivos de trilha do OCI GoldenGate aumentam rapidamente com o tempo. Sem tarefas de expurgação em vigor para gerenciar esses arquivos de trilha, os backups diários levarão exponencialmente mais tempo para serem concluídos e usarão recursos de computação que poderiam, de outra forma, ser usados em outro lugar.

Observação:

Essas informações se aplicam apenas a implantações de replicação de Dados.

Exibir arquivos de Trilha

Você pode exibir detalhes dos arquivos de Trilha, como tamanho, sequência, produtores e consumidores, na página de detalhes da implantação.

Para exibir arquivos de Trilha:

1. Na página Visão Geral do GoldenGate, clique em Implantações.
2. Na página Implantações, selecione uma implantação para exibir seus detalhes ou selecione Exibir detalhes no menu Ação da implantação.
3. Na página de detalhes da Implantação, clique em Arquivos de trilha.

Use essas informações para identificar arquivos de Trilha que não são mais usados ou necessários e, em seguida, crie tarefas de Expurgação para gerenciá-los.

Criptografar arquivos de Trilha

Você pode criptografar arquivos de trilha usando perfis de criptografia na console de implantação ou criando wallets de chave de criptografia mestra. Este tópico abrange perfis de Criptografia com e sem controladores de recursos. Para obter informações sobre wallets de chave de criptografia mestra, consulte Gerenciar wallets de chaves de criptografia.

Antes de continuar, verifique se você tem:

• Acesso ao serviço Vault e a um Vault criado.

  Observação:

  Não é necessário um vault privado virtual.
• Adicionadas as políticas mínimas necessárias para o OCI GoldenGate usar o serviço Vault.

Criptografar com controlador de recursos

Controlador de recursos é um recurso do IAM (Identity and Access Management) que autoriza recursos a agir como atores principais que executam ações em seus recursos. Cada recurso tem sua própria identidade, e o recurso se autentica usando os certificados que são incluídos nele. Esses certificados são criados automaticamente, atribuídos a recursos e rotacionados, evitando a necessidade de criar e gerenciar suas próprias credenciais para acessar o recurso.

Você pode usar controladores de recursos para acessar sua chave do Vault, que pode ser usada para criptografar arquivos de trilha. Para isso, sua implantação deve ter acesso à chave do Vault selecionada. Certifique-se de ter revisado os requisitos listados acima nos arquivos de trilha de Criptografia, especialmente as políticas mínimas necessárias para o serviço Vault.

Para criptografar arquivos de trilha usando um controlador de recursos:

1. Na página de detalhes da sua implantação, clique em Iniciar console.
2. Na console de implantação, no menu de navegação, expanda Criptografia e selecione Perfis.
3. Para Oracle Cloud Infratstructure with Resource Principal, clique em Adicionar Perfil de Criptografia de Plug-in.
4. No painel Criar Perfil de Criptografia, preencha os seguintes campos:
   1. Em Nome do Perfil, informe um nome para esse perfil de criptografia.
   2. (Opcional) Adicione uma descrição.
   3. Cole o OCID da Chave do OCI Vault do seu OCI Vault. Você pode encontrar isso na página de detalhes da Chave de Criptografia no Vault.
   4. Digite o Ponto final criptográfico do OCI Vault na página de detalhes do Vault.
5. Clique em Enviar.

Criptografar sem controlador de recursos

Para criptografar arquivos de trilha sem usar um controlador de recursos:

1. Na página de detalhes da sua implantação, clique em Iniciar console.
2. Na console de implantação, no menu de navegação, expanda Criptografia e selecione Perfis.
3. Para Oracle Cloud Infratstructure, clique em Adicionar Perfil de Criptografia de Plug-in.
4. No painel Criar Perfil de Criptografia, preencha os seguintes campos:
   1. Digite um nome de perfil.
   2. Digite uma Descrição.
   3. Cole no URL do Ponto Final de Criptografia, que você pode encontrar na página de detalhes do Vault.
   4. Cole no OCID da Tenancy, que você pode encontrar na página de detalhes da Tenancy.
   5. Cole no OCID da Chave, que você pode encontrar na página de detalhes da Chave.
   6. Cole no OCID do Usuário, que você pode encontrar na página de perfil do usuário.
   7. Faça upload ou cole a Chave de API, que você pode gerar na seção Tokens e Chaves da página de perfil do usuário.
   8. Cole sua Impressão Digital da Chave, que está associada à sua Chave de API.
5. Clique em Enviar.

Para obter mais informações, consulte Usando a Criptografia de Arquivos de Trilha do OCI KMS no Oracle GoldenGate.

Expurgar arquivos de Trilha

Os arquivos de trilha do OCI GoldenGate aumentam rapidamente com o tempo. Sem tarefas de expurgação em vigor para gerenciar esses arquivos de Trilha, os backups diários levarão exponencialmente mais tempo para serem concluídos e usarão recursos de computação que poderiam, de outra forma, ser usados em outro lugar.

A Oracle recomenda que você crie um backup antes de expurgar os arquivos de Trilha. Consulte Create a manual backup. Você pode fazer download do backup e revisar seu conteúdo (<deployment-name>/var/lib/data/).

Para expurgar arquivos de Trilha do OCI GoldenGate:

1. Na console de implantação do OCI GoldenGate, revise os seguintes processos que geram arquivos de Trilha e anote os arquivos de Trilha que você deseja manter:
   • No Serviço de Administração, verifique os detalhes de cada Extract e Replicat. (Clique no nome do processo e selecione Detalhes.)
   • No Serviço de Distribuição, revise os detalhes de cada Caminho de Distribuição (se houver).
   • No Serviço do Receptor, verifique os detalhes de cada Caminho do Receptor (se houver).

   Todos os outros arquivos de Trilha que não estão na sua lista podem ser expurgados.

2. Configure Tarefas de Expurgação para limpar arquivos de Trilha não usados na console de implantação.
   1. Na console de implantação do OCI GoldenGate, abra o menu de navegação (ícone de hambúrger) do Serviço de Administração e selecione Configuração.
   2. Na página Configuração, clique em Tarefas e em Expurgar Trilhas.
   3. Clique emAdicionar Tarefa de Expurgação de Trilhas (ícone de adição).
   4. Em Criar uma nova tarefa Expurgar Trilhas, preencha os seguintes campos e clique em Submeter:
      1. Para Nome da Operação, informe um nome para a tarefa da expurgação.
      2. Para Trilha, informe um nome de um arquivo da Trilha e clique em Adicionar Trilha (ícone de sinal de mais). Repita esta etapa para adicionar mais arquivos de Trilha. As Trilhas Selecionadas são preenchidas com os nomes dos arquivos da Trilha à medida que você os adiciona.
      3. Mantenha Usar Pontos de Verificação ativado se quiser expurgar após todos os processos de Extract e Replicat terem sido concluídos com o(s) arquivo(s), conforme indicado(s). A desativação dessa opção permite a expurgação sem considerar checkpoints e no mínimo um arquivo (se nenhum valor MIN for especificado) ou o número de arquivos especificados com MIN será mantido.

         Observação:

         Os arquivos de Checkpoint Órfãos não podem ser excluídos na console de implantação. Use APIs REST para excluir arquivos de Checkpoint órfãos.
      4. Para Manter Regra, especifique as Horas, Dias ou Número de Arquivos a serem mantidos.
      5. Para Frequência da Expurgação, especifique a frequência para executar esta tarefa.

   Você pode adicionar mais Tarefas de Expurgação ou desativá-las conforme necessário.

3. Limpar arquivos de Trilha não utilizados usando o Admin Client.
   1. Na página detalhes da implantação, clique em Iniciar Cliente Admin.
      Se estabelecer conexão com uma implantação do OCI GoldenGate com um ponto final privado, siga as instruções em Estabelecer Conexão com o Admin Client por meio do Cloud Shell.
   2. Execute o seguinte comando para expurgar arquivos da trilha não mais usados por Extrações:

      purge exttrail <trail-file-name>

      Para obter mais informações, consulte PURGE EXTTRAIL no guia GoldenGate Command Line Reference.
4. Limpe arquivos de Trilha não usados usando APIs REST.
   1. Abrir Cloud Shell.
   2. No Cloud Shell, execute a chamada de API REST a seguir para a implantação do OCI GoldenGate. Certifique-se de substituir os placeholders pelos valores reais da sua implantação.

      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 garantir que todos os arquivos de Trilha sejam excluídos, você pode executar um dos seguintes procedimentos:

• Na página de detalhes da implantação na console do Oracle Cloud, selecione Arquivos de trilha e clique em Atualizar para revisar a lista de arquivos de Trilha.
• Crie outro backup manual e verifique o conteúdo do backup para os arquivos da Trilha que deseja manter. Observe a redução do tamanho agregado e a velocidade com que o backup agora é concluído.

Exemplos de REST

Os exemplos a seguir mostram como remover arquivos de Trilha em diferentes condições:

• Exemplo 1
• Exemplo 2
• Exemplo 3
• Exemplo 4
• Exemplo 5
• Exemplo 6

Exemplo 1: Expurgar todos os arquivos de Trilha cujos nomes correspondam 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 } ]}'

Exemplo 2: Expurgue todos os arquivos da Trilha, conforme indicado pelo asterisco (*), no subdiretório, 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 } ]}'

Exemplo 3: Expurgar todos os arquivos de Trilha de Extração 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 } ]}'

Exemplo 4: Expurgue todos os arquivos de Trilha cujos nomes correspondam a "L1", mas mantenha os arquivos das ú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 } ]}'

Exemplo 5: Expurgue todos os arquivos da Trilha de Extração L1 com mais de um dia usando 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 } ]}'

Exemplo 6: Expurgue todos os arquivos da Trilha de Extração L1 com mais de um dia:

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 Informações de Copyright

Copyright ©2022,

Oracle e/ou suas empresas afiliadas.