Você não consegue quebrar nada: instantâneos e time travel

~20 minutos · um instantâneo, um olhar para o passado, um log de alterações

É novo no PlaidCloud e tem medo de estragar algo? Você não consegue. Toda vez que uma tabela é gravada, o lakehouse guarda um instantâneo do que ela continha, uma cópia consistente de um ponto no tempo, e toda alteração em um projeto é rastreada para recuperação a um ponto no tempo. Os estados antigos não desaparecem quando você os sobrescreve. Este tutorial apresenta as três redes de segurança para que você pare de andar na ponta dos pés e comece a experimentar.

A ideia inteira em uma linha. Os estados passados dos seus dados são mantidos para você automaticamente. Você não faz um backup antes de experimentar: o backup já aconteceu.

O que você vai fazer

Rede de segurança	O que ela responde
Instantâneos	“Como esta tabela era antes da minha última alteração?”
Time travel	“Posso ver os dados antigos, e não apenas saber que eles existem?”
Log do projeto	“O que aconteceu neste projeto e quem fez?”

Pré-requisitos

• Um espaço de trabalho do PlaidCloud (inicie um teste gratuito se você não tiver um)
• Um projeto com pelo menos uma tabela: qualquer tabela que você tenha importado ou criado serve
• Nada para instalar; as três ferramentas já estão integradas ao Analyze

Etapa 1: tire um instantâneo de propósito

O PlaidCloud tira um instantâneo de uma tabela a cada gravação, mas você também pode capturar um sob demanda, um bom hábito antes de qualquer coisa que você consideraria arriscada (uma recarga grande, uma edição em massa).

1. Na lista de Tabelas do projeto, abra o painel Instantâneos a partir da linha da sua tabela. Ele lista os instantâneos da tabela, do mais recente para o mais antigo.
2. Clique em Criar instantâneo para capturar os dados atuais. Dê a ele um nome que você reconheça mais tarde, como antes de eu experimentar.
3. Esse instantâneo nomeado aparece no topo da lista.

Agora você tem um ponto no tempo rotulado ao qual sempre pode voltar. Com isso em mãos, vá alterar a tabela: execute uma etapa sobre ela, edite algumas linhas, recarregue-a. Seja o que for que você faça a seguir, esse instantâneo permanece intacto.

Instantâneos nomeados são retidos, e uma retenção mantém mais do que apenas aquele instantâneo. Um instantâneo que você nomeia com Criar instantâneo ou Retenção fica fixado e é mantido além da janela normal, junto com todos os instantâneos gravados depois dele, até que você use Liberar; por isso o armazenamento continua crescendo até lá.

A nomeação depende do mecanismo da tabela; a retenção não. Nomear um instantâneo sob demanda está disponível em tabelas do Lakehouse (StarRocks). Reter e liberar um instantâneo agora também funciona em tabelas baseadas no Databend; portanto, se você não vê um campo de nome ali, você não está fazendo nada errado, e Retenção e Liberar continuam onde você esperaria.

Etapa 2: leia a lista de instantâneos

O painel Instantâneos é uma linha do tempo da vida da tabela. Cada linha diz o que mudou:

Coluna	O que mostra
Quando	Data e hora em que o instantâneo foi tirado
Linhas	A contagem de linhas da tabela naquele instantâneo
Δ Linhas	Variação na contagem de linhas em relação ao instantâneo anterior, para que você veja o que cada gravação adicionou ou removeu
Tamanho	Tamanho de armazenamento compactado do instantâneo
Rótulo	Um nome, para instantâneos que você nomeou ou fixou
Retido	Um marcador de fixação para instantâneos mantidos além da janela normal

Até onde o histórico retrocede é definido pela configuração de time travel da tabela: 1 dia por padrão, até 90 dias. Para manter mais, aumente a configuração da tabela ou do projeto antes de precisar. Consulte Gerenciamento de armazenamento.

Cada gravação deixa um instantâneo para trás. O nomeado permanece onde está, aconteça o que acontecer depois dele.

