Система хранения истории изменений, также известная как временная или темпоральная база данных, является важной составляющей многих приложений. Это позволяет пользователям отслеживать изменения данных со временем и дает возможность «возвращаться» к предыдущим версиям записей. В этой статье мы рассмотрим, как создать такую систему с использованием языка программирования C#. Мы обсудим основные концепции, примеры кода и лучшие практики.
Темпоральная база данных — это система управления данными, которая способна хранить информацию о различных состояниях объектов во времени. Основные типы темпоральных моделей:
-
Системные часы (System-Versioned): Использует системное время, обычно метки времени создания и изменения записи. Не требуют от пользователя ввода дополнительной информации о временных интервалах.
-
Таблицы с пользовательскими версиями (User-Versioned): Требует указания пользователем начального и конечного времени, за которые запись была актуальна.
Система хранения истории изменений включает несколько ключевых компонентов:
-
Исходные данные: Оригинальная таблица, которая будет расширена для поддержки временных функций.
-
Таблицы версий: Дополнительные таблицы или колонки в исходной таблице, содержащие историческую информацию о записях.
-
Логи изменений: Записи о том, какие операции были выполнены над данными (INSERT, UPDATE, DELETE).
Создание системы хранения истории изменений начинается с настройки структуры таблиц в базе данных. Рассмотрим пример на Microsoft SQL Server.
Предположим, у нас есть таблица Products, содержащая информацию о товарах:
CREATE TABLE Products (
ProductID INT PRIMARY KEY,
Name NVARCHAR(100),
Price DECIMAL(10, 2)
);
Чтобы добавить темпоральные функции, можно использовать один из подходов.
CREATE TABLE Products (
ProductID INT PRIMARY KEY,
Name NVARCHAR(100),
Price DECIMAL(10, 2),
SysStartTime DATETIME2 GENERATED ALWAYS AS ROW START NOT NULL DEFAULT SYSUTCDATETIME(),
SysEndTime DATETIME2 GENERATED ALWAYS AS ROW END NOT NULL DEFAULT CONVERT(DATETIME2, '9999-12-31 23:59:59.9999999'),
PERIOD FOR SYSTEM_TIME (SysStartTime, SysEndTime)
) WITH (SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.ProductsHistory));
Здесь мы создаем таблицу Products с системными часами и указываем таблицу для хранения истории (ProductsHistory).
CREATE TABLE Products (
ProductID INT PRIMARY KEY,
Name NVARCHAR(100),
Price DECIMAL(10, 2),
ValidFrom DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME(),
ValidTo DATETIME2 NULL
);
В этом случае пользователь сам указывает диапазоны актуальности записей.
Следующий шаг — написание кода на C#, который будет работать с темпоральной базой данных. Для этого можно использовать Entity Framework Core (EF Core) или другие ORM.
В проекте создайте модели, которые будут соответствовать таблицам в вашей базе данных:
public class Product
{
public int ProductID { get; set; }
public string Name { get; set; }
public decimal Price { get; set; }
// Для подхода с системными часами
[Column(TypeName = "datetime2")]
public DateTime SysStartTime { get; set; }
[Column(TypeName = "datetime2")]
public DateTime SysEndTime { get; set; }
}
Создайте контекст базы данных:
public class AppDbContext : DbContext
{
public DbSet<Product> Products { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer("YourConnectionString");
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Product>()
.ToTable("Products")
.HasHistoricalTimePeriods(); // Используется для системного подхода
}
}
Все операции вставки происходят автоматически. EF Core обрабатывает создание записей и обновление таблицы истории.
using (var context = new AppDbContext())
{
var product = new Product { Name = "New Product", Price = 99.99m };
context.Products.Add(product);
context.SaveChanges();
}
Обновление записи также будет отражено в таблице истории:
using (var context = new AppDbContext())
{
var product = context.Products.First(p => p.ProductID == 1);
product.Price = 79.99m;
context.SaveChanges();
}
С EF Core можно получать данные по состоянию на конкретную дату:
using (var context = new AppDbContext())
{
var productsAsOfDate = context.Products
.SystemVersion()
.AsOf(new DateTime(2023, 10, 1))
.ToList();
}
Удаление записи также вносит изменения в таблицу истории:
using (var context = new AppDbContext())
{
var product = context.Products.First(p => p.ProductID == 1);
context.Products.Remove(product);
context.SaveChanges();
}
Система хранения истории изменений позволяет легко создавать отчеты об изменениях данных. Например, можно написать функцию, которая выведет все изменения для конкретного товара:
public void GetProductHistory(int productId)
{
using (var context = new AppDbContext())
{
var productHistory = context.Products
.SystemVersion()
.ForRange(DateTime.MinValue, DateTime.MaxValue)
.Where(p => p.ProductID == productId)
.OrderBy(p => p.SysStartTime)
.ToList();
foreach (var entry in productHistory)
{
Console.WriteLine($"Product ID: {entry.ProductID}, Name: {entry.Name}, Price: {entry.Price}, Valid from: {entry.SysStartTime}, Valid to: {entry.SysEndTime}");
}
}
}
Система хранения истории изменений значительно увеличивает функциональность приложений, позволяя эффективно отслеживать изменения данных со временем. Используя C# вместе с такими инструментами, как EF Core и SQL Server, можно легко создать мощные темпоральные решения.
При реализации системы хранения истории изменений необходимо учитывать аспекты производительности баз данных, так как дополнительное хранение может привести к увеличению объема данных. Однако современные технологии и оптимизация запросов позволяют минимизировать влияние на производительность.
Создание системы хранения истории изменений — это комплексный процесс, который требует понимания как баз данных, так и языка программирования. Однако при правильном подходе он открывает новые возможности для анализа данных и управления информацией в вашем приложении.

