using System.Globalization; using System.Text.RegularExpressions; using Grpc.Core; namespace ZB.MOM.WW.OtOpcUa.Driver.Historian.Gateway; /// /// The HistorianGateway's raw-read row ceiling (Historian:ReadLimits:MaxValuesCeiling, default 1,000,000) as seen /// from this side of the wire. With AllowStreamingBeyondCeiling=false (a "strict" gateway) the gateway refuses /// any ReadRaw whose max_values exceeds the ceiling with InvalidArgument — BEFORE it streams a row /// — and names the ceiling in the refusal ("max_values exceeds the server ceiling of {n}; …"). The gateway has /// no RPC that reports the ceiling, so the refusal is how it is learned (#691.3). /// /// /// A read whose budget the gateway refuses is re-issued ONCE with the ceiling as its budget /// (); the caller then treats a stream that delivered the whole ceiling as /// possibly truncated (never answered from). Nothing is cached: a re-configured gateway is honoured on the next read, /// and a refusal costs one round-trip with no historian work behind it (it is validated before a session is acquired). /// internal static class GatewayReadLimits { private const string CeilingRejectionText = "max_values exceeds the server ceiling"; private static readonly Regex CeilingNumber = new(@"max_values exceeds the server ceiling of (\d+)", RegexOptions.CultureInvariant | RegexOptions.Compiled); /// /// True when (or an inner exception — the client package wraps the ) /// is the gateway's InvalidArgument "max_values exceeds the server ceiling" rejection. /// /// The exception. /// Whether it is the ceiling rejection. public static bool IsCeilingRejection(Exception ex) => Rejection(ex) is not null; /// /// The ceiling a ceiling rejection names, or — when is a ceiling rejection that does not /// carry a parseable number — the gateway's default (). /// /// The exception. /// The ceiling (> 0) when this returns true. /// Whether is a ceiling rejection. public static bool TryGetCeiling(Exception ex, out int ceiling) { ceiling = 0; if (Rejection(ex) is not { } rpc) return false; var m = CeilingNumber.Match(rpc.Status.Detail); ceiling = m.Success && int.TryParse(m.Groups[1].Value, NumberStyles.None, CultureInfo.InvariantCulture, out var n) && n > 0 ? n : RawAggregateReader.GatewayDefaultMaxValuesCeiling; return true; } /// /// Runs with ; if a strict gateway refuses that budget, runs it once /// more with the ceiling it named — only when that ceiling is smaller than the refused budget (otherwise the refusal /// is rethrown). The refusal arrives before any row, so the first pass has consumed nothing. /// /// The pass result. /// The max_values to ask for first. /// One drained read with the given budget. /// The pass result and the budget it actually used. public static async Task<(T Result, int Budget)> ReadWithCeilingRetryAsync(int budget, Func> pass) { int ceiling; try { return (await pass(budget).ConfigureAwait(false), budget); } catch (Exception ex) when (TryGetCeiling(ex, out ceiling) && ceiling < budget) { // fall through to the retry (outside the catch, so a second refusal is not nested in this one) } return (await pass(ceiling).ConfigureAwait(false), ceiling); } private static RpcException? Rejection(Exception ex) { for (var e = ex; e is not null; e = e.InnerException) if (e is RpcException { StatusCode: StatusCode.InvalidArgument } rpc && rpc.Status.Detail.Contains(CeilingRejectionText, StringComparison.Ordinal)) return rpc; return null; } }