Declaração de integridade dos dados

Este documento responde a três perguntas: o que existe de fato dentro do seu backup, se você pode confiar nele e em que situações ele não vai estar completo.

Resumo

• Todo backup é um backup completo.
• Um backup contém páginas, bancos de dados e fontes de dados, views de banco de dados, linhas de banco de dados, blocos, comentários (com opção de ligar ou desligar), usuários, arquivos anexos e arquivos de mídia externos (com opção de ligar ou desligar).
• O mesmo conteúdo é guardado uma vez só. Tanto os dados em si quanto os arquivos independentes são armazenados com deduplicação, então apagar uma versão não quebra os arquivos que outras versões ainda referenciam.
• Todo backup gera um relatório completo, com a contagem de páginas, bancos de dados, linhas de banco de dados, blocos, comentários, views e usuários, além de avisos ou erros.
• A exportação e a importação do arquivo levam verificação de integridade.
• A integridade tem limites: o conteúdo fora das permissões da integração, os campos que a Notion API não devolve, alguns problemas conhecidos do lado do Notion e o teto de objetos por tarefa da versão gratuita.

1. O que existe em um backup

Um backup inclui:

• Páginas: corpo, propriedades, ícone, capa e a posição na hierarquia
• Bancos de dados e fontes de dados: estrutura das propriedades, opções e relações
• Views de banco de dados: a configuração das views de tabela, quadro, calendário, linha do tempo, galeria e lista, junto com os filtros, a ordenação e o agrupamento de cada uma
• Linhas de banco de dados: os valores das propriedades de cada linha
• Blocos (o conteúdo do corpo): formatação em linha e estrutura aninhada
• Comentários: comentários não resolvidos em um arquivo ou em um bloco. A Notion API não devolve comentários resolvidos, então eles não podem ser copiados. Você pode ligar ou desligar o backup de comentários
• Usuários: as informações dos colaboradores que aparecem no conteúdo, usadas para reconstruir “quem escreveu”
• Arquivos anexos: imagens e arquivos hospedados pelo Notion
• Arquivos de mídia externos: arquivos externos vinculados nas páginas, como PDFs, imagens e vídeos. Você pode ligar ou desligar o download desses arquivos

Todo arquivo baixado para a sua máquina passa a ser uma referência relativa dentro do repositório, então mover o diretório do repositório ou trocar de máquina não invalida essas referências.

Tudo isso fica no diretório de repositório que você escolheu. Os snapshots estruturados ficam no arquivo de banco de dados local dentro do repositório, e os arquivos baixados ficam no diretório attachments do repositório.

2. Como a integridade é garantida

Coleta completa. Todo backup percorre por inteiro o escopo que você compartilhou com a integração e reconfirma o estado atual de cada objeto, um por um. A Notion API não oferece um fluxo de mudanças confiável, então em teoria não dá para fazer um backup incremental que garanta integridade.

Salto na camada de escrita. Coleta completa não é reescrita completa: snapshots cujo conteúdo não mudou não precisam ser reescritos, e o mesmo conteúdo não é guardado duas vezes. As contagens de “alterados / ignorados” no relatório descrevem exatamente essa diferença.

Segurança contra queda. Se a máquina perde energia ou o programa quebra no meio de um backup, a tarefa pode ser retomada com segurança, sem danificar a integridade dos dados que já existiam.

Deduplicação por conteúdo. O conteúdo dos blocos é guardado pelo hash do conteúdo, com contagem de referências.

Deduplicação de arquivos independentes. Os anexos são deduplicados por um identificador de arquivo estável.

Relatório de backup. Ao final do backup sai a estatística: a quantidade de páginas, bancos de dados, linhas de banco de dados, blocos, comentários, views e usuários, além de alterados e ignorados, falhas e avisos.

Exportação e importação do arquivo. O arquivo do repositório inteiro (a exportação em arquivo único para backup frio) primeiro grava em disco as escritas pendentes no banco de dados do repositório, garantindo que o arquivo tenha um estado completo e consistente; na importação, o banco de dados dentro do arquivo passa primeiro por uma verificação de integridade, e se a verificação falhar o aplicativo retorna erro e recusa a importação.

3. Limites da integridade

Limite do escopo do backup. O NotionManager oferece um controle mais fino, e você escolhe o que entra no backup; o conteúdo que não foi compartilhado com a integração, ou que não foi selecionado no escopo do backup, não é percorrido.

Limites conhecidos da Notion API:

• Tipos de bloco não suportados. A documentação da Notion API afirma claramente que alguns tipos de bloco não são suportados, e os dados desses blocos ficam indisponíveis para qualquer aplicativo que dependa da Notion API.
• Estilo das views e propriedades que podem ser exibidas, entre outros: isso afeta apenas como a cópia aparece quando você navega nela localmente.

Informações de gestão do lado do Notion. O histórico de versões do lado do Notion (o histórico da página), os dados da lixeira e afins estão fora do que a Notion API oferece e, portanto, também fora do backup.

4. Limites da licença

O NotionManager pode ser usado de graça, mas os recursos são limitados. Os limites que dizem respeito à integridade dos dados são:

• Versão gratuita: teto de objetos em uma única tarefa de backup e teto de navegação de views (você só consegue abrir uma view). O teto de objetos é contado por tarefa, então você pode criar vários perfis e dividir um workspace grande em vários backups; dentro do limite de cada tarefa, os dados são copiados por completo. A versão gratuita também aceita importar um backup exportado por outra pessoa, que abre em modo somente leitura; o teto de objetos vale para os backups que você executa, não para o que o backup importado já contém.
• Licença pessoal (Basic e Premium): não é possível exportar o repositório inteiro como um arquivo único.
• Licenças de equipe e corporativa: é possível exportar o repositório inteiro como um arquivo único, e também importar esse arquivo de volta.

Existem mais recursos vinculados a licenças específicas, mas eles não dizem respeito à integridade dos dados e não são tratados aqui.

5. O que pedimos de você

• Mantenha cópias pela regra 3-2-1: basta copiar o diretório inteiro do repositório para outra mídia (um disco externo, um NAS, armazenamento de objetos), e essa etapa não tem relação com a licença. Um backup local também desaparece com disco defeituoso, diretório apagado por engano ou ransomware, e a “cópia em outro lugar ou offline” existe justamente para esse caso. As licenças de equipe e corporativa ainda permitem gravar o arquivo do repositório inteiro (pacote em arquivo único), como formato de arquivamento e de mudança de máquina; a versão gratuita também importa backups exportados por outras pessoas e os abre em somente leitura.
• Confira o relatório de backup e verifique se as quantidades de cada tipo de objeto batem com o tamanho do seu workspace; quando um número parecer estranho, descubra a causa antes de confiar nesse backup.
• Acompanhe a saúde do disco: setores defeituosos no disco onde fica o repositório corrompem o backup diretamente, então coloque o repositório em armazenamento confiável e deixe as cópias offline em mídias diferentes.