Ir para o conteúdo

Utilitários, Diagnóstico e Governança

Esta seção cobre comandos essenciais para diagnóstico de ambiente, inicialização de workspaces e auditoria de alterações no banco de dados.

1. leai init

Inicializa um diretório de trabalho criando o arquivo de modelo leai.yml.

# Inicialização padrão (em inglês):
leai init

# Inicializar modelo com comentários e exemplos em Português:
leai init --lang pt-BR

# Sobrescrever arquivo existente:
leai init -f --lang pt-BR

Parâmetros e Opções:

Parâmetro / Flag Tipo Padrão Descrição
-L, --lang LOCALE Opção en-US Idioma do modelo de configuração gerado (pt-BR ou en-US).
-f, --force Flag False Sobrescreve o arquivo leai.yml existente sem confirmação prévia.
-o, --output PATH Opção leai.yml Caminho do arquivo de configuração a ser gerado.

2. leai doctor

Executa uma bateria preventiva de testes automatizados para garantir a integridade do ambiente.

leai doctor

Parâmetros e Opções:

Parâmetro / Flag Tipo Padrão Descrição
-c, --config PATH Opção leai.yml Caminho para o leai.yml.

O que o doctor valida:

  • Conectividade: Estabelece conexão com o listener do Oracle Database e valida versão em v$version.
  • Permissões de Catálogo: Valida acesso de leitura em ALL_TABLES, ALL_TAB_COLUMNS, ALL_CONSTRAINTS, ALL_SOURCE e ALL_SYNONYMS.
  • Diretórios do Pipeline: Verifica existência e permissão de escrita em rawPath, annotationsPath, docPath e updates_log_path.
  • Armazenamento S3: Testa conectividade e bucket do SeaweedFS caso configurado, com dicas de troubleshooting em caso de falha.
  • Modelos de IA: Verifica se as credenciais do provedor de IA estão ativas e o modelo pronto para responder.
  • GitOps: Valida branch ativa e sincronização com repositório remoto Git/GitLab.

[!TIP] O diagnóstico também pode ser executado diretamente de dentro do terminal interativo (leai chat) digitando /doctor.

3. leai changes

Analisa e lista objetos do banco criados ou modificados recentemente através da coluna LAST_DDL_TIME do dicionário de dados da Oracle.

leai changes --days 15
leai changes --days 30 -u HR

Parâmetros e Opções:

Parâmetro / Flag Tipo Padrão Descrição
-d, --days INT Opção 7 Quantidade de dias anteriores a auditar.
-u, --user TEXT Opção None Filtra por usuário ou schema Oracle específico.
-c, --config PATH Opção leai.yml Caminho para o arquivo leai.yml.
--seaweed Flag False Compara snapshots persistidos no bucket S3.
--no-cache Flag False Não grava snapshots no disco local.