Gerenciando 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.

Observação

Essas informações só se aplicam 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:

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 tem 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. Informe o Ponto final criptográfico do OCI Vault na página de detalhes do Vault.
  5. Clique em Submeter.

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. 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 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 Submeter.

Limpar 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 primeiro, antes de expurgar os arquivos de Trilha. Consulte Criar um backup manual. Em seguida, 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 GoldenGate do OCI, revise os seguintes processos que geram arquivos de Trilha e observe os arquivos que você deseja manter:
    • No Serviço de Administração, verifique os detalhes de cada processo de 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 utilizados na console de implantação.
    1. Na console de implantação GoldenGate do OCI, abra o menu de navegação ( ícone de hambúrguer) para o Serviço de Administração e selecione Configuração.
    2. Na página Configuração, clique em Tarefas e, em seguida, clique em Expurgar Trilhas.
    3. Clique em Adicionar Tarefa de Expurgação de Trilhas (ícone de mais).
    4. Em Criar uma nova tarefa Expurgar Trilhas, preencha os seguintes campos e clique em Submeter:
      1. Para Nome da Operação, digite um nome para a tarefa de expurgação.
      2. Para Trilha, informe um nome de arquivo de Trilha e clique em Adicionar Trilha (ícone de mais). Repita esta etapa para adicionar mais arquivos de Trilha. Trilhas Selecionadas são preenchidas com os nomes dos arquivos de Trilha à medida que você os adiciona.
      3. Mantenha a opção Usar Checkpoints ativada se quiser expurgar depois que todos os processos de Extract e Replicat forem finalizados com o(s) arquivo(s), conforme indicado pelos checkpoints. 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 Horas, Dias ou o Número de Arquivos a serem mantidos.
      5. Para Frequência de Expurgação, especifique a frequência de execução dessa tarefa de expurgação.

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

  3. Limpe os arquivos de Trilha não utilizados usando o Admin Client.
    1. Na página de detalhes da implantação, clique em Ativar Admin Client.
      Se estiver estabelecendo conexão com uma implantação do OCI GoldenGate com um ponto final privado, siga as instruções em Estabelecer Conexão com o Cliente Admin por meio do Cloud Shell.
    2. Execute o seguinte comando para expurgar arquivos de trilha que não são mais usados pelos processos Extract:
      purge exttrail <trail-file-name>
      Para obter mais informações, consulte PURGE EXTTRAIL no guia GoldenGate Command Line Reference.
  4. Limpe os arquivos de Trilha não utilizados usando APIs REST.
    1. Abra o Cloud Shell.
    2. No Cloud Shell, execute a chamada de API REST a seguir para a implantação GoldenGate do OCI. Certifique-se de substituir os placeholders pelos valores reais da 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 fazer o seguinte:

  • 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 de Trilha que você deseja manter. Observe a redução do tamanho agregado e a velocidade com que o backup agora é concluído.