Referência de Bancos de Dados (.base)

Última revisão: 2026-11-03

Esta página lista tudo o que um arquivo .base pode conter e o que o Plainva faz com cada parte: cada chave de nível superior, cada forma de filtro, cada tipo de visualização com suas opções, resumos, ordenação, limites, o que acontece com chaves que o Plainva não conhece e onde o Plainva se comporta de forma diferente do Obsidian Bases. Ela descreve o que o código do Plainva lê, avalia e grava hoje — não a documentação do Obsidian.

Para o uso no dia a dia, leia primeiro Bancos de Dados (.base). As regras que uma ferramenta deve respeitar ao gravar arquivos do vault diretamente, e o exemplo completo de relações, estão na Referência do Formato de Arquivo.

Visão geral

Parte do arquivoO que o Plainva faz
filtersLê e aplica as fontes (pasta, tag) e as condições listadas em Filtros
viewsLê os oito tipos de visualização, sua ordem, ordenação, filtros e resumos
propertiesLê o esquema de colunas, o nome de exibição e o bloco plainva do Plainva
summaries (visualização)Calcula os catorze resumos internos
formulasMantém no arquivo, não calcula
summaries (nível superior)Mantém as fórmulas de resumo personalizadas, não as calcula
thisAinda não é suportado
Outras chavesMantém no arquivo (veja Chaves que o Plainva não conhece)

Chaves de nível superior

Um arquivo .base é YAML com estas chaves de nível superior. Todas são opcionais; um arquivo sem views abre com uma tabela.

ChaveConteúdoNo Plainva
filtersQuais notas pertencem ao banco de dados (fontes)Lida e aplicada
propertiesUma entrada por coluna, identificada pelo id da propriedadeLida; os acréscimos do Plainva ficam no seu bloco plainva
viewsA lista de visualizaçõesLida; toda visualização precisa de um name
formulasFórmulas do Obsidian, name: expressionMantidas sem alteração, não calculadas
summariesFórmulas de resumo personalizadas do ObsidianMantidas sem alteração, não calculadas

O Plainva nunca grava outra chave de nível superior: o Obsidian se recusa a abrir um .base com uma chave que ele não conhece. Uma chave columns: de nível superior gravada por versões muito antigas do Plainva ainda é lida e movida para properties na próxima vez que o arquivo for salvo.

Propriedades (properties)

Ids de propriedade

Um id de propriedade dá nome a uma coluna. Existem três tipos:

IdSignificaExemplo
note.<key>Uma chave do frontmatter das notasnote.status
file.<field>Um dado sobre o arquivo (veja Campos de arquivo)file.mtime
formula.<name>Uma fórmula do Obsidian de formulasformula.price_per_unit

As chaves de properties, o order de uma visualização e sort[].property usam esses ids. Dentro de uma expressão de filtro e dentro de um bloco plainva, uma chave de frontmatter é escrita sem prefixo (status); uma expressão de filtro entende note.status também.

Quando uma nota escreve uma chave com maiúsculas e minúsculas diferentes da coluna (Due contra a coluna due), o Plainva ainda mostra o valor nessa coluna e grava as alterações de volta com a grafia da própria nota.

Nome de exibição

properties.<id>.displayName é o rótulo de coluna do Obsidian. O Plainva o mostra como cabeçalho da coluna e o mantém. Sem ele, uma chave de frontmatter é mostrada com a primeira letra maiúscula (apenas na tela); os campos de arquivo têm nomes próprios, por exemplo Nome, Modificado, Tamanho, Caminho, Lista de tarefas e Dia do nome do arquivo.

O bloco plainva de uma coluna

Tudo o que o Plainva acrescenta a uma coluna fica em properties.<id>.plainva. O Obsidian o ignora.

ChaveValorSignificado
inputum tipo de campo (lista abaixo)O tipo de campo da coluna
ratingMaxnúmero, de 1 a 10Quantas marcas uma avaliação tem (padrão 5)
ratingGlyphum caractereA marca que uma avaliação desenha (padrão um ponto)
optionslista de opçõesValores fixos para seleção, status e seleção múltipla
relationBasecaminho de .base relativo ao vaultO banco de dados para o qual uma relação aponta
relationLimitoneUma relação guarda exatamente um link; ausente significa sem limite
reverseOf{ base, property }Uma coluna calculada de relação reversa
rollup{ through, of, fn, where }Uma coluna calculada de agregação (veja Agregações)
previousKeyslista de até 8 nomes anterioresPermite que os comentários encontrem de novo uma coluna renomeada

