Skip to content

Marten

Main Navigation

v7.x

Intro Document DB Event Store Tutorials Migration Support Plans Join Chat LLM Friendly Docs

Appearance

Sidebar Navigation

Introduction

What is Marten?

Getting Started

Support Policy

Configuration

Bootstrapping Marten

Configuring Document Storage

Json Serialization

Resiliency Policies

Pre-Building Generated Types

Command Line Tooling

Optimized Development Workflow

Multi-Tenancy with Database per Tenant

Environment Checks

Custom IoC Integration

Document Database

Marten as Document DB

Document Identity

Database Storage

Marten Metadata

Opening Sessions

Storing Documents

Deleting Documents

Querying Documents

Loading Documents by Id

Checking Document Existence

Querying Documents with Linq

Supported Linq Operators

Querying within Child Collections

Querying including Related Documents

Joining Documents with GroupJoin

Querying to IAsyncEnumerable

Extending Marten's Linq Support

Searching on String Fields

Projection Operators

Paging

Mixing Raw SQL with Linq

Searching with Boolean Flags

Searching for NULL Values

Querying with Postgres SQL

Advanced Querying with Postgres SQL

Querying for Raw JSON

Compiled Queries and Reusable Query Plans

Batched Queries

Indexing Documents

Calculated Indexes

Duplicated Fields

Unique Indexes

Foreign Keys

GIN or GiST Indexes

Metadata Indexes

Ignore Indexes

Execute custom SQL in session

Document Type Hierarchies

Multi-Tenanted Documents

Initial Baseline Data

Optimistic Concurrency

Full Text Searching

Noda Time Support

Partial updates/patching

AspNetCore Support

Event Store

Understanding Event Sourcing

Marten as Event Store

Quick Start

Storage

Appending Events

Bulk Appending Events

Querying Events

Metadata

Archiving Streams

Natural Keys

Dynamic Consistency Boundary

Optimizing Performance

Projections Overview

Aggregate Projections

Using Conventional Methods

Using Explicit Code

Live Aggregations

Single Stream Projections and Snapshots

Multi Stream Projections

Reading Aggregates

Using Event Metadata

Side Effects

Enriching Events

Event Projections

Custom Projections

Inline Projections

Flat Table Projections

Composite or Chained Projections

Asynchronous Projections

Testing Projections

Rebuilding Projections

EF Core Projections

Projections and IoC Services

Async Daemon HealthChecks

Event Subscriptions

Event Versioning

Multi-Tenancy

Stream Compacting

Removing Protected Information

Marking Events as Skipped

Aggregates, events and repositories

Tutorials

Building a Freight & Delivery System

Getting Started

Modeling documents

Evolve to event sourcing

Event-Sourced Aggregate

Read model projections

Cross-Aggregate Views

Distributed systems with Wolverine

Advanced Considerations

Conclusion

Testing

Integration Testing

DevOps

Diagnostics

Diagnostics and Instrumentation

Open Telemetry and Metrics

Schema

Database Management

How Documents are Stored

Schema Migrations

Exporting Schema Definition

Schema Feature Extensions

Tearing Down Document Storage

Troubleshoot

FAQ & Troubleshooting

Scenarios

Aggregates, events and repositories

Copy and transform stream

Dynamic data

Using sequences for unique identifiers

Command Handler Workflow for Capturing Events

Postgres for SQL Server users

Naming conventions

Escaping

Types

Casting

Casing

Unique values

Case insensitive data

Queries

Using duplicate fields

Slow queries

Indexing

Indexing JSONB

If statements

Working with dates

Read Replicas

Community

Tools and Libraries

On this page

Use this LLM Friendly Docs as an MCP server for Marten.

The search box in the website knows all the secrets—try it!

For any queries, join our Discord Channel to reach us faster.

JasperFx provides formal support for Marten and other JasperFx libraries. Please check our Support Plans for more details.

Scenarios

This page documents various use cases with a sample implementation using Marten.

Suggest changes to this page

Last updated:

Pager

Next pageWhat is Marten?

Released under the MIT License.

Aggregate Projections

Scenarios ​

Scenarios