feat(historian): SQL Server value writer, tag provisioner, alarm writer (T9)

Claude-Session: https://claude.ai/code/session_01Ef2ozxS7QPanGT8uoATbTe
2026-10-09 13:08:43 -04:00
parent 65e6352dad
commit bef47f89da
8 changed files with 864 additions and 0 deletions
@@ -0,0 +1,47 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.AlarmHistorian;
+
+namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.SqlServer.Tests;
+
+public sealed class AlarmEventIdTests
+{
+    private static readonly DateTime T = new(2026, 10, 9, 1, 2, 3, DateTimeKind.Utc);
+
+    private static AlarmHistorianEvent Ev(string path = "P", string id = "A", string kind = "Activated", string user = "u",
+        string? comment = "c", string msg = "m", DateTime? t = null) =>
+        new(id, path, "n", "LimitAlarm", AlarmSeverity.High, kind, msg, user, comment, t ?? T);
+
+    [Fact]
+    public void Id_is_stable_lowercase_hex_sha256()
+    {
+        var a = SqlServerAlarmHistorianWriter.ComputeEventId(Ev());
+        a.ShouldBe(SqlServerAlarmHistorianWriter.ComputeEventId(Ev()));
+        a.Length.ShouldBe(64);
+        a.ShouldBe(a.ToLowerInvariant());
+    }
+
+    [Fact]
+    public void Field_boundaries_are_unambiguous()
+    {
+        // The delimiter-based scheme collided on these; length prefixes must not.
+        SqlServerAlarmHistorianWriter.ComputeEventId(Ev(path: "a|b", id: "c"))
+            .ShouldNotBe(SqlServerAlarmHistorianWriter.ComputeEventId(Ev(path: "a", id: "b|c")));
+        SqlServerAlarmHistorianWriter.ComputeEventId(Ev(path: "ab", id: "c"))
+            .ShouldNotBe(SqlServerAlarmHistorianWriter.ComputeEventId(Ev(path: "a", id: "bc")));
+    }
+
+    [Fact]
+    public void Null_and_empty_differ_and_every_field_participates()
+    {
+        var basis = SqlServerAlarmHistorianWriter.ComputeEventId(Ev());
+        SqlServerAlarmHistorianWriter.ComputeEventId(Ev(comment: null)).ShouldNotBe(SqlServerAlarmHistorianWriter.ComputeEventId(Ev(comment: "")));
+        foreach (var other in new[]
+                 {
+                     Ev(path: "Q"), Ev(id: "B"), Ev(kind: "Cleared"), Ev(user: "v"), Ev(comment: "d"), Ev(msg: "x"),
+                     Ev(t: T.AddTicks(1)),
+                 })
+            SqlServerAlarmHistorianWriter.ComputeEventId(other).ShouldNotBe(basis);
+    }
+}
@@ -0,0 +1,46 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+
+namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.SqlServer.Tests;
+
+public sealed class ValueWriterPrepareTests
+{
+    private static readonly DateTime T = new(2026, 10, 9, 1, 2, 3, DateTimeKind.Utc);
+
+    [Fact]
+    public void Non_finite_doubles_become_Empty_keeping_status()
+    {
+        const uint status = 0x40000000u;
+        var rows = SqlServerHistorianValueWriter.Prepare(
+        [
+            new(T, HistorianValue.FromDouble(double.NaN), status),
+            new(T.AddTicks(1), HistorianValue.FromDouble(double.PositiveInfinity), 0),
+            new(T.AddTicks(2), HistorianValue.FromDouble(double.NegativeInfinity), 0),
+            new(T.AddTicks(3), HistorianValue.FromDouble(1.5), 0),
+        ], () => T);
+        rows.Select(r => r.Value.Kind).ShouldBe([HistorianValueKind.Empty, HistorianValueKind.Empty, HistorianValueKind.Empty, HistorianValueKind.Double]);
+        rows[0].StatusCode.ShouldBe(status);
+    }
+
+    [Fact]
+    public void Duplicate_timestamps_keep_the_first_and_null_timestamp_uses_the_clock()
+    {
+        var rows = SqlServerHistorianValueWriter.Prepare(
+        [
+            new(T, HistorianValue.FromInt64(1), 0), new(T, HistorianValue.FromInt64(2), 0),
+            new(null, HistorianValue.FromInt64(3), 0),
+        ], () => T.AddDays(1));
+        rows.Count.ShouldBe(2);
+        rows[0].Value.Integer.ShouldBe(1);
+        rows[1].TimeUtc.ShouldBe(T.AddDays(1));
+    }
+
+    [Fact]
+    public void Data_type_mapping_is_one_table()
+    {
+        SqlHistorianDataTypes.FromKind(HistorianValueKind.Double).ShouldBe((byte)DriverDataType.Float64);
+        SqlHistorianDataTypes.FromKind(HistorianValueKind.Boolean).ShouldBe((byte)DriverDataType.Boolean);
+        SqlHistorianDataTypes.FromKind(HistorianValueKind.Empty).ShouldBe((byte)DriverDataType.Float64);
+    }
+}