feat(data): add database abstractions and SQLite binding

IDatabase/IDbSession/IDbTransaction with positional $n parameters, typed
DbParam and DbRow, SqlDialect helpers, and a P/Invoke binding to the
system SQLite (winsqlite3 / libsqlite3) with WAL pragmas, statement
cache, serialized writes, busy retry, interrupt-based cancellation,
VACUUM INTO backups and restore.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-02 09:40:33 +00:00
1 parent 800843d2ae
commit a09aa16876
14 files changed
+1880

No files matched your search

+78
View File
@@ -0,0 +1,78 @@
using System.Text;
namespace Titano.Data;
/// <summary>
/// The few SQL fragments that differ between SQLite (≥ 3.31) and PostgreSQL. Everything else in the
/// repositories is plain SQL that both accept: <c>$n</c> placeholders, <c>ON CONFLICT … DO UPDATE</c>,
/// <c>TRUE</c>/<c>FALSE</c>, <c>NULLS LAST</c>, <c>LIKE … ESCAPE</c>.
/// </summary>
public sealed class SqlDialect
{
/// <summary>Separator of <see cref="StringAgg"/> lists (ASCII unit separator, never part of a tag).</summary>
public const char ListSeparator = '\u001f';
private SqlDialect(Dialect dialect) => Dialect = dialect;
public static SqlDialect Sqlite { get; } = new(Dialect.Sqlite);
public static SqlDialect Postgres { get; } = new(Dialect.Postgres);
public Dialect Dialect { get; }
public bool IsPostgres => Dialect == Dialect.Postgres;
public static SqlDialect For(Dialect dialect) => dialect == Dialect.Postgres ? Postgres : Sqlite;
/// <summary>Row lock for read-modify-write inside a transaction; empty on SQLite, whose <c>BEGIN IMMEDIATE</c> already holds the write lock.</summary>
public string ForUpdate => IsPostgres ? " FOR UPDATE" : string.Empty;
/// <summary>Calendar year of a timestamp column (SQLite stores ISO-8601 text).</summary>
public string Year(string expression) => IsPostgres
? $"CAST(EXTRACT(YEAR FROM {expression}) AS integer)"
: $"CAST(substr({expression}, 1, 4) AS INTEGER)";
/// <summary>Month (1–12) of a timestamp column.</summary>
public string Month(string expression) => IsPostgres
? $"CAST(EXTRACT(MONTH FROM {expression}) AS integer)"
: $"CAST(substr({expression}, 6, 2) AS INTEGER)";
/// <summary>Aggregate that joins the group's values with <see cref="ListSeparator"/> (order unspecified).</summary>
public string StringAgg(string expression) => IsPostgres
? $"string_agg({expression}, chr(31))"
: $"group_concat({expression}, char(31))";
/// <summary>
/// <c>INSERT … VALUES ($1…$n) ON CONFLICT (keys) DO UPDATE SET …</c>; the first <paramref name="keyCount"/>
/// columns form the conflict target. The syntax is shared by SQLite ≥ 3.24 and PostgreSQL ≥ 9.5.
/// </summary>
public static string Upsert(string table, IReadOnlyList<string> columns, int keyCount)
{
ArgumentOutOfRangeException.ThrowIfLessThan(keyCount, 1);
ArgumentOutOfRangeException.ThrowIfGreaterThan(keyCount, columns.Count);
var sb = new StringBuilder("INSERT INTO ").Append(table).Append(" (").AppendJoin(", ", columns).Append(") VALUES (");
for (var i = 1; i <= columns.Count; i++) sb.Append(i > 1 ? ", $" : "$").Append(i);
sb.Append(") ON CONFLICT (");
for (var i = 0; i < keyCount; i++) sb.Append(i > 0 ? ", " : string.Empty).Append(columns[i]);
if (keyCount == columns.Count) return sb.Append(") DO NOTHING").ToString();
sb.Append(") DO UPDATE SET ");
for (var i = keyCount; i < columns.Count; i++)
sb.Append(i > keyCount ? ", " : string.Empty).Append(columns[i]).Append(" = excluded.").Append(columns[i]);
return sb.ToString();
}
/// <summary>Double-quotes an identifier (both dialects).</summary>
public static string QuoteIdentifier(string name) => "\"" + name.Replace("\"", "\"\"", StringComparison.Ordinal) + "\"";
/// <summary>A <c>LIKE … ESCAPE '\'</c> pattern that matches <paramref name="text"/> anywhere.</summary>
public static string ContainsPattern(string text)
{
var sb = new StringBuilder(text.Length + 2).Append('%');
foreach (var c in text)
{
if (c is '%' or '_' or '\\') sb.Append('\\');
sb.Append(c);
}
return sb.Append('%').ToString();
}
}