データベースリファレンス (.base)

最終更新: 2026-11-03

このページでは、.baseファイルに含められるすべての内容と、Plainvaがそれぞれの部分をどう扱うかを一覧にしています。すべてのトップレベルキー、すべてのフィルター形式、オプション付きのすべてのビューの種類、集計、並べ替え、制限、Plainvaが知らないキーがどうなるか、そしてPlainvaがObsidian Basesと異なる動作をする点です。Obsidianのドキュメントではなく、Plainvaのコードが現在読み取り、評価し、書き込む内容を説明しています。

日常的な使い方は、まずデータベース (.base)をお読みください。ツールが保管庫のファイルを直接書き込むときに守るべきルールと、リレーションの完全な例は、ファイル形式リファレンスにあります。

概要

ファイルの部分Plainvaの動作
filtersフィルターに挙げたソース(フォルダー、タグ)と条件を読み取って適用します
views8種類すべてのビュー、その順序、並べ替え、フィルター、集計を読み取ります
properties列のスキーマ、表示名、Plainvaのplainvaブロックを読み取ります
summaries(ビュー)14個の組み込み集計を計算します
formulasファイルに保持しますが、計算しません
summaries(トップレベル)カスタム集計式を保持しますが、計算しません
thisまだ対応していません
その他のキーファイルに保持します(Plainvaが知らないキーを参照)

トップレベルのキー

.baseファイルは、次のトップレベルキーを持つYAMLです。いずれも省略可能で、viewsのないファイルは1つのテーブルとして開きます。

キー内容Plainvaでの扱い
filtersどのノートがデータベースに属するか(ソース)読み取って適用します
properties列ごとに1エントリー、キーはプロパティID読み取ります。Plainvaの追加分はplainvaブロックにあります
viewsビューのリスト読み取ります。すべてのビューにnameが必要です
formulasObsidianの数式、name: expressionそのまま保持し、計算しません
summariesObsidianのカスタム集計式そのまま保持し、計算しません

Plainvaは他のトップレベルキーを書き込みません。Obsidianは知らないキーのある.baseを開くことを拒否するためです。ごく古いPlainvaが書き込んだトップレベルのcolumns:キーは今でも読み取られ、ファイルを次に保存するときにpropertiesへ移されます。

プロパティ (properties)

プロパティID

プロパティIDは列に名前を付けます。3種類あります。

ID意味例
note.<key>ノートのFrontmatterのキーnote.status
file.<field>ファイルに関する事実(ファイルフィールドを参照)file.mtime
formula.<name>formulasにあるObsidianの数式formula.price_per_unit

propertiesのキー、ビューのorder、sort[].propertyはこれらのIDを使います。フィルター式の中とplainvaブロックの中では、Frontmatterのキーは接頭辞なし(status)で書きます。フィルター式はnote.statusも理解します。

ノートがキーを列と異なる大文字小文字で書いている場合(列dueに対してDue)でも、Plainvaはその列に値を表示し、変更はノート自身の綴りで書き戻します。

表示名

properties.<id>.displayNameはObsidianの列ラベルです。Plainvaはこれを列見出しとして表示し、保持します。これがない場合、Frontmatterのキーは先頭を大文字にして表示されます(画面上のみ)。ファイルフィールドには独自の名前があり、たとえば名前、更新日時、サイズ、パス、To-doリスト、ファイル名からの日付です。

列のplainvaブロック

列に対するPlainvaの追加分は、すべてproperties.<id>.plainvaの下にあります。Obsidianはこれを無視します。

キー値意味
inputフィールドタイプ(下記のリスト)列のフィールドタイプ
ratingMax数値、1〜10評価のマークの数(既定は5)
ratingGlyph1文字評価が描くマーク(既定は点)
options選択肢のリスト選択、ステータス、複数選択の固定値
relationBase保管庫相対の.baseパスリレーションが指すデータベース
relationLimitoneリレーションはちょうど1件のリンクを持ちます。なければ上限なしです
reverseOf{ base, property }計算される逆リレーション列
rollup{ through, of, fn, where }計算されるロールアップ列(ロールアップを参照)
previousKeys最大8個の以前の名前のリスト名前を変更した列をコメントが再び見つけられるようにします

フィールドタイプ (input)

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

