Dokumentacja baz danych (.base)

Stan na: 2026-11-03

Ta strona wymienia wszystko, co może zawierać plik .base, oraz to, co Plainva robi z każdą z jego części: każdy klucz najwyższego poziomu, każdą formę filtra, każdy typ widoku z jego opcjami, podsumowania, sortowanie, ograniczenia, los kluczy nieznanych Plainvie i miejsca, w których Plainva zachowuje się inaczej niż Bases w Obsidian. Opisuje to, co kod Plainva dziś odczytuje, oblicza i zapisuje — a nie dokumentację Obsidian.

W codziennej pracy zacznij od Bazy danych (.base). Zasady, których narzędzie musi przestrzegać, zapisując pliki vaultu bezpośrednio, oraz pełny przykład relacji znajdują się w Dokumentacji formatu plików.

W skrócie

Część plikuCo robi Plainva
filtersOdczytuje i stosuje źródła (folder, tag) oraz warunki opisane w Filtry
viewsOdczytuje wszystkie osiem typów widoków, ich kolejność, sortowanie, filtry i podsumowania
propertiesOdczytuje schemat kolumn, nazwę wyświetlaną i blok plainva Plainva
summaries (widok)Oblicza czternaście wbudowanych podsumowań
formulasZachowuje je w pliku, nie oblicza
summaries (najwyższy poziom)Zachowuje własne formuły podsumowań, nie oblicza
thisJeszcze nieobsługiwane
Inne kluczeZachowuje je w pliku (zob. Klucze nieznane Plainvie)

Klucze najwyższego poziomu

Plik .base to YAML z następującymi kluczami najwyższego poziomu. Wszystkie są opcjonalne; plik bez views otwiera się z jedną tabelą.

KluczZawartośćW Plainva
filtersKtóre notatki należą do bazy danych (źródła)Odczytywany i stosowany
propertiesJeden wpis na kolumnę, kluczem jest identyfikator właściwościOdczytywany; dodatki Plainva znajdują się w jego bloku plainva
viewsLista widokówOdczytywany; każdy widok wymaga name
formulasFormuły Obsidian, name: expressionZachowywany bez zmian, nieobliczany
summariesWłasne formuły podsumowań ObsidianZachowywany bez zmian, nieobliczany

Plainva nigdy nie zapisuje innego klucza najwyższego poziomu: Obsidian odmawia otwarcia pliku .base z nieznanym kluczem. Klucz najwyższego poziomu columns:, zapisywany przez bardzo stare wersje Plainva, jest nadal odczytywany i przy następnym zapisie pliku przenoszony do properties.

Właściwości (properties)

Identyfikatory właściwości

Identyfikator właściwości nazywa kolumnę. Istnieją trzy rodzaje:

IdentyfikatorOznaczaPrzykład
note.<key>Klucz frontmatter notateknote.status
file.<field>Informację o pliku (zob. Pola pliku)file.mtime
formula.<name>Formułę Obsidian z formulasformula.price_per_unit

Klucze properties, order widoku i sort[].property używają tych identyfikatorów. We wyrażeniu filtra i w bloku plainva klucz frontmatter zapisuje się bez przedrostka (status); wyrażenie filtra rozumie też note.status.

Gdy notatka zapisuje klucz inną wielkością liter niż kolumna (Due przy kolumnie due), Plainva nadal pokazuje wartość w tej kolumnie i zapisuje zmiany pod pisownią samej notatki.

Nazwa wyświetlana

properties.<id>.displayName to etykieta kolumny w Obsidian. Plainva pokazuje ją jako nagłówek kolumny i zachowuje. Bez niej klucz frontmatter jest pokazywany z wielką pierwszą literą (tylko na ekranie); pola pliku mają własne nazwy, na przykład Nazwa, Zmodyfikowano, Rozmiar, Ścieżka, Lista zadań i Dzień z nazwy pliku.

Blok plainva kolumny