Tipos de campo (input)

text, number, rating, checkbox, date, datetime, select, status, multiselect, list, tags, url, email, phone, relation.

Duas grafias mais antigas também são lidas: multi-select como multiselect e link como relation. Uma coluna sem input — ou com um valor que não está nesta lista — recebe seu tipo a partir dos valores nas notas: true/false é uma caixa de seleção, um número é um número, uma lista de [[links]] é uma relação, 2026-07-03 é uma data, um endereço da web é uma URL, e assim por diante. Uma coluna de relação reversa e uma coluna de agregação não têm input.

Opções e cores

Uma opção é { value, label, color, group }; apenas value é obrigatório. color é um dos nomes da paleta gray, teal, blue, green, amber, coral, purple, pink — um nome desconhecido volta a uma cor derivada do valor. group é usado apenas por Status: opções com o mesmo grupo formam uma etapa. Um texto simples é lido como uma opção com esse valor.

Agregações

Uma coluna de agregação calcula um valor a partir das notas para as quais uma coluna de link deste banco de dados aponta. O valor não é armazenado em nenhum arquivo.

Uma agregação à qual falta uma parte obrigatória, ou que nomeia uma função que não está nesta lista, é ignorada: a coluna fica vazia e o banco de dados continua abrindo. Uma agregação através de outra coluna calculada também fica vazia.

Campos de arquivo (file.*)

Estes valores vêm do arquivo, não do seu frontmatter. Cada linha de um banco de dados traz o seguinte:

CampoValor
file.nameA propriedade title da nota, se ela tiver uma; caso contrário, o nome do arquivo sem .md
file.pathO caminho relativo ao vault
file.mtimeÚltima modificação, em milissegundos
file.ctimeCriação, em milissegundos, quando o sistema de arquivos informa
file.sizeTamanho em bytes
file.tagsTodas as tags da nota, do frontmatter e do texto, cada uma com #; preenchido quando um filtro, um mural ou uma visualização que mostra a coluna ou ordena por ela precisa delas
file.tasksProgresso das caixas de seleção como done/total; preenchido para quadros e para uma visualização que mostra a coluna
file.dayO dia que o nome do arquivo de uma nota diária representa, segundo a pasta e o formato do vault; somente leitura, e só o campo de data de um calendário ou de uma linha do tempo pode usá-lo
file.revisionUm marcador interno de alteração; não conte com ele

file.folder funciona como fonte (veja Fontes), mas não é uma coluna. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties e file.file não são fornecidos: uma coluna com um deles fica vazia, e um filtro os lê como vazios.

Filtros

Onde ficam os filtros

O filters de nível superior contém as fontes — quais notas pertencem ao banco de dados. Cada visualização pode ter seu próprio filters com condições que restringem apenas essa visualização; o Plainva grava as condições ali. Os dois níveis valem juntos. Condições que um arquivo mantém no nível superior continuam funcionando; o próximo salvamento no Plainva as move para cada visualização.

Fontes

FonteExpressão
Pastafile.folder == "Projects/Active" — a pasta e todas as suas subpastas; "" e "/" são o vault inteiro
Tagfile.hasTag("project") — a nota traz exatamente esta tag; um # no início é ignorado

Várias fontes se combinam com and ou or como qualquer outra condição. Um banco de dados sem fontes contém todas as notas do vault. Anexos, os arquivos reservados index.md e log.md, e arquivos ou pastas cujo nome começa com um ponto nunca são linhas.

Condições

Uma condição é um texto. Os valores ficam entre aspas duplas; \" e \\ escapam uma aspa e uma barra invertida. A propriedade é escrita sem prefixo ou com note..

CondiçãoExpressão
éstatus == "Done"
não éstatus != "Done"
contémcontains(labels, "urgent") ou labels.contains("urgent")
não contém!contains(labels, "urgent") ou !labels.contains("urgent")
maior que, menor queeffort > "3", effort < "8"
no mínimo, no máximodue >= "2026-07-01", due <= "2026-07-31"
está vaziostatus == "" ou status.isEmpty()
não está vaziostatus != "" ou !status.isEmpty()
tem uma tagfile.tags.contains("#work"), negada com !
cor do cabeçalho, íconenote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Como os valores são comparados

and, or, not

Um objeto filters tem exatamente um entre and, or e not em cada nível; suas entradas são textos de condição ou outros objetos de filtro.

ChaveCorresponde quando
andtodas as entradas correspondem
orpelo menos uma entrada corresponde
notnenhuma entrada corresponde