古い綴り2つも読み取られます。multi-selectはmultiselectとして、linkはrelationとして扱われます。inputのない列、またはこのリストにない値を持つ列は、ノートの値からタイプが決まります。true/falseはチェックボックス、数値は数値、[[links]]のリストはリレーション、2026-07-03は日付、Webアドレスは URL、などです。逆リレーション列とロールアップ列にはinputがありません。

選択肢と色

選択肢は{ value, label, color, group }で、必須なのはvalueだけです。colorはパレット名gray、teal、blue、green、amber、coral、purple、pinkのいずれかで、未知の名前は値から導かれる色にフォールバックします。groupはステータスでのみ使われ、同じグループの選択肢が1つの段階を成します。単なる文字列は、その値を持つ選択肢として読み取られます。

ロールアップ

ロールアップ列は、このデータベースのリンク列が指すノートから値を計算します。値はどのファイルにも保存されません。

必要な部分が欠けているロールアップ、またはこのリストにない関数を指定したロールアップは無視されます。列は空のままで、データベースは開きます。別の計算列を経由するロールアップも空のままです。

ファイルフィールド (file.*)

これらの値はFrontmatterではなく、ファイルから得られます。データベースの各行は次を持ちます。

フィールド値
file.nameノートのtitleプロパティがあればそれ、なければ.mdを除いたファイル名
file.path保管庫相対のパス
file.mtime最終更新、ミリ秒
file.ctime作成、ミリ秒(ファイルシステムが報告する場合)
file.sizeバイト単位のサイズ
file.tagsノートのすべてのタグ(Frontmatterと本文)、それぞれ#付き。フィルター、ピンボード、またはその列を表示するか並べ替えに使うビューが必要とするときに入力されます
file.tasksチェックボックスの進捗をdone/totalで表したもの。ボードと、その列を表示するビューで入力されます
file.dayデイリーノートのファイル名が表す日。保管庫のフォルダーと形式に従います。読み取り専用で、カレンダーまたはタイムラインの日付フィールドだけが使えます
file.revision内部の変更マーカー。当てにしないでください

file.folderはソースとして機能します(ソースを参照)が、列ではありません。file.basename、file.ext、file.links、file.backlinks、file.embeds、file.properties、file.fileは提供されません。これらのいずれかを使う列は空のままで、フィルターはそれらを空として読み取ります。

フィルター

フィルターの置き場所

トップレベルのfiltersはソース——どのノートがデータベースに属するか——を保持します。各ビューは、そのビューだけを絞り込む条件を持つ独自のfiltersを持てます。Plainvaは条件をそこに書き込みます。両方のレベルが一緒に適用されます。ファイルがトップレベルに残した条件も引き続き機能し、Plainvaでの次の保存でそれらは各ビューに移されます。

ソース

ソース式
フォルダーfile.folder == "Projects/Active" — そのフォルダーとすべてのサブフォルダー。""と"/"は保管庫全体です
タグfile.hasTag("project") — ノートがまさにこのタグを持ちます。先頭の#は無視されます

複数のソースは、他の条件と同様にandまたはorで組み合わせます。ソースのないデータベースは保管庫のすべてのノートを含みます。添付ファイル、予約されたindex.mdとlog.md、名前がドットで始まるファイルやフォルダーは、決して行になりません。

条件

条件は文字列です。値は二重引用符で囲み、\"と\\がそれぞれ引用符とバックスラッシュをエスケープします。プロパティはそのまま、またはnote.を付けて書きます。

条件式
が次と一致するstatus == "Done"
が次と一致しないstatus != "Done"
に次を含むcontains(labels, "urgent") または labels.contains("urgent")
に次を含まない!contains(labels, "urgent") または !labels.contains("urgent")
より大きい、より小さいeffort > "3"、effort < "8"
以上、以下due >= "2026-07-01"、due <= "2026-07-31"
が空であるstatus == "" または status.isEmpty()
が空でないstatus != "" または !status.isEmpty()
タグを持つfile.tags.contains("#work")、!で否定します
ヘッダーの色、アイコンnote.plainva.header_color == "#2a7f7b"、note.plainva.icon == "lucide:pin"

値の比較方法

and、or、not

filtersオブジェクトは、各レベルでand、or、notのうちちょうど1つを持ちます。そのエントリーは条件の文字列、またはさらなるフィルターオブジェクトです。