Wszystko, co Plainva dodaje do kolumny, znajduje się pod properties.<id>.plainva. Obsidian to ignoruje.

KluczWartośćZnaczenie
inputtyp pola (lista poniżej)Typ pola kolumny
ratingMaxliczba od 1 do 10Ile znaczników ma ocena (domyślnie 5)
ratingGlyphjeden znakZnacznik rysowany przez ocenę (domyślnie kropka)
optionslista opcjiStałe wartości dla wyboru, statusu i wielokrotnego wyboru
relationBaseścieżka .base względem vaultuBaza danych, na którą wskazuje relacja
relationLimitoneRelacja zawiera dokładnie jeden link; brak oznacza brak ograniczenia
reverseOf{ base, property }Obliczana kolumna relacji odwrotnej
rollup{ through, of, fn, where }Obliczana kolumna agregacji (zob. Agregacje)
previousKeyslista do 8 dawnych nazwPozwala komentarzom odnaleźć przemianowaną kolumnę

Typy pól (input)

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

Odczytywane są także dwie starsze pisownie: multi-select jako multiselect oraz link jako relation. Kolumna bez input — lub z wartością spoza tej listy — dostaje typ na podstawie wartości w notatkach: true/false to pole wyboru, liczba to liczba, lista [[links]] to relacja, 2026-07-03 to data, adres internetowy to URL i tak dalej. Kolumna relacji odwrotnej i kolumna agregacji nie mają input.

Opcje i kolory

Opcja ma postać { value, label, color, group }; wymagane jest tylko value. color to jedna z nazw palety gray, teal, blue, green, amber, coral, purple, pink — nieznana nazwa wraca do koloru wyprowadzonego z wartości. group jest używane tylko przez Status: opcje z tą samą grupą tworzą etap. Zwykły ciąg znaków jest odczytywany jako opcja o tej wartości.

Agregacje

Kolumna agregacji oblicza wartość na podstawie notatek, na które wskazuje kolumna linków tej bazy danych. Wartość nie jest zapisywana w żadnym pliku.

Agregacja, której brakuje wymaganej części lub która wskazuje funkcję spoza tej listy, jest ignorowana: kolumna pozostaje pusta, a baza danych nadal się otwiera. Agregacja przez inną kolumnę obliczaną też pozostaje pusta.

Pola pliku (file.*)

Te wartości pochodzą z pliku, nie z jego frontmatter. Każdy wiersz bazy danych niesie następujące:

PoleWartość
file.nameWłaściwość title notatki, jeśli ją ma, w przeciwnym razie nazwa pliku bez .md
file.pathŚcieżka względem vaultu
file.mtimeCzas ostatniej modyfikacji, w milisekundach
file.ctimeCzas utworzenia, w milisekundach, o ile system plików go podaje
file.sizeRozmiar w bajtach
file.tagsWszystkie tagi notatki, z frontmatter i z tekstu, każdy z #; wypełniane, gdy potrzebuje ich filtr, tablica korkowa lub widok, który pokazuje kolumnę albo według niej sortuje
file.tasksPostęp listy zadań jako done/total; wypełniane dla tablic i dla widoku, który pokazuje kolumnę
file.dayDzień, który oznacza nazwa pliku notatki dziennej, według folderu i formatu vaultu; tylko do odczytu i tylko pole daty kalendarza lub osi czasu może go użyć
file.revisionWewnętrzny znacznik zmiany; nie polegaj na nim

file.folder działa jako źródło (zob. Źródła), ale nie jest kolumną. file.basename, file.ext, file.links, file.backlinks, file.embeds, file.properties i file.file nie są dostarczane: kolumna z jednym z nich pozostaje pusta, a filtr odczytuje je jako puste.

Filtry

Gdzie znajdują się filtry

filters najwyższego poziomu zawiera źródła — które notatki należą do bazy danych. Każdy widok może mieć własne filters z warunkami zawężającymi tylko ten widok; to tam Plainva zapisuje warunki. Oba poziomy działają łącznie. Warunki, które plik trzyma na najwyższym poziomie, nadal działają; następny zapis w Plainva przenosi je do każdego widoku.

