TerminusDB 11.1.2: Merge Inserts with merge_repeats

TerminusDB 11.1.2 adds merge_repeats, an insert flag that merges repeated inserts for the same @id into one document instead of failing. It was released on 20 September 2023 and also speeds up path traversal.

• merge_repeats on insert — upsert-style merges for repeated @ids in one import.
• Faster queries — better WOQL execution order and faster path traversal.
• Schema migrations — classes can now migrate to abstract or unfoldable.

merge_repeats on insert

What it does

Pass merge_repeats=true on document insert and repeated inserts for the same @id merge into a single document instead of erroring. Later inserts of the same ID contribute their properties to the already-stored document — practical when a bulk import contains overlapping or repeated records for the same entity.

curl -u admin:root -X POST \
  "http://localhost:6363/api/document/admin/db?merge_repeats=true" \
  -H "Content-Type: application/json" \
  -d '[{ "@type": "Person", "@id": "Person/1", "name": "Ada" },
       { "@type": "Person", "@id": "Person/1", "city": "London" }]'

The flag was restated in the 11.1.3 notes and extended to document update in 12.0.5.

Why it matters

JSON and JSON-LD documents often have repeated inserts for the same @id during bulk imports. This can either be a mistake or genuinely the same document that should be referred from multiple places. TerminusDB is designed with fault intolerance in mind, and makes the merging behaviour opt-in instead of the default.

Read more: Document insertion · The document model

Faster queries

• WOQL query order of execution is improved
• Path traversal is sped up

Schema migrations

Migrations now support making classes abstract and/or unfoldable — those class-level changes propagate to existing data like other inferred migrations.

Fixes

• GraphQL enum names map to their proper IRI format
• The container dashboard's server URI is no longer hardcoded

Upgrade

docker pull terminusdb/terminusdb-server:v11.1.2

No data migration is needed. Docker install guide · Full changelog on GitHub

Previous: TerminusDB 11.1.1: Multiple Inheritance for Properties · Next: TerminusDB 11.1.10: Delete All Documents of a Type · TerminusDB 11.1 changelog · Release index