キー一致する条件
andすべてのエントリーが一致するとき
or少なくとも1つのエントリーが一致するとき
notどのエントリーも一致しないとき

Plainvaは任意の深さを評価します。フィルターパネルは、すべてまたはいずれかの下にあるグループを1レベル編集できます(グループを追加)。それより深い構造は 複雑なフィルター(編集不可) と表示され、ファイルに残り、適用されます。その中にPlainvaが読み取れない条件があれば、その下に適用されていないことが示されます。1つのレベルにandとorが並んでいる古いファイルは「andのすべてとorの1つ」として読み取られ、次の保存で有効な形式で書き込まれます。

Plainvaが読み取れないもの

上の2つの表にある形式だけが理解されます。それ以外——file.inFolder(…)、file.hasLink(…)、file.hasProperty(…)、引用符のない数値(price > 2)、1つの文字列内の&&と||、算術、now()のような日付関数、this——はファイルに残り、フィルターパネルには書かれたとおりに表示され、 適用されていません:Plainvaはこの条件を読み取れないため、何も絞り込みません。 という注記が付きます。そのためビューには、Obsidianで同じフィルターが表示するより多くのノートが表示されます。

数式

PlainvaはObsidianの数式を計算しません。formulasはファイルにそのまま残り、ビューのorderにあるformula.<name>列は値なしで表示されます。テーブルをエクスポート → 数式 (.base) は、Obsidianが計算できるように一部のロールアップを数式として書き込みます(データベース (.base)を参照)。

ビュー

すべてのビューのキー

キー値Plainvaでの扱い
typetable、list、cardsビューの種類。次の表を参照
nameテキスト必須。名前のないビューには、Plainvaが保存時に名前を付けます
orderプロパティIDのリスト表示する列、この順序で
sort{ property, direction }のリスト並べ替えルール、ASCまたはDESC
filtersフィルターオブジェクトビュー独自の条件
summariesプロパティID → 集計名のマップ各列のフッター
plainvaマップPlainvaのビューオプション(下記)

8種類のビュー

Obsidianが知っているのはtable、list、cardsです。Plainvaのその他のビューの種類はtype: tableとplainva.renderとして保存されるため、Obsidianではテーブルとして表示されます。

ビューの種類ディスク上のtypeplainva.render
テーブル (table)table—
リスト (list)list—
ギャラリー (gallery)cards—
ボード (board)tableboard
カレンダー (calendar)tablecalendar
タイムライン (timeline)tabletimeline
グラフ (graph)tablegraph
ピンボード (pinboard)tablepinboard

ボード、カレンダー、タイムライン、グラフ、ピンボードは、 .baseファイルへのPlainva拡張機能を許可 がオンの間だけビューの種類として提示されます。Plainvaが知らないtypeはテーブルとして表示され、別のビューの種類を選ぶまで書かれたとおりにファイルに残ります。

ビューのオプション (views[i].plainva)

plainvaブロックの中では、プロパティはnote.statusではなく接頭辞なし(status)で書きます。

キービューの種類値
renderボード、カレンダー、タイムライン、グラフ、ピンボードビューの種類。上記を参照
groupByボード列の元になるプロパティ。ない場合は、ビューのObsidian独自のgroupByのプロパティ
boardLaneByボードスイムレーンの基準用の2つ目のプロパティ
boardWipLimitsボード列の値→最大カード数(WIP上限)のマップ。0より大きい整数
boardColorModeボードcolumnは列全体を着色します。なし = 見出しのチップのみ
boardColumnOrderボード列の手動順序。__UNGROUPED__は値のない列です
colorByボード、タイムラインカードとバーがこのプロパティの選択肢の色を取ります(色の基準)
dateFieldカレンダー、タイムライン開始日(日付フィールド、開始日)。日付プロパティまたはfile.day
endFieldカレンダー、タイムライン終了日
coverImageギャラリーカバー画像を保持するプロパティ
subItemsPropertyテーブルサブアイテムの親リレーション
widthsテーブル列→幅(ピクセル)のマップ
dateFormatすべてlong、iso、relative。なし = 既定の短い形式
graphEdgesグラフエッジとして描かれるリレーションプロパティ
graphColorByグラフノードを着色する選択またはステータスのプロパティ
graphSizeByグラフノードの大きさを決める数値プロパティ
graphShowExternalグラフtrueはビューの外にあるリンク先も表示します
graphShowIncomingグラフtrueは他のデータベースから来るリンクも表示します
pinboardOrderピンボード固定されていないカードのパス、手動順序
pinboardPinnedピンボード固定されたカードのパス、順序どおり
pinboardFilterByピンボードラベルのソース: 複数選択プロパティ。なし = タグ