Źródła

ŹródłoWyrażenie
Folderfile.folder == "Projects/Active" — folder i wszystkie jego podfoldery; "" i "/" to cały vault
Tagfile.hasTag("project") — notatka niesie dokładnie ten tag; początkowy # jest ignorowany

Kilka źródeł łączy się przez and lub or jak każdy inny warunek. Baza danych bez źródeł zawiera każdą notatkę vaultu. Załączniki, zarezerwowane index.md i log.md oraz pliki lub foldery, których nazwa zaczyna się od kropki, nigdy nie są wierszami.

Warunki

Warunek jest ciągiem znaków. Wartości stoją w podwójnych cudzysłowach; \" i \\ oznaczają cudzysłów i ukośnik wsteczny. Właściwość zapisuje się bez przedrostka lub z note..

WarunekWyrażenie
jeststatus == "Done"
nie jeststatus != "Done"
zawieracontains(labels, "urgent") lub labels.contains("urgent")
nie zawiera!contains(labels, "urgent") lub !labels.contains("urgent")
większe niż, mniejsze niżeffort > "3", effort < "8"
co najmniej, co najwyżejdue >= "2026-07-01", due <= "2026-07-31"
jest pustestatus == "" lub status.isEmpty()
nie jest pustestatus != "" lub !status.isEmpty()
ma tagfile.tags.contains("#work"), zaprzeczane przez !
kolor nagłówka, ikonanote.plainva.header_color == "#2a7f7b", note.plainva.icon == "lucide:pin"

Jak porównywane są wartości

and, or, not

Obiekt filters ma na każdym poziomie dokładnie jedno z and, or i not; jego wpisy to ciągi warunków lub dalsze obiekty filtrów.

KluczPasuje, gdy
andpasuje każdy wpis
orpasuje co najmniej jeden wpis
notnie pasuje żaden wpis

Plainva oblicza dowolną głębokość. Panel filtrów edytuje jeden poziom grup pod Wszystkie lub Dowolny (Dodaj grupę); głębsza struktura pojawia się jako Filtr złożony (bez możliwości edycji), pozostaje w pliku i jest stosowana — warunek w niej, którego Plainva nie potrafi odczytać, jest wymieniony pod nią jako niezastosowany. Starszy plik z and i or obok siebie na jednym poziomie jest odczytywany jako „wszystkie z and i jedno z or” i przy następnym zapisie zapisywany w prawidłowej formie.

Czego Plainva nie potrafi odczytać

Rozumiane są tylko formy z dwóch powyższych tabel. Wszystko inne — file.inFolder(…), file.hasLink(…), file.hasProperty(…), liczba bez cudzysłowów (price > 2), && i || w jednym ciągu, arytmetyka, funkcje dat takie jak now() czy this — pozostaje w pliku i jest pokazywane w panelu filtrów tak, jak zapisano, z uwagą Nie zastosowano: Plainva nie potrafi odczytać tego warunku, więc niczego nie filtruje. Widok pokazuje wtedy więcej notatek niż ten sam filtr w Obsidian.

Formuły

Plainva nie oblicza formuł Obsidian. formulas pozostaje w pliku bez zmian, a kolumna formula.<name> w order widoku jest pokazywana bez wartości. Eksportuj tabelę → Formuły (.base) zapisuje niektóre agregacje jako formuły, aby Obsidian mógł je obliczyć (zob. Bazy danych).

Widoki

Klucze każdego widoku

KluczWartośćW Plainva
typetable, list, cardsTyp widoku; zob. następna tabela
nametekstWymagany; Plainva nadaje nazwę widokowi bez niej przy zapisie
orderlista identyfikatorów właściwościWidoczne kolumny, w tej kolejności
sortlista { property, direction }Reguły sortowania, ASC lub DESC
filtersobiekt filtraWłasne warunki widoku
summariesmapa identyfikator właściwości → nazwa podsumowaniaStopka każdej kolumny
plainvamapaOpcje widoku Plainva, poniżej

