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:
14 files changed
+1880
No files matched your search
@@ -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();
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user