fix(sql): bind string keys untyped on Postgres so integer key columns compare (#602 STAB-24)

Claude-Session: https://claude.ai/code/session_01Ef2ozxS7QPanGT8uoATbTe
2026-10-08 07:03:00 -04:00
parent 5a5c80ee57
commit 71881163df
8 changed files with 161 additions and 0 deletions
@@ -80,6 +80,20 @@ VALUES (7, 180.5,  1.2, TIMESTAMP '2026-07-24 10:00:00'),
       (9, NULL,   1.6, TIMESTAMP '2026-07-24 10:00:01'),
       (8, 210.25, 1.4, TIMESTAMP '2026-07-24 10:00:02');

+-- Integer-keyed EAV source (STAB-24): the key column is `integer`, so a key bound as the default
+-- `text` fails with "operator does not exist: integer = text". Pins the untyped-bind fix in
+-- PostgresDialect.ConfigureParameter for the key-value IN-list path (the wide-row `whereColumn`
+-- path is covered by latest_status.station_id above).
+CREATE TABLE sqlpoll.int_tag_values (
+    tag_id    integer          NOT NULL,
+    num_value double precision NULL,
+    sample_ts timestamp(3)     NOT NULL
+);
+
+INSERT INTO sqlpoll.int_tag_values (tag_id, num_value, sample_ts)
+VALUES (101, 77.5, TIMESTAMP '2026-07-24 10:00:00'),
+       (102, 12.0, TIMESTAMP '2026-07-24 10:00:01');
+
 RESET ROLE;

 -- ── grants: USAGE + SELECT and nothing else ───────────────────────────────────────────────────
@@ -114,6 +114,63 @@ public sealed class PostgresReadTests
            .ShouldBe(PostgresFixture.NewestStationOvenTemp);
    }

+    // ---- integer key columns (STAB-24) ----
+
+    /// <summary>
+    ///     A key-value tag whose key column is <c>integer</c> reads. Authored <c>keyValue</c> is text, and
+    ///     Npgsql's default <c>text</c> bind has no <c>integer = text</c> operator — the read failed with a
+    ///     provider error before <c>PostgresDialect.ConfigureParameter</c> sent string binds untyped.
+    /// </summary>
+    [Fact]
+    public async Task ReadAsync_realPostgres_integerKeyColumnComparesAgainstAuthoredText()
+    {
+        SkipUnlessLive();
+
+        await using var driver = await StartAsync(Tag("Sql/IntKey/Tag101", new JsonObject
+        {
+            ["driver"] = "Sql",
+            ["model"] = "KeyValue",
+            ["table"] = PostgresFixture.Qualified("int_tag_values"),
+            ["keyColumn"] = "tag_id",
+            ["keyValue"] = "101",
+            ["valueColumn"] = PostgresFixture.ValueColumn,
+            ["timestampColumn"] = PostgresFixture.TimestampColumn,
+        }));
+
+        var snapshot = (await driver.ReadAsync(["Sql/IntKey/Tag101"], TestContext.Current.CancellationToken))
+            .ShouldHaveSingleItem();
+
+        SqlStatusCodes.IsGood(snapshot.StatusCode).ShouldBeTrue();
+        Convert.ToDouble(snapshot.Value, CultureInfo.InvariantCulture).ShouldBe(77.5);
+    }
+
+    /// <summary>A wide-row <c>whereColumn</c> selector over the <c>integer station_id</c> column reads the matching row.</summary>
+    [Fact]
+    public async Task ReadAsync_realPostgres_integerWhereColumnSelectsTheMatchingStation()
+    {
+        SkipUnlessLive();
+
+        await using var driver = await StartAsync(Tag("Sql/Station7/OvenTemp", new JsonObject
+        {
+            ["driver"] = "Sql",
+            ["model"] = "WideRow",
+            ["table"] = PostgresFixture.Qualified(PostgresFixture.WideRowTable),
+            ["columnName"] = "oven_temp",
+            ["timestampColumn"] = PostgresFixture.TimestampColumn,
+            ["rowSelector"] = new JsonObject
+            {
+                ["whereColumn"] = "station_id",
+                ["whereValue"] = "7",
+            },
+        }));
+
+        var snapshot = (await driver.ReadAsync(["Sql/Station7/OvenTemp"], TestContext.Current.CancellationToken))
+            .ShouldHaveSingleItem();
+
+        SqlStatusCodes.IsGood(snapshot.StatusCode).ShouldBeTrue();
+        Convert.ToDouble(snapshot.Value, CultureInfo.InvariantCulture).ShouldBe(180.5);
+    }
+
    // ---- catalog case-folding (design §8.1 gate, against a real information_schema) ----

    /// <summary>