Gerenciar arquivos da Trilha

Os arquivos de Trilha do OCI GoldenGate aumentam rapidamente ao longo do 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:

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, selecione Implantações.

  2. Na página Implantações, selecione uma implantação para exibir seus detalhes ou selecione Exibir detalhes no menu de Ação da implantação.

  3. Na página Detalhes da implantação, selecione 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 principal, consulte Gerenciar wallets de chaves de criptografia.

Antes de começar

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 implantação, selecione Iniciar console.

  2. Na console de implantação, no menu de navegação, expanda Criptografia e selecione Perfis.

  3. Para o Oracle Cloud Infrastructure com Controlador de Recursos, selecione 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. Informe o Ponto final criptográfico do OCI Vault na página de detalhes do Vault.

  5. Selecione Enviar.

Criptografar sem controlador de recursos

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

  1. Na página de detalhes da implantação, selecione Iniciar console.

  2. Na console de implantação, no menu de navegação, expanda Criptografia e selecione Perfis.

  3. Para o Oracle Cloud Infrastructure, selecione Adicionar Perfil de Criptografia de Plug-in.

  4. No painel Criar Perfil de Criptografia, preencha os seguintes campos:

    1. Informe um nome de perfil.

    2. Informe 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 do seu perfil de usuário.

    7. Faça upload ou cole a Chave de API, que você pode gerar na seção Tokens e Chaves da sua página de perfil de usuário.

    8. Cole sua Impressão Digital da Chave, que está associada à sua Chave de API.

  5. Selecione 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 ao longo do 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. (Selecione o 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 utilizados 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, selecione Tarefas e, em seguida, Expurgar Trilhas.

    3. Selecione Adicionar Tarefa de Expurgação de Trilhas (ícone de adição).

    4. Em Criar uma nova tarefa Expurgar Trilhas, preencha os seguintes campos e selecione Enviar:

      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 selecione 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 depois de todos os processos de Extract e Replicat terem sido concluídos com o(s) arquivo(s), conforme indicado pelos pontos de verificação. A desativação dessa opção permite a expurgação sem considerar os pontos de verificação e o número mínimo de um arquivo (se nenhum valor MIN for especificado) ou o número de arquivos especificado com MIN for 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.

      1. Para Manter Regra, especifique as Horas, Dias ou Número de Arquivos a serem mantidos.

      2. 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 de detalhes da implantação, selecione Iniciar Admin Client.

      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:

Exemplos de REST

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

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

Limpar todos os arquivos de 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

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