Etapa 3: viaje de volta e olhe

Saber que os dados antigos existem é tranquilizador. Vê-los é o que faz você acreditar. Há duas maneiras de ver uma tabela como ela era em um instantâneo anterior, e ambas abrem o Explorador de tabelas em uma visão histórica somente leitura, com um banner mostrando em qual instantâneo você está e um botão Voltar aos dados atuais.

1. No painel Instantâneos: selecione um instantâneo e clique em Ver no instantâneo.
2. No Explorador de tabelas: use a lista suspensa As of na barra de ferramentas. Ela lista os instantâneos recentes da tabela; escolha um para trocar a visão ou escolha Atual (dados ativos) para voltar aos dados ativos.

Abra o seu instantâneo antes de eu experimentar dessa forma e você estará olhando a tabela exatamente como ela era antes de você tocá-la: as linhas que você alterou, de volta ao que eram.

Isto é uma janela, não uma edição. A visão histórica é somente leitura. Você está olhando o passado, e não trabalhando em uma cópia editável; portanto, navegar por ela também não pode prejudicar nada. Quando estiver convencido de que os dados antigos realmente estão lá, clique em Voltar aos dados atuais.

Se um dia você quiser trazer um estado anterior de volta para a tabela ativa, o painel Instantâneos tem Reverter / Restaurar: ele pode substituir a tabela no local ou restaurar o instantâneo em uma tabela totalmente nova, deixando a original em paz. Reverter no local pede que você digite o nome da tabela para confirmar e captura primeiro um instantâneo de segurança pré-reversão, de modo que até desfazer pode ser desfeito. Você não precisa disso neste tutorial; basta saber que a porta existe. Consulte Instantâneos de tabela para o passo a passo completo.

Etapa 4: veja o que mudou em todo o projeto

Os instantâneos cobrem uma tabela. O log do projeto cobre tudo: à medida que ações acontecem em um projeto (executar fluxos de trabalho, atribuir membros e mais), o log as registra, consolidando o log de todos os fluxos de trabalho em uma única visão.

1. Abra Analisar.
2. Selecione Projetos.
3. Abra a guia Log (o log do projeto).
4. Para restringir a lista, use o controle de filtro ao lado das mensagens de log e escolha seus critérios. Para ler uma entrada por completo, clique nela com o botão direito e marque a caixa Mensagem de log para ver os detalhes.

Role para trás e você poderá refazer seus próprios passos: o experimento que executou, quando e o que ele tocou. Nada do que você fez é um mistério depois do fato.

O projeto também mantém seu próprio histórico. Além das tabelas, todas as alterações em um projeto (fluxos de trabalho, editores de dados, hierarquias, estruturas de tabela, UDFs) são rastreadas e oferecem suporte à recuperação a um ponto no tempo, para que você possa se recuperar de um erro ou copiar um estado anterior para outro lugar para comparação. Consulte Gerenciamento de projetos.

Então, vá quebrar alguma coisa

Agora você tem três formas de desfazer, revisar ou recuperar quase qualquer coisa:

• Um instantâneo que você nomeou antes de começar, mais um a cada gravação.
• Time travel para olhar qualquer um deles, somente leitura, sem se comprometer com nada.
• Um log do projeto que lembra o que aconteceu mesmo que você não lembre.

A forma mais rápida de aprender o PlaidCloud é experimentando. As redes de segurança já estão sob você: esse era o objetivo.

Para onde ir em seguida

• Instantâneos de tabela: a referência completa: a lista, time travel, reverter vs. restaurar e retenção
• Visualizar o log do projeto: ordenação, filtragem e leitura dos detalhes do log
• Gerenciamento de projetos: rastreamento de alterações, versionamento e recuperação a um ponto no tempo
• Gerenciamento de dados: tabelas, visões e o mecanismo de lakehouse por trás dos instantâneos
• Carregar, transformar e publicar dados: crie o pipeline cujas tabelas você acabou de aprender a proteger