O comando `manualvacuum` do nz

O comando nz manualvacuum executa uma operação abrangente de limpeza e reindexação em todos os bancos de dados da sua instância do NPSaaS. Essa operação de manutenção ajuda a recuperar espaço em disco e otimizar o desempenho do banco de dados, removendo dados obsoletos e reconstruindo índices. Este comando foi introduzido na versão 11.3.1.3 do nzcli.

Visão geral

A operação manual de vácuo é uma tarefa de manutenção essencial que:

Interrompe o sistema NPS (nzstop)
Cria um backup dos dados do catálogo
Executa operações de limpeza e reindexação em todos os bancos de dados
Reinicia o sistema NPS (nzstart)

O sistema ficará indisponível durante essa operação, que pode demorar bastante, dependendo do tamanho dos seus bancos de dados.

Pré-requisitos

Antes de executar a operação de vácuo manual, certifique-se de que:

Você possui acesso administrativo à instância do NPSaaS
Você baixou e configurou a ferramenta de linha de comando do nz, versão 11.3.1.3 ou posterior
Você definiu as variáveis de ambiente necessárias (APISERVER_URL, NZ_USER, NZ_PASSWORD) ou está preparado para fornecê-las como opções de comando
Você agendou um período de manutenção, pois o sistema ficará indisponível durante a operação
Você tem espaço em disco suficiente para o backup do catálogo

Sintaxe

nz manualvacuum [options]

Opções

Opção	Descrição
`-apiserver <APISERVER>`	O `URL` do servidor da API. Pode ser definido por meio da variável de ambiente APISERVER_URL . (obrigatório)
`-u <USER>`	Nome de usuário do NPS. Pode ser definido por meio da variável de ambiente NZ_USER . (obrigatório)
`-pw <PASSWORD>`	Senha do NPS. Pode ser definido por meio da variável de ambiente NZ_PASSWORD . (obrigatório)
`-force`	Ignore a solicitação de confirmação e prossiga com a operação imediatamente
`-format <FORMAT>`	Formato de saída dos resultados do comando
`-host <HOST>`	O `URL` do servidor da API. Pode ser definido usando a variável de ambiente NZ_HOST

Exemplos

Execução do vácuo manual com solicitação de confirmação

./nz manualvacuum -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>

O comando exibe um aviso e solicita confirmação:

  WARNING: Manual Vacuum Operation
=====================================
This operation will:
  1. Stop NPS (nzstop)
  2. Run nz_manual_vacuum
  3. Start NPS (nzstart)
This process may take significant time and will restart the system.
The system will be unavailable during this operation.
Do you want to continue? (yes/no):

Execução do vácuo manual sem confirmação

Use a opção “ -force ” para ignorar a solicitação de confirmação:

./nz manualvacuum -force -apiserver <apiserver-url> -u <nps-admin-user> -pw <nps-admin-user-password>

Utilização de variáveis de ambiente

Defina variáveis de ambiente para evitar a necessidade de especificar credenciais no comando:

export APISERVER_URL=<apiserver-url>
export NZ_USER=<nps-admin-user>
export NZ_PASSWORD=<nps-admin-user-password>
./nz manualvacuum -force

Fluxo de trabalho da operação

Ao executar o comando nz manualvacuum , o seguinte fluxo de trabalho é executado. Internamente, o comando invoca o binário do sistema nz_manual_vacuum no host do NPS.

Parada do sistema : O sistema NPS é parado por meio do comando nzstop
Backup do catálogo: É criado um backup dos dados do catálogo em /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
Vácuo e reindexação: A operação executa o vácuo e a reindexação em:
- A tabela de sistema _T_OBJECT
- Todos os bancos de dados de usuários e do sistema, em sequência
Inicialização do sistema : O sistema NPS é reiniciado usando o comando nzstart
Conclusão: A operação é concluída e exibe um resumo dos resultados

Saída e registros

A operação manual do vácuo gera:

Arquivo de log: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.log
Arquivo de backup: /nz/manual_vacuum/nz_manual_vacuum.<timestamp>.tar.gz
Saída do console: Informações detalhadas sobre o andamento, incluindo:
- Identificador da operação e carimbo de data/hora
- Status da execução do comando
- Informações de tempo para cada banco de dados
- Comparação de tamanhos (antes e depois)
- Status de conclusão

Saída de Amostra

Manual vacuum completed successfully
Output:
================================================================================
Manual Vacuum Workflow Started
Handle: nzrest.68n6kkr8.manual_vacuum
User: admin
Timestamp: 2026-06-09 14:08:12,790
================================================================================
# Database 1 of 19          SYSTEM
     TIMINGS (vacuum    ):  Elapsed Time:     0.21
     TIMINGS (reindex   ):  Elapsed Time:     0.39
...
###############################################################################
    Size Before      Size After  Pathname
=============== ===============  =========================================================
     3924887043      3915646467  /data/catalog/data.1.0
###############################################################################
   log file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.log
backup file: /nz/manual_vacuum/nz_manual_vacuum.20260609_140932.tar.gz
================================================================================
Manual Vacuum Workflow Completed Successfully
All commands executed without errors
================================================================================

Melhores práticas

Programe as operações manuais de vácuo durante os intervalos de manutenção, quando o sistema puder ficar fora de operação
Verifique o espaço em disco antes de executar a operação para garantir que haja espaço suficiente para o backup do catálogo
Analise os arquivos de log após a conclusão para verificar se a execução foi bem-sucedida
Leve em consideração o tamanho dos seus bancos de dados ao planejar a janela de manutenção, pois bancos de dados maiores exigem mais tempo
Guarde os arquivos de backup para fins de recuperação até verificar se a operação foi concluída com sucesso

O comando manualvacuum do nz