O Plainva avalia qualquer profundidade. O painel de filtros edita um nível de grupos sob Todas ou Qualquer (Adicionar grupo); uma estrutura mais profunda aparece como Filtro complexo (não editável), permanece no arquivo e é aplicada — uma condição dentro dela que o Plainva não consegue ler é indicada abaixo dela como não aplicada. Um arquivo mais antigo com and e or lado a lado em um mesmo nível é lido como “todas as de and e uma das de or” e gravado na forma válida no próximo salvamento.

O que o Plainva não consegue ler

Apenas as formas das duas tabelas acima são compreendidas. Qualquer outra coisa — file.inFolder(…), file.hasLink(…), file.hasProperty(…), um número sem aspas (price > 2), && e || dentro de um único texto, aritmética, funções de data como now(), ou this — permanece no arquivo e é mostrada no painel de filtros como foi escrita, com a observação Não aplicada: o Plainva não consegue ler esta condição, então ela não filtra nada. A visualização então mostra mais notas do que o mesmo filtro mostra no Obsidian.

Fórmulas

O Plainva não calcula as fórmulas do Obsidian. formulas permanece no arquivo sem alteração, e uma coluna formula.<name> no order de uma visualização é mostrada sem valores. Exportar tabela → Fórmulas (.base) grava algumas agregações como fórmulas para que o Obsidian possa calculá-las (veja Bancos de Dados).

Visualizações

Chaves de toda visualização

ChaveValorNo Plainva
typetable, list, cardsO tipo de visualização; veja a tabela seguinte
nametextoObrigatório; o Plainva dá um nome a uma visualização que não tenha um quando salva
orderlista de ids de propriedadeAs colunas visíveis, nesta ordem
sortlista de { property, direction }Regras de ordenação, ASC ou DESC
filtersobjeto de filtroAs condições próprias da visualização
summariesmapa de id de propriedade → nome do resumoO rodapé de cada coluna
plainvamapaAs opções de visualização do Plainva, abaixo

Os oito tipos de visualização

O Obsidian conhece table, list e cards. Os demais tipos de visualização do Plainva são armazenados como type: table mais plainva.render, então o Obsidian os mostra como uma tabela.

Tipo de visualizaçãotype no discoplainva.render
Tabela (table)table—
Lista (list)list—
Galeria (gallery)cards—
Quadro (board)tableboard
Calendário (calendar)tablecalendar
Linha do tempo (timeline)tabletimeline
Grafo (graph)tablegraph
Mural (pinboard)tablepinboard

Quadro, Calendário, Linha do tempo, Grafo e Mural são oferecidos como Tipo de visualização apenas enquanto Permitir extensões do Plainva para arquivos .base estiver ativado. Um type que o Plainva não conhece é mostrado como uma tabela e permanece no arquivo como foi escrito até que você escolha outro Tipo de visualização.

Opções da visualização (views[i].plainva)

Dentro do bloco plainva, uma propriedade é escrita sem prefixo (status), não como note.status.

ChaveTipos de visualizaçãoValor
renderQuadro, Calendário, Linha do tempo, Grafo, MuralO tipo de visualização, veja acima
groupByQuadroA propriedade de que as colunas são feitas; sem ela, a propriedade do groupBy próprio do Obsidian na visualização
boardLaneByQuadroUma segunda propriedade para Raias por
boardWipLimitsQuadroMapa de valor da coluna → máximo de cartões (Limite de WIP), números inteiros acima de 0
boardColorModeQuadrocolumn tinge a coluna inteira; ausente = apenas o chip do cabeçalho
boardColumnOrderQuadroOrdem manual das colunas; __UNGROUPED__ é a coluna sem valor
colorByQuadro, Linha do tempoCartões e barras assumem a cor da opção desta propriedade (Cor por)
dateFieldCalendário, Linha do tempoA data de início (Campo de data, Data de início); uma propriedade de data ou file.day
endFieldCalendário, Linha do tempoA Data de término
coverImageGaleriaA propriedade que guarda a Imagem de capa
subItemsPropertyTabelaA relação com o item pai para Subitens
widthsTabelaMapa de coluna → largura em pixels
dateFormattodoslong, iso ou relative; ausente = a forma curta padrão
graphEdgesGrafoPropriedades de relação desenhadas como arestas
graphColorByGrafoUma propriedade de seleção ou status que colore os nós
graphSizeByGrafoUma propriedade numérica que define o tamanho dos nós
graphShowExternalGrafotrue mostra também destinos de links fora da visualização
graphShowIncomingGrafotrue mostra também links que chegam de outros bancos de dados
pinboardOrderMuralCaminhos dos cartões não fixados, em ordem manual
pinboardPinnedMuralCaminhos dos cartões fixados, em ordem
pinboardFilterByMuralOrigem dos marcadores: uma propriedade de seleção múltipla; ausente = tags