Osiem typów widoków

Obsidian zna table, list i cards. Pozostałe typy widoków Plainva są zapisywane jako type: table plus plainva.render, więc Obsidian pokazuje je jako tabelę.

Typ widokutype na dyskuplainva.render
Tabela (table)table—
Lista (list)list—
Galeria (gallery)cards—
Tablica (board)tableboard
Kalendarz (calendar)tablecalendar
Oś czasu (timeline)tabletimeline
Graf (graph)tablegraph
Tablica korkowa (pinboard)tablepinboard

Tablica, Kalendarz, Oś czasu, Graf i Tablica korkowa są oferowane jako Typ widoku tylko wtedy, gdy włączone jest Zezwól na rozszerzenia Plainva dla plików .base. type, którego Plainva nie zna, jest pokazywany jako tabela i pozostaje w pliku tak, jak zapisano, dopóki nie wybierzesz innej wartości w polu Typ widoku.

Opcje widoku (views[i].plainva)

Wewnątrz bloku plainva właściwość zapisuje się bez przedrostka (status), a nie jako note.status.

KluczTypy widokówWartość
renderTablica, Kalendarz, Oś czasu, Graf, Tablica korkowaTyp widoku, zob. wyżej
groupByTablicaWłaściwość, z której powstają kolumny; bez niego właściwość własnego groupBy widoku z Obsidian
boardLaneByTablicaDruga właściwość dla Tory według
boardWipLimitsTablicaMapa wartość kolumny → najwięcej kart (Limit WIP), liczby całkowite większe od 0
boardColorModeTablicacolumn zabarwia całą kolumnę; brak = tylko chip w nagłówku
boardColumnOrderTablicaRęczna kolejność kolumn; __UNGROUPED__ to kolumna bez wartości
colorByTablica, Oś czasuKarty i paski przyjmują kolor opcji tej właściwości (Kolor według)
dateFieldKalendarz, Oś czasuData początkowa (Pole daty, Data początkowa); właściwość daty lub file.day
endFieldKalendarz, Oś czasuData końcowa
coverImageGaleriaWłaściwość zawierająca Okładka
subItemsPropertyTabelaRelacja nadrzędna dla Elementy podrzędne
widthsTabelaMapa kolumna → szerokość w pikselach
dateFormatwszystkielong, iso lub relative; brak = domyślna krótka forma
graphEdgesGrafWłaściwości relacji rysowane jako krawędzie
graphColorByGrafWłaściwość wyboru lub statusu, która barwi węzły
graphSizeByGrafWłaściwość liczbowa, która określa rozmiar węzłów
graphShowExternalGraftrue pokazuje także cele linków spoza widoku
graphShowIncomingGraftrue pokazuje także linki przychodzące z innych baz danych
pinboardOrderTablica korkowaŚcieżki nieprzypiętych kart w ręcznej kolejności
pinboardPinnedTablica korkowaŚcieżki przypiętych kart w kolejności
pinboardFilterByTablica korkowaŹródło etykiet: właściwość wielokrotnego wyboru; brak = tagi

Opcje dotyczące całego pliku (tylko pierwszy widok)

Te klucze należą do całej bazy danych. Plainva zapisuje je tylko w bloku plainva pierwszego widoku i odczytuje pierwszą prawidłową wartość każdego z nich.

KluczWartość
fileIconColorKolor szesnastkowy ikony bazy danych (Kolor ikony bazy danych)
newItemFolderFolder, w którym Wpis zapisuje nowe wpisy
newItemTemplateSzablon nowych wpisów
contextFiltersWłaściwości, które ograniczają osadzoną bazę danych do notatki, w której jest osadzona (Ta notatka)
taskListKonto i lista ("<account id> <list id>"), na której tworzone jest także nowe zadanie