ファイル全体のオプション (最初のビューのみ)

これらのキーはデータベース全体に属します。Plainvaは最初のビューのplainvaブロックにのみ書き込み、それぞれの最初の有効な値を読み取ります。

キー値
fileIconColorデータベースアイコンの16進カラー(データベースアイコンの色)
newItemFolderエントリーが新しいエントリーを保存するフォルダー
newItemTemplate新しいエントリー用のテンプレート
contextFilters埋め込まれたデータベースを、それが埋め込まれたノートに限定するプロパティ(このノート)
taskList新しいタスクも作成されるアカウントとリスト("<account id> <list id>")

集計

views[i].summariesは列を次の名前のいずれかに対応づけます。フッターは、ビューが表示する行に対してそれを計算します。

名前Plainvaでの表示結果
Average平均数値の平均
Min最小最小の数値
Max最大最大の数値
Sum合計数値の合計
Range範囲最大の数値から最小の数値を引いた値。日付では日数の差
Median中央値数値の中央の値
Stddev標準偏差すべての数値の標準偏差(母集団)
Earliest最も早い最も早い日付
Latest最も遅い最も遅い日付
Checkedチェック済み値がtrueまたはyesの行
Unchecked未チェックその他すべての行
Empty値なし値のない行
Filled値あり値のある行
Unique異なる値異なる値の数。リストのエントリーは1つずつ数えます

数値は小数点以下2桁に丸められ、小数点のカンマも読み取られます。使える値のない列は、0ではなくフッターなしで表示されます。それ以外の名前は、トップレベルのsummariesにあるカスタム式です。Plainvaはそれを保持し、メニューに カスタム: … と表示しますが、値は計算しません。

並べ替えとグループ化

データベースの埋め込みとthis

ノート内の![[Projects.base]]は、閲覧ビューでもエディターでも、データベースをノートの中に表示します。#の後の部分(![[Projects.base#Board]]のようなビュー名)は無視され、埋め込みはそのデータベースで最後に使ったビューを表示します。ノート内の ```base コードブロックは、データベースではなくコードとして表示されます。

thisはまだ対応していません。 thisを使うフィルターや数式はファイルに残りますが、Plainvaは評価しません。最もよくあるケース「このノートに属するエントリーを表示する」は、2つの仕組みでカバーされます。contextFilters(フィルターパネルのこのノート)は、リレーションプロパティを通じて、埋め込まれたデータベースをそれが埋め込まれたノートに限定します。また、ホストノートのデータベースとリレーションを持つ埋め込みデータベースは、このデータベースを現在のノートで絞り込むを自動的に提供します。どちらもPlainvaの中でのみ働き、Obsidianはすべての行を表示します。

制限

Plainvaが知らないキー

Plainvaは.baseを読み、アプリで変更した部分だけを変え、ファイル全体を新しく書き込みます——LF改行でBOMなしのYAMLとして。そのため、手書きファイルのコメントや間隔は保持されません。知らないものについては次のとおりです。

Obsidian Basesとの違い

項目ObsidianPlainva
数式、カスタム集計計算される保持するが計算しない
this対応まだ対応していません
フィルター式完全な式言語条件の形式
file.folder == "X"Xの直下のノートのみXとそのすべてのサブフォルダー
file.hasTag("x")#x/childも含むちょうど#x
file.nameファイル名ノートにtitleプロパティがあればそれ
ビューのlimit、groupBy適用されるlimitは保持するが適用しない。groupByはボードをグループ化するが、テーブルはグループ化しない
ビューの種類table、list、cardsとプラグインの種類8種類。未知のものはテーブルとして表示され、ファイルに保持される
![[db.base#View]]そのビューを開く最後に使ったビュー
```base コードブロックデータベースコードブロック
Plainvaのplainvaブロック無視されるボード、カレンダー、タイムライン、グラフ、ピンボード、リレーション、ロールアップ、フィールドタイプ

関連ページ