Opções do arquivo inteiro (só a primeira visualização)

Estas chaves pertencem ao banco de dados inteiro. O Plainva as grava apenas no bloco plainva da primeira visualização e lê o primeiro valor válido de cada uma.

ChaveValor
fileIconColorCor hexadecimal do ícone do banco de dados (Cor do ícone do banco de dados)
newItemFolderPasta onde Entrada guarda as novas entradas
newItemTemplateModelo para novas entradas
contextFiltersPropriedades que limitam um banco de dados incorporado à nota em que ele está incorporado (Esta nota)
taskListConta e lista ("<account id> <list id>") em que uma nova tarefa também é criada

Resumos

views[i].summaries associa uma coluna a um destes nomes; o rodapé o calcula sobre as linhas que a visualização mostra.

NomeNo PlainvaResultado
AverageMédiaMédia dos números
MinMínMenor número
MaxMáxMaior número
SumSomaTotal dos números
RangeAmplitudeMaior menos menor número; para datas, o intervalo em dias
MedianMedianaValor central dos números
StddevDesvio padrãoDesvio padrão de todos os números (populacional)
EarliestMais antigaData mais antiga
LatestMais recenteData mais recente
CheckedMarcadasLinhas cujo valor é true ou yes
UncheckedNão marcadasTodas as outras linhas
EmptySem valorLinhas sem valor
FilledCom valorLinhas com valor
UniqueDistintosNúmero de valores diferentes; as entradas de uma lista contam uma a uma

Os números são arredondados para duas casas decimais, e uma vírgula decimal também é lida. Uma coluna sem valor utilizável não mostra rodapé em vez de 0. Qualquer outro nome é uma fórmula personalizada do summaries de nível superior: o Plainva a mantém e mostra Personalizado: … no menu, mas não calcula nenhum valor.

Ordenação e agrupamento

Incorporar um banco de dados, e this

![[Projects.base]] em uma nota mostra o banco de dados dentro da nota, no modo de leitura e no editor. Uma parte depois de # (o nome de uma visualização, como em ![[Projects.base#Board]]) é ignorada: a incorporação mostra a visualização usada por último neste banco de dados. Um bloco de código ```base em uma nota é mostrado como código, não como um banco de dados.

this ainda não é suportado. Um filtro ou uma fórmula que usa this permanece no arquivo, mas o Plainva não o avalia. Duas coisas cobrem o caso mais comum, “mostrar as entradas que pertencem a esta nota”: contextFilters (Esta nota no painel de filtros) limita um banco de dados incorporado à nota em que ele está incorporado por meio de uma propriedade de relação, e um banco de dados incorporado que se relaciona com o banco de dados da sua nota hospedeira oferece por si só Filtrar este banco de dados pela nota atual. As duas agem apenas dentro do Plainva; o Obsidian mostra todas as linhas.

Limites

Chaves que o Plainva não conhece

O Plainva lê um .base, altera apenas o que você alterou no app e grava o arquivo inteiro de novo — como YAML com fins de linha LF e sem BOM, então comentários e o espaçamento de um arquivo escrito à mão não são mantidos. Do que ele não conhece:

Diferenças em relação ao Obsidian Bases

AssuntoObsidianPlainva
Fórmulas, resumos personalizadosCalculadosMantidos, não calculados
thisSuportadoAinda não suportado
Expressões de filtroA linguagem de expressões completaAs formas em Condições
file.folder == "X"Apenas notas diretamente em XX e todas as suas subpastas
file.hasTag("x")Também #x/childExatamente #x
file.nameO nome do arquivoA propriedade title, se a nota tiver uma
limit, groupBy da visualizaçãoAplicadoslimit mantido, não aplicado; groupBy agrupa um quadro, não uma tabela
Tipos de visualizaçãotable, list, cards e tipos de pluginsOito tipos; um desconhecido é mostrado como tabela e mantido no arquivo
![[db.base#View]]Abre essa visualizaçãoA visualização usada por último
Bloco de código ```baseUm banco de dadosUm bloco de código
Blocos plainva do PlainvaIgnoradosQuadro, calendário, linha do tempo, grafo, mural, relações, agregações, tipos de campo

Veja também