Diagnosticar e corrigir problemas com o Genie

Na interface do Lakebase, o Genie diagnostica e corrige a sua base de dados. Fazes uma pergunta sobre um problema específico por palavras tuas, e este investiga usando a mesma telemetria que o Insights: estado em tempo real do Postgres, planos de execução de consultas, eventos de espera e histórico de DDL e alterações ao esquema. Este é o mesmo Genie que usas em todo o Lakehouse e nas Apps; aqui, funciona no teu projeto Lakebase.

O Genie funciona como uma conversa passo a passo: mostra o seu raciocínio e pede-lhe que aprove cada ação, incluindo as consultas que executa durante a investigação. Qualquer correção, incluindo uma alteração na base de dados, precisa da sua confirmação explícita antes de ser aplicada.

Esta página percorre um incidente comum de produção (uma implementação que deixa uma coluna que a aplicação ainda consulta) para mostrar como é pedir ajuda ao Genie de ponta a ponta.

Pré-requisitos

• Um projeto Lakebase na AWS ou Azure, com observabilidade configurada. Ver Configurar observabilidade.

O cenário

Uma alteração de esquema é executada ALTER TABLE users DROP COLUMN bio como parte de uma implementação rotineira. A aplicação ainda lê essa coluna na sua página de perfil. Em poucos minutos, os pedidos na página de perfil começam a falhar com column "bio" does not exist, e a taxa de erro da aplicação aumenta.

Como funciona uma investigação do Genie

O que o Genie encontra e recomenda depende dos teus dados e do problema por detrás deles, por isso trata isto como ilustrativo, não como um script que vais ver literalmente. Abre o Genie a partir do teu projeto (ele capta automaticamente o contexto do teu projeto, branch e endpoint) e descreve o sintoma. A partir daí, uma investigação típica passa por quatro fases:

Descreveste o sintoma

Pergunte em linguagem simples, como se diria a um colega: "Porque é que a taxa de erro está a aumentar?" Não precisa de saber a causa, a consulta falhada ou qual a tabela envolvida.

Génio correlaciona e lê a história

Associa o erro à consulta falhada e depois verifica o histórico DDL para ver o que mudou. O histórico DDL não capta todas as alterações (uma feita exatamente quando um cálculo recomeça da escala para zero pode ser ignorada), por isso, quando falta um registo, o Genie diz isso e volta a comparar as colunas atuais da tabela com o que a consulta espera. De qualquer forma, identifica bio como a coluna removida. Esta é a mesma história que o Insights lê, para que o Génio possa continuar de onde um insight de fundo parou.

Génio propõe uma recuperação, baseada no que encontrou

Normalmente, começa com um branch point-in-time criado imediatamente antes da alteração: um clone instantâneo, copy-on-write, que partilha o armazenamento com o ambiente de produção, pelo que é suficientemente barato criar um para qualquer correção. A partir desse momento, a recuperação faz-se em diálogo: o Genie pode copiar os dados em falta novamente para a tua tabela atual ou migrar a tua aplicação para o ramo restaurado. Alguns percursos exigem um detalhe da sua parte durante o processo, como uma cadeia de ligação que o Genie não consegue descobrir por si só.

Confirmas antes de qualquer coisa ser aplicada

O Génio nunca restaura, modifica ou aplica uma correção sozinho. Reporta as ações que toma, mas verifica as consequentes (um ponto de restauro, um ramo eliminado) na interface do Lakebase antes de confiares nelas.

Limitações a ter em conta

• Alguns elementos genéricos da interface do Genie (como Personalizações, Automações, Espaços e Adicionar contexto) aparecem atualmente no Genie, mas ainda não funcionam.
• Uma conversa no Genie continuada fora da interface do Lakebase (por exemplo, a partir de um caderno) mantém o histórico da conversa, mas perde as ferramentas e o contexto da página original. Inicie novas investigações dentro do projeto Lakebase para obter os resultados mais fiáveis.
• As ramificações e os endpoints aparecem pelo ID interno, não por um nome apresentado como "production". Se a resposta do Genie for ambígua sobre a ramificação ou o endpoint a que se refere, confirme o ID na interface do Lakebase. Para mais informações, consulte as limitações de telemetria.

Passos seguintes

• Encontre e resolva problemas com o Insight: ative a monitorização proativa para que problemas como este surjam antes de ter de perguntar.
• Referência da tabela de telemetria: as tabelas que o Genie lê e as limitações atuais.
• Restaure um projeto: Saiba mais sobre a recuperação pontual fora do Genie. Veja restauração pontual no tempo.