Files
zeekay d9f7c4da8e the storage tier can address the backend it selects
BASE_DB_TIER=sql opened PostgreSQL and then spoke to it in SQLite: strftime,
sqlite_master, json_extract, json_each, an INTEGER column holding an int64, an
outer join with no ON, backticked identifiers, and a rowid that only one engine
has. The tier picked a backend the queries could not reach.

Every one of those now comes from hanzoai/orm/dialect, resolved once from the
driver the data DB was opened with and reachable as app.Dialect(). Base holds no
switch on the engine — it asks for the JSON accessors, the schema catalog, the
generated instant and identifier, and the column types, and it asks whether a
feature exists at all where one engine has nothing to offer: an insertion-order
column, a write-ahead log to fold, a function that renders an instant. Empty
means the caller falls back or refuses rather than emitting something the engine
will reject.

Some differences turned out not to need a dialect at all. An instant is stored
as text in a fixed layout, so bucketing the log rollup to the hour is a
substring rather than a calendar function, which every engine spells the same
way and an index can be built on. Null-safe equality is IS NOT DISTINCT FROM.
An int64 column is BIGINT. A join with nothing of its own to match still states
a condition. Case-insensitive comparison stays COLLATE NOCASE, because the
schema now asks the engine for the collation that name refers to.

The proof is a Postgres 18 running the data plane: migrations apply, a
collection created over /v1 lands as a table with text, numeric and jsonb
columns and its declared index, and records insert, page, sort, filter across
scalars, multi-value elements and JSON paths, update and delete. A unique index
declared COLLATE NOCASE rejects the second spelling of a handle.

Comparing a JSON sub-path to a number is refused there: the extraction yields
text, the literal binds as a number, and the filter language does not say which
the comparison meant. Compared as text it works.
2026-08-11 10:39:19 -07:00

38 lines
1.2 KiB
Go

package dbutils
import (
"github.com/hanzoai/orm/dialect"
)
// The helpers here take a column name and hand the engine's spelling back with
// the identifier bracketed the way dbx expects it. The spelling itself belongs
// to the dialect — a column declared to hold JSON may equally hold a bare
// scalar, and normalizing that is the same problem on every engine.
// JSONEach is a relation with one row per element of the column, in a column
// named value.
func JSONEach(d dialect.Dialect, column string) string {
return d.Each(bracket(column))
}
// JSONArrayLength counts the elements of the column. An empty or null column
// is 0.
func JSONArrayLength(d dialect.Dialect, column string) string {
return d.Length(bracket(column))
}
// JSONExtract reads path out of the column as text. The path is relative to
// the value: "a.b", "[0]" or "" for the value itself.
func JSONExtract(d dialect.Dialect, column string, path string) string {
// a property path reads as a member unless it already opens with an index
if path != "" && path[0] != '[' {
path = "." + path
}
return d.Extract(bracket(column), path)
}
func bracket(column string) string {
return "[[" + column + "]]"
}