Adds documentation for the new Azure Cosmos DB trigger execution feature introduced in EF Core 10.0, following the implementation in dotnet/efcore#36505.

Changes

Documentation (entity-framework/core/providers/cosmos/modeling.md)

• Added new "Database triggers" section explaining pre- and post-trigger support
• Documented the HasTrigger method with parameters and usage examples
• Included important security warning about server-side execution but lack of enforcement
• Added version note indicating the feature requires EF Core 10.0+
• Updated ms.date to reflect current documentation date
• Positioned section at the bottom of the page for appropriate emphasis

Sample Code (samples/core/Cosmos/ModelBuilding/TriggerSample.cs)

• Created comprehensive sample demonstrating trigger configuration
• Shows configuration for different trigger types (Pre/Post) and operations (Create/Replace/Delete)
• Includes complete database operations (Add, Update, Delete, SaveChanges) that trigger execution
• Updated to use EF Core 10.0.0-rc.1.25451.107 with uncommented, compilable trigger methods

Project Configuration

• Added samples/global.json specifying .NET 10 SDK version 10.0.100-rc.1.25451.107
• Updated Cosmos sample project to target net10.0 framework
• Updated NuGet package reference to EF Core 10.0.0-rc.1.25451.107

Key Points Documented

The documentation emphasizes that:

• Triggers are executed server-side by Azure Cosmos DB when EF Core performs operations, but are not enforced - operations can be performed without running triggers if accessing the database directly
• Triggers should not be used for security-related functionality like authentication or auditing
• Triggers must be pre-created in Azure Cosmos DB before EF Core can execute them
• The trigger name in EF Core configuration must match the trigger name in Azure Cosmos DB

Example Usage

modelBuilder.Entity<Product>(entity =>
{
 entity.HasPartitionKey(p => p.Category);
 
 // Configure pre-trigger for create operations
 entity.HasTrigger("PreInsertTrigger", TriggerType.Pre, TriggerOperation.Create);
 
 // Configure post-trigger for delete operations
 entity.HasTrigger("PostDeleteTrigger", TriggerType.Post, TriggerOperation.Delete);
 
 // Configure trigger for replace operations
 entity.HasTrigger("UpdateTrigger", TriggerType.Pre, TriggerOperation.Replace);
});

Fixes #5080

💬 Share your feedback on Copilot coding agent for the chance to win a 200ドル gift card! Click here to start the survey.