Joseph Doherty
8d154c6a81
- IHistorianDataSource.ReadEventsAsync(..., bool reverse, ...) overload: reverse = Part 11 window (lo, hi] newest-first by (time, id) DESC. Default forwards forward reads and throws NotSupportedException for reverse (Null); Gateway refuses explicitly (ascending-only stream). Server answers BadHistoryOperationUnsupported instead of silently returning the earliest N ascending. - SqlServer / QuestDB serve reverse natively (ORDER BY time DESC, id DESC + TOP/LIMIT). - Node manager: reverse event reads page with continuation points; direction stored in the cursor (HistoryContinuationState.Reverse) so a resume continues in the cursor's direction; reverse tie clusters over-fetched forward and sliced from the newest end (SliceTieCluster(reverse:)); end-only reads with a cap page backward from EndTime (mirrors raw). - Resumed event pages over-fetch by the boundary skip, so every non-final page is a full cap page. - Tests: node-manager reverse paging (ties, clusters, coarse resolution, overfetch bound, resume direction both ways, end-only, unsupported backend); shared EventReadConformance on SqlServer + QuestDB; over-the-wire reverse paging; offline Gateway pin of the UTC DateTime.MaxValue bound through the published client's proto conversion (in-process gRPC capture) and FILETIME. - docs/Historian.md event paging section.
562 lines
27 KiB
C#
562 lines
27 KiB
C#
using Microsoft.Extensions.Logging.Abstractions;
|
|
using Opc.Ua;
|
|
using Opc.Ua.Server;
|
|
using Shouldly;
|
|
using Xunit;
|
|
using ZB.MOM.WW.OtOpcUa.Commons.OpcUa;
|
|
using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
|
|
using HistorianRead = ZB.MOM.WW.OtOpcUa.Core.Abstractions.HistoryReadResult;
|
|
using SdkHistoryReadResult = Opc.Ua.HistoryReadResult;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests;
|
|
|
|
/// <summary>
|
|
/// Gitea #669 — server-side continuation-point paging for HistoryRead-Events. Same harness as
|
|
/// <see cref="NodeManagerHistoryReadPagingTests"/>: a real SDK server, a session-less in-process
|
|
/// HistoryRead and an <see cref="InMemoryHistoryContinuationStore"/>, over a fake source that behaves like
|
|
/// the SQL backends (ordered by (time, id), half-open window, cap + truncation flag).
|
|
/// </summary>
|
|
public sealed class NodeManagerHistoryReadEventsPagingTests : IDisposable
|
|
{
|
|
private static CancellationToken Ct => TestContext.Current.CancellationToken;
|
|
private static readonly DateTime Epoch = new(2026, 1, 1, 0, 0, 0, DateTimeKind.Utc);
|
|
private readonly string _pkiRoot = Path.Combine(Path.GetTempPath(), $"otopcua-eventpaging-{Guid.NewGuid():N}");
|
|
|
|
[Fact]
|
|
public async Task Events_page_across_continuation_points_exactly_once_in_order()
|
|
{
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(250));
|
|
var ids = DrainAsync(nm, node, max: 100);
|
|
ids.ShouldBe(src.All.Select(e => e.EventId));
|
|
src.Calls.ShouldBeGreaterThan(2);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_tie_at_page_boundary_is_neither_duplicated_nor_skipped()
|
|
{
|
|
// Indices 2,3,4 share a timestamp; cap 4 cuts through the cluster.
|
|
var events = new List<HistoricalEvent>
|
|
{
|
|
Ev("e0", 0), Ev("e1", 1), Ev("e2", 2), Ev("e3", 2), Ev("e4", 2), Ev("e5", 3),
|
|
};
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
DrainAsync(nm, node, max: 4).ShouldBe(["e0", "e1", "e2", "e3", "e4", "e5"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_tie_cluster_larger_than_the_cap_pages_within_the_cluster()
|
|
{
|
|
var events = new List<HistoricalEvent> { Ev("a0", 0) };
|
|
for (var i = 0; i < 7; i++) events.Add(Ev($"t{i}", 5));
|
|
events.Add(Ev("z0", 9));
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
DrainAsync(nm, node, max: 3).ShouldBe(
|
|
["a0", "t0", "t1", "t2", "t3", "t4", "t5", "t6", "z0"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_tie_cluster_beyond_the_overfetch_bound_fails_loudly()
|
|
{
|
|
var events = new List<HistoricalEvent>();
|
|
for (var i = 0; i < 10; i++) events.Add(Ev($"t{i:00}", 5));
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
nm.MaxTieClusterOverfetch = 4;
|
|
|
|
var p1 = ReadEvents(nm, node, max: 3, inboundCp: null);
|
|
p1.Cp.ShouldNotBeNull();
|
|
var p2 = ReadEvents(nm, node, max: 3, inboundCp: p1.Cp);
|
|
p2.Error.StatusCode.Code.ShouldBe(StatusCodes.BadHistoryOperationUnsupported);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_unknown_continuation_point_is_BadContinuationPointInvalid()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(5));
|
|
var r = ReadEvents(nm, node, max: 2, inboundCp: Guid.NewGuid().ToByteArray());
|
|
r.Error.StatusCode.Code.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_release_drops_the_cursor()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var p1 = ReadEvents(nm, node, max: 4, inboundCp: null);
|
|
p1.Cp.ShouldNotBeNull();
|
|
InvokeRelease(nm, node, p1.Cp!);
|
|
ReadEvents(nm, node, max: 4, inboundCp: p1.Cp).Error.StatusCode.Code
|
|
.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_cap_sized_complete_page_emits_no_continuation_point()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(4));
|
|
var r = ReadEvents(nm, node, max: 4, inboundCp: null);
|
|
r.Ids.Count.ShouldBe(4);
|
|
r.Cp.ShouldBeNull("the source did not flag truncation, so a cap-sized page is not a paged one");
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_unbounded_request_never_pages()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(300));
|
|
var r = ReadEvents(nm, node, max: 0, inboundCp: null);
|
|
r.Ids.Count.ShouldBe(300);
|
|
r.Cp.ShouldBeNull();
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task A_raw_cursor_presented_to_an_events_read_is_invalid()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var raw = nm.HistoryContinuationStore.Save(null, new HistoryContinuationState("t", Epoch, Epoch.AddDays(1), 0, 4));
|
|
ReadEvents(nm, node, max: 4, inboundCp: raw).Error.StatusCode.Code
|
|
.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_open_ended_forward_read_pages_without_duplicates()
|
|
{
|
|
// EndTime unset (MinValue) + a StartTime = "page forward from StartTime" (Part 11).
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(25));
|
|
DrainAsync(nm, node, max: 10, end: DateTime.MinValue).ShouldBe(src.All.Select(e => e.EventId));
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_cursor_is_bound_to_its_node()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var other = SecondNode(nm);
|
|
var p1 = ReadEvents(nm, node, max: 4, inboundCp: null);
|
|
p1.Cp.ShouldNotBeNull();
|
|
ReadEvents(nm, other, max: 4, inboundCp: p1.Cp).Error.StatusCode.Code
|
|
.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Raw_cursor_is_bound_to_its_node()
|
|
{
|
|
var (host, nm, _, _) = await SetupAsync(Distinct(1));
|
|
nm.HistorianDataSource = new RawSeriesSource();
|
|
nm.EnsureVariable("eq-1/a", null, "A", "Double", false, historianTagname: "WW.A", realm: AddressSpaceRealm.Uns);
|
|
nm.EnsureVariable("eq-1/b", null, "B", "Double", false, historianTagname: "WW.B", realm: AddressSpaceRealm.Uns);
|
|
var a = nm.TryGetVariable("eq-1/a")!.NodeId;
|
|
var b = nm.TryGetVariable("eq-1/b")!.NodeId;
|
|
|
|
byte[] RawRead(NodeId n, byte[]? cp, out ServiceResult err)
|
|
{
|
|
var ctx = new OperationContext(new RequestHeader(), secureChannelContext: null, RequestType.HistoryRead, identity: null);
|
|
var res = new List<SdkHistoryReadResult> { null! };
|
|
var errs = new List<ServiceResult> { null! };
|
|
nm.HistoryRead(ctx, new ReadRawModifiedDetails { StartTime = Epoch, EndTime = Epoch.AddHours(1), NumValuesPerNode = 2, IsReadModified = false },
|
|
TimestampsToReturn.Both, false,
|
|
new List<HistoryReadValueId> { new() { NodeId = n, ContinuationPoint = cp } }, res, errs);
|
|
err = errs[0];
|
|
return res[0]?.ContinuationPoint!;
|
|
}
|
|
|
|
var cp = RawRead(a, null, out var err0);
|
|
err0.StatusCode.Code.ShouldBe(StatusCodes.Good, err0.ToString());
|
|
cp.ShouldNotBeNull();
|
|
RawRead(b, cp, out var err);
|
|
err.StatusCode.Code.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_tie_cluster_pages_on_a_coarse_resolution_backend()
|
|
{
|
|
const long res = 10; // QuestDB-like: inputs truncate to 10 ticks
|
|
var events = new List<HistoricalEvent>();
|
|
DateTime At(int slot) => Epoch.AddTicks(slot * res);
|
|
events.Add(new("a0", "s", At(0), Epoch, "m", 500));
|
|
for (var i = 0; i < 7; i++) events.Add(new($"t{i}", "s", At(3), Epoch, "m", 500));
|
|
events.Add(new("z0", "s", At(8), Epoch, "m", 500));
|
|
var (host, nm, node, _) = await SetupAsync(events, res);
|
|
DrainAsync(nm, node, max: 3).ShouldBe(["a0", "t0", "t1", "t2", "t3", "t4", "t5", "t6", "z0"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Events_batch_one_node_failing_does_not_disturb_another_that_pages()
|
|
{
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(10));
|
|
var other = SecondNode(nm);
|
|
var good1 = ReadBatch(nm, 4, null, (node, null), (other, null));
|
|
good1[0].Cp.ShouldNotBeNull();
|
|
good1[1].Cp.ShouldNotBeNull();
|
|
|
|
var mixed = ReadBatch(nm, 4, null, (node, good1[0].Cp), (other, Guid.NewGuid().ToByteArray()));
|
|
mixed[0].Error.StatusCode.Code.ShouldBe(StatusCodes.Good);
|
|
// A resumed page is FULL (#675): it over-fetches by the boundary skip it then trims.
|
|
mixed[0].Ids.ShouldBe(src.All.Skip(4).Take(4).Select(e => e.EventId));
|
|
mixed[1].Error.StatusCode.Code.ShouldBe(StatusCodes.BadContinuationPointInvalid);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
// --- Gitea #675: reverse (newest-first) event paging ------------------------------------------------------
|
|
|
|
[Fact]
|
|
public async Task Reverse_events_page_newest_first_exactly_once_with_exact_page_counts()
|
|
{
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(250));
|
|
var pages = new List<int>();
|
|
var ids = DrainAsync(nm, node, max: 100, start: Late, end: Early, pageSizes: pages);
|
|
ids.ShouldBe(src.All.Reverse().Select(e => e.EventId));
|
|
pages.ShouldBe([100, 100, 50]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_first_page_is_the_LATEST_events_with_a_continuation_point()
|
|
{
|
|
// The pre-#675 shape: the cap kept the EARLIEST N, ascending, Good, and no continuation point.
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var p1 = ReadEvents(nm, node, max: 3, inboundCp: null, end: Early, start: Late);
|
|
p1.Error.StatusCode.Code.ShouldBe(StatusCodes.Good);
|
|
p1.Ids.ShouldBe(["e0009", "e0008", "e0007"]);
|
|
p1.Cp.ShouldNotBeNull("a capped reverse read has more behind it and must page");
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_tie_at_page_boundary_is_neither_duplicated_nor_skipped()
|
|
{
|
|
var events = new List<HistoricalEvent>
|
|
{
|
|
Ev("e0", 0), Ev("e1", 1), Ev("e2", 2), Ev("e3", 2), Ev("e4", 2), Ev("e5", 3),
|
|
};
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
// Newest-first, ties in descending EventId: cap 2 cuts the cluster at e4|e3.
|
|
DrainAsync(nm, node, max: 2, start: Late, end: Early).ShouldBe(["e5", "e4", "e3", "e2", "e1", "e0"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_tie_cluster_larger_than_the_cap_pages_within_the_cluster()
|
|
{
|
|
var events = new List<HistoricalEvent> { Ev("a0", 0) };
|
|
for (var i = 0; i < 7; i++) events.Add(Ev($"t{i}", 5));
|
|
events.Add(Ev("z0", 9));
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
var pages = new List<int>();
|
|
DrainAsync(nm, node, max: 3, start: Late, end: Early, pageSizes: pages).ShouldBe(
|
|
["z0", "t6", "t5", "t4", "t3", "t2", "t1", "t0", "a0"]);
|
|
pages.Sum().ShouldBe(9);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_tie_cluster_pages_on_a_coarse_resolution_backend()
|
|
{
|
|
const long res = 10;
|
|
var events = new List<HistoricalEvent>();
|
|
DateTime At(int slot) => Epoch.AddTicks(slot * res);
|
|
events.Add(new("a0", "s", At(0), Epoch, "m", 500));
|
|
for (var i = 0; i < 7; i++) events.Add(new($"t{i}", "s", At(3), Epoch, "m", 500));
|
|
events.Add(new("z0", "s", At(8), Epoch, "m", 500));
|
|
var (host, nm, node, _) = await SetupAsync(events, res);
|
|
DrainAsync(nm, node, max: 3, start: Late, end: Early).ShouldBe(
|
|
["z0", "t6", "t5", "t4", "t3", "t2", "t1", "t0", "a0"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_tie_cluster_beyond_the_overfetch_bound_fails_loudly()
|
|
{
|
|
var events = new List<HistoricalEvent>();
|
|
for (var i = 0; i < 10; i++) events.Add(Ev($"t{i:00}", 5));
|
|
var (host, nm, node, _) = await SetupAsync(events);
|
|
nm.MaxTieClusterOverfetch = 4;
|
|
var p1 = ReadEvents(nm, node, max: 3, inboundCp: null, end: Early, start: Late);
|
|
p1.Cp.ShouldNotBeNull();
|
|
ReadEvents(nm, node, max: 3, inboundCp: p1.Cp, end: Early, start: Late).Error.StatusCode.Code
|
|
.ShouldBe(StatusCodes.BadHistoryOperationUnsupported);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task A_reverse_cursor_resumes_reverse_whatever_the_resume_request_says()
|
|
{
|
|
// The direction lives in the cursor: a resume carrying FORWARD details still continues newest-first.
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var p1 = ReadEvents(nm, node, max: 4, inboundCp: null, end: Early, start: Late);
|
|
p1.Ids.ShouldBe(["e0009", "e0008", "e0007", "e0006"]);
|
|
var p2 = ReadEvents(nm, node, max: 4, inboundCp: p1.Cp); // default details: Early -> Late (forward)
|
|
p2.Error.StatusCode.Code.ShouldBe(StatusCodes.Good);
|
|
p2.Ids.ShouldBe(["e0005", "e0004", "e0003", "e0002"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task A_forward_cursor_resumes_forward_whatever_the_resume_request_says()
|
|
{
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(10));
|
|
var p1 = ReadEvents(nm, node, max: 4, inboundCp: null);
|
|
p1.Ids.ShouldBe(["e0000", "e0001", "e0002", "e0003"]);
|
|
var p2 = ReadEvents(nm, node, max: 4, inboundCp: p1.Cp, end: Early, start: Late);
|
|
p2.Ids.ShouldBe(["e0004", "e0005", "e0006", "e0007"]);
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Reverse_unbounded_read_returns_everything_newest_first_without_paging()
|
|
{
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(30));
|
|
var r = ReadEvents(nm, node, max: 0, inboundCp: null, end: Early, start: Late);
|
|
r.Ids.ShouldBe(src.All.Reverse().Select(e => e.EventId));
|
|
r.Cp.ShouldBeNull();
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task End_only_events_read_pages_backward_from_EndTime()
|
|
{
|
|
// StartTime unset + EndTime + NumValuesPerNode > 0 => backward from EndTime (Part 11; mirrors raw). The reverse
|
|
// window is (.., EndTime], so an event exactly AT EndTime is the first one returned.
|
|
var (host, nm, node, _) = await SetupAsync(Distinct(25));
|
|
var ids = DrainAsync(nm, node, max: 10, start: DateTime.MinValue, end: Epoch.AddSeconds(20));
|
|
ids.ShouldBe(Enumerable.Range(0, 21).Reverse().Select(i => $"e{i:0000}"));
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
[Fact]
|
|
public async Task A_backend_without_reverse_support_answers_BadHistoryOperationUnsupported_not_the_earliest_events()
|
|
{
|
|
var (host, nm, node, src) = await SetupAsync(Distinct(10));
|
|
nm.HistorianDataSource = new ForwardOnlyEventSource(src);
|
|
ReadEvents(nm, node, max: 3, inboundCp: null, end: Early, start: Late).Error.StatusCode.Code
|
|
.ShouldBe(StatusCodes.BadHistoryOperationUnsupported);
|
|
// Forward reads on the same backend are unaffected.
|
|
DrainAsync(nm, node, max: 4).ShouldBe(src.All.Select(e => e.EventId));
|
|
await host.DisposeAsync();
|
|
}
|
|
|
|
private static readonly DateTime Early = Epoch.AddDays(-1);
|
|
private static readonly DateTime Late = Epoch.AddDays(1);
|
|
|
|
/// <summary>A backend that implements only the five-argument (forward) event read - Gateway / Null shaped.</summary>
|
|
private sealed class ForwardOnlyEventSource(IHistorianDataSource inner) : IHistorianDataSource
|
|
{
|
|
public Task<HistoricalEventsResult> ReadEventsAsync(string? n, DateTime s, DateTime e, int m, CancellationToken ct) =>
|
|
inner.ReadEventsAsync(n, s, e, m, ct);
|
|
public Task<HistorianRead> ReadRawAsync(string r, DateTime s, DateTime e, uint m, CancellationToken ct) =>
|
|
inner.ReadRawAsync(r, s, e, m, ct);
|
|
public Task<HistorianRead> ReadProcessedAsync(string r, DateTime s, DateTime e, TimeSpan i, HistoryAggregateType a, CancellationToken ct) =>
|
|
inner.ReadProcessedAsync(r, s, e, i, a, ct);
|
|
public Task<HistorianRead> ReadAtTimeAsync(string r, IReadOnlyList<DateTime> t, CancellationToken ct) =>
|
|
inner.ReadAtTimeAsync(r, t, ct);
|
|
public HistorianHealthSnapshot GetHealthSnapshot() => inner.GetHealthSnapshot();
|
|
public void Dispose() { }
|
|
}
|
|
|
|
private sealed class RawSeriesSource : IHistorianDataSource
|
|
{
|
|
public Task<HistorianRead> ReadRawAsync(string r, DateTime s, DateTime e, uint m, CancellationToken ct)
|
|
{
|
|
var rows = Enumerable.Range(0, 10).Select(i => new DataValueSnapshot((double)i, StatusCodes.Good,
|
|
Epoch.AddSeconds(i), Epoch.AddSeconds(i))).Where(v => v.SourceTimestampUtc >= s && v.SourceTimestampUtc <= e)
|
|
.Take((int)m).ToList();
|
|
return Task.FromResult(new HistorianRead(rows, null));
|
|
}
|
|
public Task<HistorianRead> ReadProcessedAsync(string r, DateTime s, DateTime e, TimeSpan i, HistoryAggregateType a, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadProcessedAsync(r, s, e, i, a, ct);
|
|
public Task<HistorianRead> ReadAtTimeAsync(string r, IReadOnlyList<DateTime> t, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadAtTimeAsync(r, t, ct);
|
|
public Task<HistoricalEventsResult> ReadEventsAsync(string? n, DateTime s, DateTime e, int m, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadEventsAsync(n, s, e, m, ct);
|
|
public HistorianHealthSnapshot GetHealthSnapshot() => NullHistorianDataSource.Instance.GetHealthSnapshot();
|
|
public void Dispose() { }
|
|
}
|
|
|
|
// --- helpers ---------------------------------------------------------------------------------
|
|
|
|
private static HistoricalEvent Ev(string id, int seconds) =>
|
|
new(id, "src", Epoch.AddSeconds(seconds), Epoch.AddSeconds(seconds), "m", 500);
|
|
|
|
private static List<HistoricalEvent> Distinct(int n) =>
|
|
Enumerable.Range(0, n).Select(i => Ev($"e{i:0000}", i)).ToList();
|
|
|
|
private static NodeId SecondNode(OtOpcUaNodeManager nm)
|
|
{
|
|
nm.EnsureFolder("eq-evt2", parentNodeId: null, displayName: "Equipment2", realm: AddressSpaceRealm.Uns);
|
|
nm.MaterialiseAlarmCondition("alarm-2", "eq-evt2", "HighTemp", "OffNormalAlarm", severity: 700, realm: AddressSpaceRealm.Uns);
|
|
return nm.TryGetFolder("eq-evt2")!.NodeId;
|
|
}
|
|
|
|
private async Task<(OpcUaApplicationHost Host, OtOpcUaNodeManager Nm, NodeId Node, SqlLikeEventSource Src)> SetupAsync(
|
|
List<HistoricalEvent> events, long resolution = 1)
|
|
{
|
|
var applicationUri = $"urn:OtOpcUa.EventPagingTest:{Guid.NewGuid():N}";
|
|
var started = await OpcUaHostStart.StartAsync(
|
|
port => new OpcUaApplicationHost(
|
|
new OpcUaApplicationHostOptions
|
|
{
|
|
ApplicationName = "OtOpcUa.EventPagingTest",
|
|
ApplicationUri = applicationUri,
|
|
OpcUaPort = port,
|
|
PublicHostname = "localhost",
|
|
PkiStoreRoot = _pkiRoot,
|
|
},
|
|
NullLogger<OpcUaApplicationHost>.Instance),
|
|
() => new OtOpcUaSdkServer(), Ct);
|
|
var nm = started.Server.NodeManager!;
|
|
nm.HistoryContinuationStore = new InMemoryHistoryContinuationStore();
|
|
var src = new SqlLikeEventSource(events, resolution);
|
|
nm.HistorianDataSource = src;
|
|
|
|
const string equipmentId = "eq-evt";
|
|
nm.EnsureFolder(equipmentId, parentNodeId: null, displayName: "Equipment", realm: AddressSpaceRealm.Uns);
|
|
nm.MaterialiseAlarmCondition("alarm-1", equipmentId, "HighTemp", "OffNormalAlarm", severity: 700, realm: AddressSpaceRealm.Uns);
|
|
return (started.Host, nm, nm.TryGetFolder(equipmentId)!.NodeId, src);
|
|
}
|
|
|
|
private static List<string> DrainAsync(
|
|
OtOpcUaNodeManager nm, NodeId node, uint max, DateTime? end = null, DateTime? start = null, List<int>? pageSizes = null)
|
|
{
|
|
var all = new List<string>();
|
|
byte[]? cp = null;
|
|
var pages = 0;
|
|
do
|
|
{
|
|
var r = ReadEvents(nm, node, max, cp, end, start);
|
|
r.Error.StatusCode.Code.ShouldBe(StatusCodes.Good);
|
|
all.AddRange(r.Ids);
|
|
pageSizes?.Add(r.Ids.Count);
|
|
cp = r.Cp;
|
|
(++pages).ShouldBeLessThan(60, "paging must terminate");
|
|
}
|
|
while (cp is not null);
|
|
return all;
|
|
}
|
|
|
|
private static (List<string> Ids, ServiceResult Error, byte[]? Cp) ReadEvents(
|
|
OtOpcUaNodeManager nm, NodeId node, uint max, byte[]? inboundCp, DateTime? end = null, DateTime? start = null) =>
|
|
ReadBatch(nm, max, end, start, (node, inboundCp))[0];
|
|
|
|
private static List<(List<string> Ids, ServiceResult Error, byte[]? Cp)> ReadBatch(
|
|
OtOpcUaNodeManager nm, uint max, DateTime? end, params (NodeId Node, byte[]? Cp)[] reads) =>
|
|
ReadBatch(nm, max, end, null, reads);
|
|
|
|
private static List<(List<string> Ids, ServiceResult Error, byte[]? Cp)> ReadBatch(
|
|
OtOpcUaNodeManager nm, uint max, DateTime? end, DateTime? start, params (NodeId Node, byte[]? Cp)[] reads)
|
|
{
|
|
var context = new OperationContext(
|
|
new RequestHeader(), secureChannelContext: null, RequestType.HistoryRead, identity: null);
|
|
var filter = new EventFilter();
|
|
filter.SelectClauses.Add(new SimpleAttributeOperand(ObjectTypeIds.BaseEventType, new QualifiedName("EventId"))
|
|
{
|
|
AttributeId = Attributes.Value,
|
|
});
|
|
var details = new ReadEventDetails
|
|
{
|
|
StartTime = start ?? Epoch.AddDays(-1),
|
|
EndTime = end ?? Epoch.AddDays(1),
|
|
NumValuesPerNode = max,
|
|
Filter = filter,
|
|
};
|
|
var nodesToRead = reads.Select(r => new HistoryReadValueId { NodeId = r.Node, ContinuationPoint = r.Cp }).ToList();
|
|
var results = reads.Select(_ => (SdkHistoryReadResult)null!).ToList();
|
|
var errors = reads.Select(_ => (ServiceResult)null!).ToList();
|
|
nm.HistoryRead(context, details, TimestampsToReturn.Both, false, nodesToRead, results, errors);
|
|
|
|
var all = new List<(List<string>, ServiceResult, byte[]?)>();
|
|
for (var i = 0; i < reads.Length; i++)
|
|
{
|
|
var ids = new List<string>();
|
|
if (results[i]?.HistoryData is { } ho && !ExtensionObject.IsNull(ho))
|
|
{
|
|
var he = (HistoryEvent)ExtensionObject.ToEncodeable(ho);
|
|
foreach (var e in he.Events)
|
|
ids.Add(System.Text.Encoding.UTF8.GetString((byte[])e.EventFields[0].Value));
|
|
}
|
|
|
|
all.Add((ids, errors[i], results[i]?.ContinuationPoint));
|
|
}
|
|
|
|
return all;
|
|
}
|
|
|
|
private static void InvokeRelease(OtOpcUaNodeManager nm, NodeId node, byte[] cp)
|
|
{
|
|
var context = new OperationContext(
|
|
new RequestHeader(), secureChannelContext: null, RequestType.HistoryRead, identity: null);
|
|
var nodesToRead = new List<HistoryReadValueId> { new() { NodeId = node, ContinuationPoint = cp } };
|
|
var results = new List<SdkHistoryReadResult> { null! };
|
|
var errors = new List<ServiceResult> { null! };
|
|
nm.HistoryRead(context, new ReadEventDetails { StartTime = Epoch, EndTime = Epoch.AddDays(1), NumValuesPerNode = 4 },
|
|
TimestampsToReturn.Both, true, nodesToRead, results, errors);
|
|
}
|
|
|
|
/// <summary>Behaves like the SqlServer/QuestDB event reads: (time, id) order, [start, end), cap, truncation flag.</summary>
|
|
private sealed class SqlLikeEventSource(List<HistoricalEvent> events, long resolution = 1) : IHistorianDataSource
|
|
{
|
|
public long TimestampResolutionTicks => resolution;
|
|
private DateTime Trunc(DateTime d) => d.AddTicks(-(d.Ticks % resolution));
|
|
|
|
public IReadOnlyList<HistoricalEvent> All { get; } =
|
|
events.OrderBy(e => e.EventTimeUtc).ThenBy(e => e.EventId, StringComparer.Ordinal).ToList();
|
|
public int Calls { get; private set; }
|
|
|
|
public Task<HistoricalEventsResult> ReadEventsAsync(
|
|
string? sourceName, DateTime startUtc, DateTime endUtc, int maxEvents, CancellationToken ct)
|
|
{
|
|
Calls++;
|
|
// Like the SQL backends: a reversed window is swapped, inputs truncate to the storage resolution.
|
|
if (startUtc > endUtc) (startUtc, endUtc) = (endUtc, startUtc);
|
|
startUtc = Trunc(startUtc);
|
|
endUtc = Trunc(endUtc);
|
|
var window = All.Where(e => e.EventTimeUtc >= startUtc && e.EventTimeUtc < endUtc).ToList();
|
|
var cap = maxEvents <= 0 ? 1000 : maxEvents;
|
|
var truncated = window.Count > cap;
|
|
return Task.FromResult(new HistoricalEventsResult(
|
|
window.Take(cap).ToList(), truncated ? new byte[] { 1 } : null));
|
|
}
|
|
|
|
/// <summary>Like the SQL backends' #675 overload: reverse => <c>(lo, hi]</c> newest-first by (time, id) descending.</summary>
|
|
public Task<HistoricalEventsResult> ReadEventsAsync(
|
|
string? sourceName, DateTime startUtc, DateTime endUtc, int maxEvents, bool reverse, CancellationToken ct)
|
|
{
|
|
if (!reverse) return ReadEventsAsync(sourceName, startUtc, endUtc, maxEvents, ct);
|
|
Calls++;
|
|
var (lo, hi) = startUtc <= endUtc ? (startUtc, endUtc) : (endUtc, startUtc);
|
|
lo = Trunc(lo);
|
|
hi = Trunc(hi);
|
|
var window = All.Where(e => e.EventTimeUtc > lo && e.EventTimeUtc <= hi).Reverse().ToList();
|
|
var cap = maxEvents <= 0 ? 1000 : maxEvents;
|
|
var truncated = window.Count > cap;
|
|
return Task.FromResult(new HistoricalEventsResult(
|
|
window.Take(cap).ToList(), truncated ? new byte[] { 1 } : null));
|
|
}
|
|
|
|
public Task<HistorianRead> ReadRawAsync(string r, DateTime s, DateTime e, uint m, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadRawAsync(r, s, e, m, ct);
|
|
public Task<HistorianRead> ReadProcessedAsync(
|
|
string r, DateTime s, DateTime e, TimeSpan i, HistoryAggregateType a, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadProcessedAsync(r, s, e, i, a, ct);
|
|
public Task<HistorianRead> ReadAtTimeAsync(string r, IReadOnlyList<DateTime> t, CancellationToken ct) =>
|
|
NullHistorianDataSource.Instance.ReadAtTimeAsync(r, t, ct);
|
|
public HistorianHealthSnapshot GetHealthSnapshot() => NullHistorianDataSource.Instance.GetHealthSnapshot();
|
|
public void Dispose() { }
|
|
}
|
|
|
|
public void Dispose()
|
|
{
|
|
if (Directory.Exists(_pkiRoot))
|
|
{
|
|
try { Directory.Delete(_pkiRoot, recursive: true); } catch { /* best effort */ }
|
|
}
|
|
}
|
|
}
|