Skip to main content

Version 0.1.5

Release Date: August 28, 2025

This release focuses on stability improvements and initial feature set establishment for Entity Framework Core integration with TimescaleDB.

Features​

Core TimescaleDB Integration​

This release represents the foundational implementation of TimescaleDB support for Entity Framework Core, including:

Hypertable Management:

  • Create and configure hypertables using fluent API or data annotations
  • Support for chunk time intervals to control data partitioning
  • Multiple dimension support (time and space dimensions)
  • Chunk skipping optimization for faster queries
  • Native compression support for reduced storage requirements

Development Tools:

  • Design-time support for Entity Framework Core CLI tooling
  • Migration generation for TimescaleDB-specific features
  • Example projects demonstrating common usage patterns

Code-First and Database-First:

  • Define hypertables in code using attributes or fluent configuration
  • Scaffold existing TimescaleDB databases to generate entity models

Improvements​

Build Process​

Addressed warnings during the continuous deployment pipeline execution to ensure clean builds and reliable package publishing.

Documentation​

Added comprehensive README documentation and licensing information to help developers get started with the library.

Dependencies​

This release establishes compatibility with:

  • Entity Framework Core 8.x
  • Npgsql Entity Framework Core Provider
  • TimescaleDB 2.x and later

Getting Started​

Install the NuGet packages:

dotnet add package CmdScale.EntityFrameworkCore.TimescaleDB
dotnet add package CmdScale.EntityFrameworkCore.TimescaleDB.Design

Configure the DbContext:

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseNpgsql(connectionString)
        .UseTimescaleDb();
}

Define a hypertable:

[Hypertable]
public class SensorReading
{
    public DateTime Timestamp { get; set; }
    public double Temperature { get; set; }
}

For detailed examples, refer to the sample projects in the GitHub repository.