Podsumowania

views[i].summaries przypisuje kolumnie jedną z tych nazw; stopka oblicza ją na podstawie wierszy, które pokazuje widok.

NazwaW PlainvaWynik
AverageŚredniaŚrednia z liczb
MinMinNajmniejsza liczba
MaxMaksNajwiększa liczba
SumSumaSuma liczb
RangeRozstępNajwiększa minus najmniejsza liczba; dla dat rozpiętość w dniach
MedianMedianaWartość środkowa liczb
StddevOdch. std.Odchylenie standardowe wszystkich liczb (populacji)
EarliestNajwcześniejszaNajwcześniejsza data
LatestNajpóźniejszaNajpóźniejsza data
CheckedZaznaczoneWiersze, których wartość to true lub yes
UncheckedNiezaznaczoneWszystkie pozostałe wiersze
EmptyBez wartościWiersze bez wartości
FilledZ wartościąWiersze z wartością
UniqueRóżneLiczba różnych wartości; wpisy listy liczą się pojedynczo

Liczby są zaokrąglane do dwóch miejsc po przecinku, odczytywany jest też przecinek dziesiętny. Kolumna bez użytecznej wartości nie pokazuje stopki zamiast 0. Każda inna nazwa to własna formuła z summaries najwyższego poziomu: Plainva ją zachowuje i pokazuje Własne: … w menu, ale nie oblicza żadnej wartości.

Sortowanie i grupowanie

Osadzanie bazy danych i this

![[Projects.base]] w notatce pokazuje bazę danych wewnątrz notatki, w widoku czytania i w edytorze. Część po # (nazwa widoku, jak w ![[Projects.base#Board]]) jest ignorowana: osadzenie pokazuje widok ostatnio używany dla tej bazy danych. Blok kodu ```base w notatce jest pokazywany jako kod, a nie jako baza danych.

this jest jeszcze nieobsługiwane. Filtr lub formuła używające this pozostają w pliku, ale Plainva ich nie oblicza. Najczęstszy przypadek, „pokaż wpisy należące do tej notatki”, pokrywają dwie rzeczy: contextFilters (Ta notatka w panelu filtrów) ogranicza osadzoną bazę danych do notatki, w której jest osadzona, przez właściwość relacji, a osadzona baza danych powiązana z bazą danych notatki-gospodarza sama oferuje Filtruj tę bazę do bieżącej notatki. Obie działają tylko wewnątrz Plainva; Obsidian pokazuje wszystkie wiersze.

Ograniczenia

Klucze nieznane Plainvie

Plainva odczytuje .base, zmienia tylko to, co zostało zmienione w aplikacji, i zapisuje cały plik od nowa — jako YAML z końcami wierszy LF i bez BOM, więc komentarze i odstępy pliku pisanego ręcznie nie są zachowywane. Z tego, czego nie zna:

Różnice względem Bases w Obsidian

TematObsidianPlainva
Formuły, własne podsumowaniaObliczaneZachowywane, nieobliczane
thisObsługiwaneJeszcze nieobsługiwane
Wyrażenia filtrówPełny język wyrażeńFormy z Warunki
file.folder == "X"Tylko notatki bezpośrednio w XX i wszystkie jego podfoldery
file.hasTag("x")Także #x/childDokładnie #x
file.nameNazwa plikuWłaściwość title, jeśli notatka ją ma
limit, groupBy widokuStosowanelimit zachowywane, niestosowane; groupBy grupuje tablicę, nie tabelę
Typy widokówtable, list, cards i typy wtyczekOsiem typów; nieznany jest pokazywany jako tabela i zachowywany w pliku
![[db.base#View]]Otwiera ten widokOstatnio używany widok
Blok kodu ```baseBaza danychBlok kodu
Bloki plainva PlainvaIgnorowaneTablica, kalendarz, oś czasu, graf, tablica korkowa, relacje, agregacje, typy pól

Zobacz też