1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
|
open Relational_engine
let default_port = 7777
let default_limit = 50
(* TODO: AbstractValue carries no type tag of its own; we recover the OCaml
runtime tag here via Obj introspection. This is fragile — it breaks the
moment a domain stores a boxed integer or a custom block. The right fix is
a typed value representation in Conventions. *)
(* TODO: Generator.Error is silently treated as end-of-stream here, hiding
real failures from the client. *)
let materialize_generator gen limit =
let rec go gen pos acc count =
if count >= limit then (List.rev acc, true)
else
match gen (Some pos) with
| Generator.Done -> (List.rev acc, false)
| Generator.Error _ -> (List.rev acc, false)
| Generator.Value (t, next) ->
let mat = match t with
| Tuple.Materialized m -> Some m
| Tuple.NonMaterialized _ -> None
in
(match mat with
| None -> go next (pos + 1) acc count
| Some m -> go next (pos + 1) (m :: acc) (count + 1))
in
go gen 0 [] 0
let materialize_relation storage (rel : Relation.t) limit =
let gen = Algebra.Memory.to_generator storage rel in
materialize_generator gen limit
let short_hash (h : string) = String.sub h 0 (min 8 (String.length h))
module BranchOps = Management.Branch.Make(Management.Physical.Memory)
let get_branch storage =
match BranchOps.get_head storage with
| Ok (Some name) -> name
| _ -> "--"
let tuple_to_sexp (t : Tuple.materialized) =
let open Sexplib.Sexp in
List (Tuple.AttributeMap.bindings t.Tuple.attributes
|> List.map (fun (k, attr) ->
List [Atom k; Conventions.AbstractValue.sexp_of_t attr.Attribute.value]))
let relation_to_sexp storage db_name db_hash (rel : Relation.t) limit =
let open Sexplib.Sexp in
let schema_sexp =
List (List.map (fun (a, d) -> List [Atom a; Atom d]) rel.Relation.schema)
in
let (tuples, truncated) = materialize_relation storage rel limit in
let rows_sexp = List (List.map tuple_to_sexp tuples) in
to_string @@ List [
Atom "relation";
List [Atom "name"; Atom rel.Relation.name];
List [Atom "schema"; schema_sexp];
List [Atom "rows"; rows_sexp];
List [Atom "row_count"; Atom (string_of_int (List.length tuples))];
List [Atom "truncated"; Atom (string_of_bool truncated)];
List [Atom "db_hash"; Atom (short_hash db_hash)];
List [Atom "db_name"; Atom db_name];
List [Atom "branch"; Atom (get_branch storage)];
]
let ok_response storage db_name db_hash msg =
let open Sexplib.Sexp in
to_string @@ List [
Atom "ok";
List [Atom "message"; Atom msg];
List [Atom "db_hash"; Atom (short_hash db_hash)];
List [Atom "db_name"; Atom db_name];
List [Atom "branch"; Atom (get_branch storage)];
]
let error_response storage db_name db_hash msg =
let open Sexplib.Sexp in
to_string @@ List [
Atom "error";
List [Atom "message"; Atom msg];
List [Atom "db_hash"; Atom (short_hash db_hash)];
List [Atom "db_name"; Atom db_name];
List [Atom "branch"; Atom (get_branch storage)];
]
let manip_err = function
| Manipulation.RelationNotFound s -> "RelationNotFound: " ^ s
| Manipulation.RelationAlreadyExists s -> "RelationAlreadyExists: " ^ s
| Manipulation.TupleNotFound h -> "TupleNotFound: " ^ h
| Manipulation.DuplicateTuple h -> "DuplicateTuple: " ^ h
| Manipulation.ConstraintViolation s -> "ConstraintViolation: " ^ s
| Manipulation.StorageError s -> "StorageError: " ^ s
(* TODO: language dispatch by trying parsers in sequence is a code smell —
a valid DRL expression that happens to also parse as DML would silently
be treated as DRL. The three sublanguages should share a common envelope,
e.g. a top-level tag distinguishing (Query ...) from (Exec ...). *)
let advance_head_branch storage new_hash =
match BranchOps.get_head storage with
| Ok (Some branch_name) ->
ignore (BranchOps.update_tip storage ~name:branch_name ~tip:new_hash)
| _ -> ()
let execute_command storage db_ref cmd =
let db = !db_ref in
let h = db.Management.Database.hash in
let name = db.Management.Database.name in
let ok = ok_response storage name in
let err = error_response storage name in
(* TODO: (schema) is a stopgap. Introspection should be expressible in
DRL itself via the catalog relations, not special-cased here. *)
let cmd = match String.trim cmd with
| "(schema)" -> {|(Base sakura:attribute)|}
| s -> s
in
match Drl.Parser.of_string cmd with
| Ok query ->
(match Drl.Executor.Memory.execute storage db query with
| Ok rel -> relation_to_sexp storage name h rel default_limit
| Error (Drl.Executor.Memory.RelationNotFound s) ->
err h ("RelationNotFound: " ^ s)
| Error (Drl.Executor.Memory.AlgebraError (Algebra.StorageError s)) ->
err h ("StorageError: " ^ s)
| Error (Drl.Executor.Memory.AlgebraError (Algebra.GeneratorError s)) ->
err h ("GeneratorError: " ^ s))
| Error _ ->
match Dml.Parser.of_string cmd with
| Ok stmt ->
(match Dml.Executor.Memory.execute storage db stmt with
| Ok new_db ->
db_ref := new_db;
advance_head_branch storage new_db.Management.Database.hash;
ok new_db.Management.Database.hash "updated"
| Error (Dml.Executor.Memory.ManipulationError me) ->
err h (manip_err me)
| Error (Dml.Executor.Memory.RelationNotFound s) ->
err h ("RelationNotFound: " ^ s)
| Error (Dml.Executor.Memory.ParseError s) ->
err h ("ParseError: " ^ s))
| Error _ ->
match Icl.Parser.of_string cmd with
| Ok stmt ->
(match Icl.Executor.Memory.execute storage db stmt with
| Ok (new_db, msg) ->
db_ref := new_db;
advance_head_branch storage new_db.Management.Database.hash;
ok new_db.Management.Database.hash msg
| Error (Icl.Executor.Memory.ManipulationError me) ->
err h (manip_err me)
| Error (Icl.Executor.Memory.ConversionError s) ->
err h ("ConversionError: " ^ s))
| Error _ ->
match Dcl.Parser.of_string cmd with
| Ok stmt ->
(match Dcl.Executor.Memory.execute storage db stmt with
| Ok (new_db, msg) ->
db_ref := new_db;
advance_head_branch storage new_db.Management.Database.hash;
ok new_db.Management.Database.hash msg
| Error (Dcl.Executor.Memory.BranchError s) ->
err h ("BranchError: " ^ s)
| Error (Dcl.Executor.Memory.MergeError s) ->
err h ("MergeError: " ^ s))
| Error _ ->
err h "ParseError: not valid DRL, DML, ICL, or DCL"
(* TODO: registration failures are silently ignored; a broken prelude
relation leaves the catalog in a partially-seeded state with no
indication to the user. *)
let register_prelude_relations storage db =
let open Prelude.Standard in
List.fold_left
(fun db (rel : Relation.t) ->
match Manipulation.Memory.create_immutable_relation storage db
~name:rel.name
~schema:rel.schema
~generator:(Option.get rel.generator)
~membership_criteria:rel.membership_criteria
~cardinality:rel.cardinality
with
| Ok (new_db, _) -> new_db
| Error e ->
Printf.eprintf "Warning: failed to register prelude relation %s: %s\n%!"
rel.name (manip_err e);
db)
db
[ less_than_natural
; less_than_or_equal_natural
; greater_than_natural
; greater_than_or_equal_natural
; equal_natural
; not_equal_natural
; plus_natural
; times_natural
; minus_natural
; divide_natural
]
(* TODO: single-threaded accept loop — one slow or hung client blocks all
others. Should use threads or non-blocking I/O. *)
let handle_client storage db_ref fd =
let ic = Unix.in_channel_of_descr fd in
let oc = Unix.out_channel_of_descr fd in
(try
while true do
let line = input_line ic in
let line = String.trim line in
if line <> "" then begin
let response =
try execute_command storage db_ref line
with e ->
let db = !db_ref in
error_response storage db.Management.Database.name
db.Management.Database.hash
("Uncaught error: " ^ Printexc.to_string e)
in
output_string oc (response ^ "\n");
flush oc
end
done
with End_of_file | Unix.Unix_error _ -> ())
let depart_emp = [
"(CreateRelation (name \"Department\") (schema ((dept_id \"integer\") (dept_name \"string\") (location \"string\"))))";
"(CreateRelation (name \"Employee\") (schema ((emp_id \"integer\") (emp_name \"string\") (salary \"float\") (dept_id \"integer\") (hire_date \"string\"))))";
"(RegisterConstraint(constraint_name \"salary_positive\")(relation_name \"Employee\")(body (MemberOf(target \"positive_reals\")(binding ((salary (Var \"salary\")))))))";
"(RegisterConstraint
(constraint_name \"fk_employee_dept\")
(relation_name \"Employee\")
(body (MemberOf
(target \"Department\")
(binding ((dept_id (Var \"dept_id\")))))))";
"(InsertTuple (relation \"Department\") (attributes ((dept_id (Int 1)) (location (Str \"Gifu\")) (dept_name (Str \"Nippon Ichi\")))))";
"(InsertTuples (relation \"Employee\") (tuples (((emp_id (Int 101)) (emp_name (Str \"Alice Johnson\")) (salary (Float 95000.0)) (dept_id (Int 1)) (hire_date (Str \"2020-01-15\"))))))"
]
let _depart_emp () =
match Management.Physical.Memory.create () with
| Error _ -> failwith "Failed to create storage"
| Ok storage ->
match Manipulation.Memory.create_database storage ~name:"sakura" with
| Error _ -> failwith "Failed to create initial database"
| Ok db ->
let db = register_prelude_relations storage db in
let db_ref = ref db in
Printf.printf "Database hash: %s\n%!" (short_hash db.Management.Database.hash);
List.iter (fun cmd -> print_endline @@ execute_command storage db_ref cmd)
depart_emp;
()
let n_way = [
"(CreateRelation
(name \"Building\")
(schema
((building_id \"integer\")
(building_name \"string\")
(floors \"integer\"))))";
"(CreateRelation
(name \"Room\")
(schema
((room_id \"integer\")
(building_id \"integer\")
(floor \"integer\")
(room_number \"string\"))))";
"(CreateRelation
(name \"Suite\")
(schema
((suite_id \"integer\")
(room_id \"integer\")
(suite_name \"string\")
(capacity \"integer\"))))";
(* FK: every Room must belong to an existing Building *)
"(RegisterConstraint
(constraint_name \"fk_room_building\")
(relation_name \"Room\")
(body (MemberOf
(target \"Building\")
(binding ((building_id (Var \"building_id\")))))))";
(* FK: every Suite must belong to an existing Room *)
"(RegisterConstraint
(constraint_name \"fk_suite_room\")
(relation_name \"Suite\")
(body (MemberOf
(target \"Room\")
(binding ((room_id (Var \"room_id\")))))))";
(* A suite is only valid if its room belongs to a building with more than 3 floors *)
"(RegisterConstraint
(constraint_name \"suite_in_tall_building\")
(relation_name \"Suite\")
(body
(Exists (variable \"r\") (quantifier \"Room\")
(body
(Exists (variable \"b\") (quantifier \"Building\")
(body
(And
((MemberOf (target \"Room\")
(binding ((room_id (Var \"room_id\")))))
(MemberOf (target \"Building\")
(binding ((building_id (Var \"r.building_id\")))))
(MemberOf (target \"greater_than_natural\")
(binding ((left (Var \"b.floors\")) (right (Const (Int 3))))))))))))))";
"(InsertTuple
(relation \"Building\")
(attributes
((building_id (Int 2))
(building_name (Str \"Tower B\"))
(floors (Int 2)))))";
"(InsertTuple
(relation \"Building\")
(attributes
((building_id (Int 1))
(building_name (Str \"Tower A\"))
(floors (Int 10)))))";
"(InsertTuples
(relation \"Room\")
(tuples
(((room_id (Int 101)) (building_id (Int 1)) (floor (Int 1)) (room_number (Str \"1A\")))
((room_id (Int 102)) (building_id (Int 1)) (floor (Int 2)) (room_number (Str \"2A\")))
((room_id (Int 201)) (building_id (Int 2)) (floor (Int 1)) (room_number (Str \"1B\"))))))";
"(InsertTuples
(relation \"Suite\")
(tuples
(((suite_id (Int 1001)) (room_id (Int 101)) (suite_name (Str \"Presidential\")) (capacity (Int 4)))
((suite_id (Int 1002)) (room_id (Int 101)) (suite_name (Str \"Standard\")) (capacity (Int 2)))
((suite_id (Int 1003)) (room_id (Int 102)) (suite_name (Str \"Deluxe\")) (capacity (Int 3))))))";
]
let _n_way () =
match Management.Physical.Memory.create () with
| Error _ -> failwith "Failed to create storage"
| Ok storage ->
match Manipulation.Memory.create_database storage ~name:"sakura" with
| Error _ -> failwith "Failed to create initial database"
| Ok db ->
let db = register_prelude_relations storage db in
let db_ref = ref db in
Printf.printf "Database hash: %s\n%!" (short_hash db.Management.Database.hash);
List.iter (fun cmd -> print_endline @@ execute_command storage db_ref cmd)
n_way;
()
let () =
let port = default_port in
match Management.Physical.Memory.create () with
| Error _ -> failwith "Failed to create storage"
| Ok storage ->
match Manipulation.Memory.create_database storage ~name:"sakura" with
| Error _ -> failwith "Failed to create initial database"
| Ok db ->
let db = register_prelude_relations storage db in
(* Register ephemeral sakura:branch and sakura:head relations backed by
the raw branch registry — no stored tuples, no circularity. *)
let db =
let register db rel =
match Manipulation.Memory.create_immutable_relation storage db
~name:rel.Relation.name
~schema:rel.Relation.schema
~generator:(Option.get rel.Relation.generator)
~membership_criteria:rel.Relation.membership_criteria
~cardinality:rel.Relation.cardinality
with
| Ok (db, _) -> db
| Error e ->
Printf.eprintf "Warning: failed to register %s: %s\n%!"
rel.Relation.name (match e with
| Manipulation.RelationAlreadyExists s -> "already exists: " ^ s
| Manipulation.StorageError s -> s | _ -> "error");
db
in
let db = register db (BranchOps.branch_relation storage) in
let db = register db (BranchOps.head_relation storage) in
db
in
(* Create default master branch in raw registry and set HEAD *)
(match BranchOps.create storage ~name:"master"
~tip:db.Management.Database.hash with
| Error e -> Printf.eprintf "Warning: failed to create master branch: %s\n%!" e
| Ok () -> ());
(match BranchOps.checkout storage "master" with
| Error e -> Printf.eprintf "Warning: failed to checkout master: %s\n%!" e
| Ok () -> ());
let db_ref = ref db in
let sock = Unix.socket Unix.PF_INET Unix.SOCK_STREAM 0 in
Unix.setsockopt sock Unix.SO_REUSEADDR true;
Unix.setsockopt sock Unix.SO_REUSEPORT true;
Unix.bind sock (Unix.ADDR_INET (Unix.inet_addr_loopback, port));
Unix.listen sock 5;
Printf.printf "Sakura server listening on 127.0.0.1:%d\n" port;
Printf.printf "Database hash: %s\n%!" (short_hash db.Management.Database.hash);
while true do
let (client_fd, _addr) = Unix.accept sock in
handle_client storage db_ref client_fd;
(try Unix.close client_fd with _ -> ())
done
|