В какой момент виртуальные таблицы наполняются

Наполнение виртуальных таблиц в SQLite (Room)

При работе с SQLite в Android (в частности, с библиотекой Room Persistence Library), важно понимать, что виртуальные таблицы (Virtual Tables) — это особый механизм, позволяющий создавать таблицы, которые не хранят данные напрямую, а предоставляют интерфейс для доступа к внешним данным или специализированным индексам (например, FTS — Full-Text Search).

Ключевой момент: виртуальные таблицы не "наполняются" в традиционном смысле, как обычные таблицы (через INSERT), а либо создаются и заполняются одновременно при их определении, либо заполняются при первом запросе данных, в зависимости от типа виртуальной таблицы.

Основные типы виртуальных таблиц и моменты их наполнения

1. FTS-таблицы (Full-Text Search)

Наиболее распространённый тип виртуальных таблиц в Android. Они используются для быстрого полнотекстового поиска. Например, в Room можно использовать @Fts4 или @Fts5 аннотации.

@Fts4(contentEntity = Note::class)
@Entity(tableName = "notes_fts")
data class NoteFts(
    @PrimaryKey
    @ColumnInfo(name = "rowid")
    val rowId: Int,
    @ColumnInfo(name = "title")
    val title: String,
    @ColumnInfo(name = "content")
    val content: String
)

Когда наполняются?

• При вставке данных в связанную таблицу: если используется опция contentEntity (как в примере выше), FTS-таблица автоматически синхронизируется с основной таблицей (Note). Данные вставляются в FTS-таблицу одновременно с вставкой в основную таблицу через механизм триггеров SQLite.
• При явном заполнении: если contentEntity не указан, необходимо вручную заполнить FTS-таблицу данными. Обычно это делается после создания таблицы:

INSERT INTO notes_fts(rowid, title, content) SELECT id, title, content FROM notes;

2. Виртуальные таблицы с модулями (например, FTS5, R-Tree)

Эти таблицы создаются с указанием модуля, который определяет их поведение. На