rubydb 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (420) hide show
  1. checksums.yaml +4 -4
  2. data/.github/PULL_REQUEST_TEMPLATE.md +15 -15
  3. data/.github/workflows/benchmark.yml +26 -26
  4. data/.github/workflows/compatibility.yml +63 -63
  5. data/.github/workflows/fuzz.yml +33 -33
  6. data/.github/workflows/lint.yml +21 -21
  7. data/.github/workflows/operations.yml +24 -24
  8. data/.github/workflows/production-validation.yml +111 -111
  9. data/.github/workflows/release.yml +77 -77
  10. data/.github/workflows/security.yml +39 -37
  11. data/.github/workflows/test.yml +26 -26
  12. data/.github/workflows/workload.yml +58 -58
  13. data/.gitignore +12 -5
  14. data/.rubocop.yml +50 -44
  15. data/.standard.yml +9 -14
  16. data/ARCHITECTURE.md +21 -21
  17. data/CHANGELOG.md +43 -27
  18. data/CODE_OF_CONDUCT.md +13 -13
  19. data/CONTRIBUTING.md +29 -29
  20. data/GOVERNANCE.md +16 -16
  21. data/Gemfile +18 -17
  22. data/Gemfile.lock +125 -71
  23. data/README.md +249 -162
  24. data/ROADMAP.md +27 -27
  25. data/Rakefile +71 -71
  26. data/SECURITY.md +54 -54
  27. data/SUPPORT.md +14 -14
  28. data/adapters/activerecord/Gemfile +11 -11
  29. data/adapters/activerecord/lib/active_record/connection_adapters/rubydb_adapter.rb +873 -879
  30. data/adapters/activerecord/rubydb-activerecord.gemspec +20 -20
  31. data/adapters/activerecord/spec/rubydb_adapter_integration_spec.rb +143 -143
  32. data/adapters/ruby/README.md +18 -18
  33. data/adapters/sequel/README.md +11 -11
  34. data/config/monitoring/prometheus-alerts.yml +39 -39
  35. data/config/production.yml +36 -36
  36. data/docs/README.md +75 -71
  37. data/docs/architecture/concurrency.md +14 -14
  38. data/docs/architecture/current-state.md +125 -125
  39. data/docs/architecture/execution-engine.md +25 -25
  40. data/docs/architecture/indexes.md +19 -19
  41. data/docs/architecture/mvcc.md +19 -19
  42. data/docs/architecture/overview.md +13 -13
  43. data/docs/architecture/pages.md +11 -11
  44. data/docs/architecture/production-roadmap.md +82 -82
  45. data/docs/architecture/query-planner.md +20 -20
  46. data/docs/architecture/recovery.md +18 -18
  47. data/docs/architecture/sql-engine.md +12 -12
  48. data/docs/architecture/storage-engine.md +14 -14
  49. data/docs/architecture/transactions.md +10 -10
  50. data/docs/architecture/wal.md +28 -28
  51. data/docs/cli-cheatsheet.md +98 -98
  52. data/docs/cli.md +275 -275
  53. data/docs/contributing/architecture.md +9 -9
  54. data/docs/contributing/benchmarking.md +14 -14
  55. data/docs/contributing/development.md +16 -16
  56. data/docs/contributing/release-process.md +49 -49
  57. data/docs/contributing/testing.md +16 -16
  58. data/docs/debugging.md +229 -229
  59. data/docs/developer/branching.md +10 -10
  60. data/docs/developer/database-diff.md +10 -10
  61. data/docs/developer/local-development.md +17 -17
  62. data/docs/developer/snapshots.md +9 -9
  63. data/docs/developer/temporal-data.md +10 -10
  64. data/docs/developer-guide.md +297 -297
  65. data/docs/getting-started/first-database.md +16 -16
  66. data/docs/getting-started/first-query.md +13 -13
  67. data/docs/getting-started/installation.md +19 -19
  68. data/docs/getting-started/local-to-production.md +300 -300
  69. data/docs/getting-started/quickstart.md +17 -17
  70. data/docs/getting-started/rails.md +16 -16
  71. data/docs/hardening_backlog.md +93 -93
  72. data/docs/lessons-learned.md +112 -112
  73. data/docs/operations/backups.md +33 -33
  74. data/docs/operations/disaster-recovery.md +31 -31
  75. data/docs/operations/failover.md +30 -30
  76. data/docs/operations/monitoring.md +25 -25
  77. data/docs/operations/production-guide.md +295 -295
  78. data/docs/operations/production-runbook.md +45 -45
  79. data/docs/operations/replication.md +33 -33
  80. data/docs/operations/restore.md +6 -6
  81. data/docs/operations/runbook.md +34 -34
  82. data/docs/operations/upgrades.md +14 -14
  83. data/docs/operations/workload-testing.md +17 -17
  84. data/docs/production-readiness.md +118 -118
  85. data/docs/production_validation.md +150 -150
  86. data/docs/rails/active-record.md +11 -11
  87. data/docs/rails/compatibility-guide.md +90 -90
  88. data/docs/rails/database-yml.md +92 -92
  89. data/docs/rails/installation.md +17 -17
  90. data/docs/rails/migrations.md +17 -17
  91. data/docs/rails/production.md +82 -82
  92. data/docs/rails/troubleshooting.md +18 -18
  93. data/docs/release.md +25 -25
  94. data/docs/server/architecture.md +10 -10
  95. data/docs/server/authentication.md +10 -10
  96. data/docs/server/configuration.md +16 -16
  97. data/docs/server/connection-pooling.md +10 -10
  98. data/docs/server/deployment.md +10 -10
  99. data/docs/server/protocol.md +12 -12
  100. data/docs/sql/compatibility-guide.md +82 -82
  101. data/docs/sql/compatibility.md +39 -39
  102. data/docs/sql/data-types.md +10 -10
  103. data/docs/sql/functions.md +9 -9
  104. data/docs/sql/joins.md +9 -9
  105. data/docs/sql/operators.md +9 -9
  106. data/docs/sql/sqlite-compatibility.md +21 -21
  107. data/docs/sql/syntax.md +10 -10
  108. data/docs/sql/transactions.md +10 -10
  109. data/docs/troubleshooting.md +244 -244
  110. data/lessons/01-foundations.md +73 -0
  111. data/lessons/02-local-development.md +121 -0
  112. data/lessons/03-embedded-rubydb.md +99 -0
  113. data/lessons/04-rails-complex-apps.md +138 -0
  114. data/lessons/05-rubydb-production-server.md +237 -0
  115. data/lessons/06-postgresql-massive-apps.md +96 -0
  116. data/lessons/07-hybrid-microservices.md +94 -0
  117. data/lessons/08-migrations-backups-recovery.md +86 -0
  118. data/lessons/09-observability-security-scale.md +87 -0
  119. data/lessons/10-release-readiness.md +125 -0
  120. data/lib/rubydb/backup/archive.rb +332 -334
  121. data/lib/rubydb/backup/backup.rb +400 -401
  122. data/lib/rubydb/backup/incremental.rb +349 -353
  123. data/lib/rubydb/backup/restore.rb +289 -290
  124. data/lib/rubydb/backup/snapshot.rb +265 -267
  125. data/lib/rubydb/backup/verification.rb +276 -279
  126. data/lib/rubydb/branching/branch.rb +181 -181
  127. data/lib/rubydb/branching/branch_manager.rb +307 -311
  128. data/lib/rubydb/branching/branch_metadata.rb +140 -140
  129. data/lib/rubydb/branching/checkout.rb +165 -166
  130. data/lib/rubydb/branching/copy_on_write.rb +272 -272
  131. data/lib/rubydb/branching/diff.rb +137 -138
  132. data/lib/rubydb/branching/merge.rb +282 -285
  133. data/lib/rubydb/build_info.rb +15 -15
  134. data/lib/rubydb/catalog/catalog.rb +391 -391
  135. data/lib/rubydb/catalog/column.rb +112 -112
  136. data/lib/rubydb/catalog/constraint.rb +180 -180
  137. data/lib/rubydb/catalog/database.rb +184 -184
  138. data/lib/rubydb/catalog/index.rb +97 -97
  139. data/lib/rubydb/catalog/schema.rb +103 -103
  140. data/lib/rubydb/catalog/sequence.rb +90 -90
  141. data/lib/rubydb/catalog/system_catalog.rb +698 -698
  142. data/lib/rubydb/catalog/table.rb +178 -178
  143. data/lib/rubydb/catalog/trigger.rb +102 -102
  144. data/lib/rubydb/catalog/view.rb +66 -66
  145. data/lib/rubydb/cli/application.rb +163 -163
  146. data/lib/rubydb/cli/commands/backup.rb +80 -81
  147. data/lib/rubydb/cli/commands/branch.rb +72 -72
  148. data/lib/rubydb/cli/commands/checkout.rb +54 -54
  149. data/lib/rubydb/cli/commands/create.rb +58 -58
  150. data/lib/rubydb/cli/commands/diff.rb +76 -77
  151. data/lib/rubydb/cli/commands/doctor.rb +74 -74
  152. data/lib/rubydb/cli/commands/drop.rb +57 -57
  153. data/lib/rubydb/cli/commands/init.rb +101 -102
  154. data/lib/rubydb/cli/commands/inspect.rb +95 -95
  155. data/lib/rubydb/cli/commands/merge.rb +63 -63
  156. data/lib/rubydb/cli/commands/migrate.rb +62 -62
  157. data/lib/rubydb/cli/commands/restart.rb +42 -39
  158. data/lib/rubydb/cli/commands/restore.rb +121 -121
  159. data/lib/rubydb/cli/commands/shell.rb +365 -365
  160. data/lib/rubydb/cli/commands/snapshot.rb +79 -79
  161. data/lib/rubydb/cli/commands/start.rb +88 -82
  162. data/lib/rubydb/cli/commands/status.rb +96 -92
  163. data/lib/rubydb/cli/commands/stop.rb +47 -47
  164. data/lib/rubydb/cli/commands/vacuum.rb +58 -58
  165. data/lib/rubydb/cli/formatter.rb +221 -221
  166. data/lib/rubydb/cli/output.rb +168 -168
  167. data/lib/rubydb/client/client.rb +302 -304
  168. data/lib/rubydb/client/connection.rb +414 -415
  169. data/lib/rubydb/client/connection_pool.rb +168 -168
  170. data/lib/rubydb/client/connection_url.rb +96 -96
  171. data/lib/rubydb/client/prepared_statement.rb +60 -60
  172. data/lib/rubydb/client/result.rb +123 -123
  173. data/lib/rubydb/client/statement.rb +52 -52
  174. data/lib/rubydb/client/transaction.rb +130 -130
  175. data/lib/rubydb/concurrency/concurrency.rb +19 -19
  176. data/lib/rubydb/concurrency/deadlock_detector.rb +148 -150
  177. data/lib/rubydb/concurrency/latch.rb +101 -101
  178. data/lib/rubydb/concurrency/lock_graph.rb +163 -165
  179. data/lib/rubydb/concurrency/mutex.rb +181 -183
  180. data/lib/rubydb/concurrency/rw_lock.rb +180 -180
  181. data/lib/rubydb/concurrency/scheduler.rb +248 -250
  182. data/lib/rubydb/concurrency/worker_pool.rb +145 -143
  183. data/lib/rubydb/configuration/config.rb +170 -170
  184. data/lib/rubydb/configuration/defaults.rb +179 -179
  185. data/lib/rubydb/configuration/environment.rb +152 -152
  186. data/lib/rubydb/configuration/parser.rb +185 -185
  187. data/lib/rubydb/configuration/validation.rb +221 -221
  188. data/lib/rubydb/constants.rb +74 -74
  189. data/lib/rubydb/constraints/check.rb +181 -181
  190. data/lib/rubydb/constraints/constraint.rb +101 -101
  191. data/lib/rubydb/constraints/foreign_key.rb +130 -130
  192. data/lib/rubydb/constraints/not_null.rb +64 -64
  193. data/lib/rubydb/constraints/primary_key.rb +99 -99
  194. data/lib/rubydb/constraints/unique.rb +106 -108
  195. data/lib/rubydb/constraints/validator.rb +349 -350
  196. data/lib/rubydb/errors/authentication_error.rb +10 -10
  197. data/lib/rubydb/errors/authorization_error.rb +23 -23
  198. data/lib/rubydb/errors/client_error.rb +10 -10
  199. data/lib/rubydb/errors/configuration_error.rb +10 -10
  200. data/lib/rubydb/errors/connection_error.rb +10 -10
  201. data/lib/rubydb/errors/constraint_error.rb +23 -23
  202. data/lib/rubydb/errors/corruption_error.rb +10 -10
  203. data/lib/rubydb/errors/database_error.rb +10 -10
  204. data/lib/rubydb/errors/error.rb +20 -20
  205. data/lib/rubydb/errors/execution_error.rb +10 -10
  206. data/lib/rubydb/errors/parser_error.rb +10 -10
  207. data/lib/rubydb/errors/recovery_error.rb +10 -10
  208. data/lib/rubydb/errors/replication_error.rb +10 -10
  209. data/lib/rubydb/errors/server_error.rb +6 -6
  210. data/lib/rubydb/errors/storage_error.rb +10 -10
  211. data/lib/rubydb/errors/transaction_error.rb +10 -10
  212. data/lib/rubydb/execution/aggregate_executor.rb +134 -138
  213. data/lib/rubydb/execution/delete_executor.rb +110 -112
  214. data/lib/rubydb/execution/distinct_executor.rb +131 -135
  215. data/lib/rubydb/execution/executor.rb +1182 -1188
  216. data/lib/rubydb/execution/expression.rb +191 -193
  217. data/lib/rubydb/execution/index_scan.rb +142 -142
  218. data/lib/rubydb/execution/insert_executor.rb +215 -217
  219. data/lib/rubydb/execution/join_executor.rb +243 -249
  220. data/lib/rubydb/execution/limit_executor.rb +83 -85
  221. data/lib/rubydb/execution/optimizer.rb +227 -215
  222. data/lib/rubydb/execution/plan.rb +355 -353
  223. data/lib/rubydb/execution/planner.rb +542 -536
  224. data/lib/rubydb/execution/predicate.rb +235 -235
  225. data/lib/rubydb/execution/scan.rb +49 -49
  226. data/lib/rubydb/execution/sequential_scan.rb +63 -63
  227. data/lib/rubydb/execution/sort_executor.rb +180 -185
  228. data/lib/rubydb/execution/update_executor.rb +160 -162
  229. data/lib/rubydb/functions/aggregate.rb +70 -70
  230. data/lib/rubydb/functions/date_functions.rb +274 -278
  231. data/lib/rubydb/functions/function.rb +85 -85
  232. data/lib/rubydb/functions/json_functions.rb +231 -215
  233. data/lib/rubydb/functions/numeric_functions.rb +346 -346
  234. data/lib/rubydb/functions/scalar.rb +52 -52
  235. data/lib/rubydb/functions/string_functions.rb +383 -383
  236. data/lib/rubydb/functions/system_functions.rb +258 -246
  237. data/lib/rubydb/history/as_of.rb +238 -238
  238. data/lib/rubydb/history/change.rb +105 -105
  239. data/lib/rubydb/history/history.rb +131 -131
  240. data/lib/rubydb/history/history_manager.rb +228 -229
  241. data/lib/rubydb/history/temporal_query.rb +202 -202
  242. data/lib/rubydb/history/timeline.rb +144 -144
  243. data/lib/rubydb/indexes/btree.rb +186 -186
  244. data/lib/rubydb/indexes/btree_cursor.rb +258 -258
  245. data/lib/rubydb/indexes/btree_node.rb +384 -385
  246. data/lib/rubydb/indexes/hash_index.rb +150 -150
  247. data/lib/rubydb/indexes/index.rb +71 -71
  248. data/lib/rubydb/indexes/index_manager.rb +408 -406
  249. data/lib/rubydb/indexes/index_scan.rb +466 -470
  250. data/lib/rubydb/migrations/migration.rb +253 -254
  251. data/lib/rubydb/migrations/migration_lock.rb +146 -146
  252. data/lib/rubydb/migrations/migration_manager.rb +187 -176
  253. data/lib/rubydb/migrations/migration_version.rb +71 -71
  254. data/lib/rubydb/migrations/schema_diff.rb +211 -211
  255. data/lib/rubydb/migrations/schema_version.rb +64 -64
  256. data/lib/rubydb/monitoring/events.rb +155 -160
  257. data/lib/rubydb/monitoring/health.rb +216 -222
  258. data/lib/rubydb/monitoring/logger.rb +188 -193
  259. data/lib/rubydb/monitoring/metrics.rb +363 -359
  260. data/lib/rubydb/monitoring/performance.rb +176 -176
  261. data/lib/rubydb/monitoring/statistics.rb +168 -170
  262. data/lib/rubydb/mvcc/garbage_collector.rb +199 -199
  263. data/lib/rubydb/mvcc/mvcc.rb +16 -16
  264. data/lib/rubydb/mvcc/snapshot.rb +146 -147
  265. data/lib/rubydb/mvcc/vacuum.rb +180 -180
  266. data/lib/rubydb/mvcc/version.rb +106 -106
  267. data/lib/rubydb/mvcc/version_store.rb +396 -398
  268. data/lib/rubydb/mvcc/visibility.rb +107 -109
  269. data/lib/rubydb/protocol/capabilities.rb +125 -125
  270. data/lib/rubydb/protocol/decoder.rb +142 -145
  271. data/lib/rubydb/protocol/encoder.rb +131 -136
  272. data/lib/rubydb/protocol/handshake.rb +306 -305
  273. data/lib/rubydb/protocol/message.rb +121 -121
  274. data/lib/rubydb/protocol/parameter_binder.rb +101 -0
  275. data/lib/rubydb/protocol/protocol.rb +276 -277
  276. data/lib/rubydb/protocol/version.rb +54 -54
  277. data/lib/rubydb/rails/adapter.rb +245 -239
  278. data/lib/rubydb/rails/connection.rb +312 -314
  279. data/lib/rubydb/rails/database_statements.rb +122 -122
  280. data/lib/rubydb/rails/migration.rb +131 -131
  281. data/lib/rubydb/rails/quoting.rb +109 -109
  282. data/lib/rubydb/rails/result.rb +117 -117
  283. data/lib/rubydb/rails/schema_statements.rb +339 -339
  284. data/lib/rubydb/rails/transaction.rb +105 -105
  285. data/lib/rubydb/rails/type.rb +126 -126
  286. data/lib/rubydb/recovery/checkpoint.rb +261 -257
  287. data/lib/rubydb/recovery/consistency.rb +457 -467
  288. data/lib/rubydb/recovery/corruption_detector.rb +5 -5
  289. data/lib/rubydb/recovery/crash_recovery.rb +381 -387
  290. data/lib/rubydb/recovery/recovery_manager.rb +204 -206
  291. data/lib/rubydb/recovery/redo.rb +235 -237
  292. data/lib/rubydb/recovery/undo.rb +204 -206
  293. data/lib/rubydb/replication/failover.rb +5 -5
  294. data/lib/rubydb/replication/fencing.rb +63 -63
  295. data/lib/rubydb/replication/primary.rb +461 -450
  296. data/lib/rubydb/replication/replica.rb +382 -384
  297. data/lib/rubydb/replication/replication_log.rb +194 -200
  298. data/lib/rubydb/replication/replication_manager.rb +307 -308
  299. data/lib/rubydb/replication/replication_slot.rb +293 -295
  300. data/lib/rubydb/replication/replication_stream.rb +198 -201
  301. data/lib/rubydb/rubydb.rb +564 -560
  302. data/lib/rubydb/security/access_control.rb +252 -254
  303. data/lib/rubydb/security/audit_log.rb +209 -213
  304. data/lib/rubydb/security/authentication.rb +302 -302
  305. data/lib/rubydb/security/authorization.rb +282 -282
  306. data/lib/rubydb/security/credentials.rb +192 -196
  307. data/lib/rubydb/security/password.rb +205 -215
  308. data/lib/rubydb/security/permissions.rb +74 -74
  309. data/lib/rubydb/security/role.rb +99 -101
  310. data/lib/rubydb/security/user.rb +86 -86
  311. data/lib/rubydb/server/connection.rb +383 -366
  312. data/lib/rubydb/server/connection_pool.rb +193 -193
  313. data/lib/rubydb/server/lifecycle.rb +227 -228
  314. data/lib/rubydb/server/listener.rb +139 -136
  315. data/lib/rubydb/server/request_handler.rb +277 -276
  316. data/lib/rubydb/server/server.rb +363 -364
  317. data/lib/rubydb/server/session.rb +371 -369
  318. data/lib/rubydb/server/worker.rb +206 -210
  319. data/lib/rubydb/server/worker_pool.rb +168 -168
  320. data/lib/rubydb/sql/ast/alter_table.rb +169 -169
  321. data/lib/rubydb/sql/ast/begin_transaction.rb +47 -47
  322. data/lib/rubydb/sql/ast/commit.rb +37 -37
  323. data/lib/rubydb/sql/ast/constraint.rb +92 -83
  324. data/lib/rubydb/sql/ast/create_database.rb +41 -41
  325. data/lib/rubydb/sql/ast/create_index.rb +61 -61
  326. data/lib/rubydb/sql/ast/create_schema.rb +52 -52
  327. data/lib/rubydb/sql/ast/create_table.rb +187 -187
  328. data/lib/rubydb/sql/ast/delete.rb +54 -54
  329. data/lib/rubydb/sql/ast/drop_database.rb +41 -41
  330. data/lib/rubydb/sql/ast/drop_index.rb +41 -41
  331. data/lib/rubydb/sql/ast/drop_schema.rb +49 -49
  332. data/lib/rubydb/sql/ast/drop_table.rb +49 -49
  333. data/lib/rubydb/sql/ast/explain.rb +64 -64
  334. data/lib/rubydb/sql/ast/expression.rb +617 -604
  335. data/lib/rubydb/sql/ast/insert.rb +66 -66
  336. data/lib/rubydb/sql/ast/node.rb +42 -42
  337. data/lib/rubydb/sql/ast/rollback.rb +63 -63
  338. data/lib/rubydb/sql/ast/savepoint.rb +59 -59
  339. data/lib/rubydb/sql/ast/select.rb +88 -88
  340. data/lib/rubydb/sql/ast/set_operation.rb +22 -20
  341. data/lib/rubydb/sql/ast/trigger.rb +35 -29
  342. data/lib/rubydb/sql/ast/update.rb +88 -88
  343. data/lib/rubydb/sql/ast/vacuum.rb +19 -19
  344. data/lib/rubydb/sql/ast/view.rb +38 -32
  345. data/lib/rubydb/sql/ast/with.rb +32 -32
  346. data/lib/rubydb/sql/grammar.rb +86 -86
  347. data/lib/rubydb/sql/keywords.rb +156 -156
  348. data/lib/rubydb/sql/lexer.rb +209 -214
  349. data/lib/rubydb/sql/operators.rb +100 -100
  350. data/lib/rubydb/sql/parser.rb +1167 -1170
  351. data/lib/rubydb/sql/planner/analyzer.rb +283 -302
  352. data/lib/rubydb/sql/planner/binder.rb +537 -550
  353. data/lib/rubydb/sql/planner/type_checker.rb +427 -431
  354. data/lib/rubydb/sql/token.rb +210 -210
  355. data/lib/rubydb/storage/buffer_frame.rb +44 -44
  356. data/lib/rubydb/storage/buffer_pool.rb +155 -155
  357. data/lib/rubydb/storage/database_lock.rb +74 -74
  358. data/lib/rubydb/storage/deserializer.rb +332 -342
  359. data/lib/rubydb/storage/engine.rb +2347 -2330
  360. data/lib/rubydb/storage/file_manager.rb +191 -187
  361. data/lib/rubydb/storage/free_space_map.rb +79 -81
  362. data/lib/rubydb/storage/page.rb +92 -94
  363. data/lib/rubydb/storage/page_allocator.rb +852 -855
  364. data/lib/rubydb/storage/page_header.rb +63 -67
  365. data/lib/rubydb/storage/page_manager.rb +127 -131
  366. data/lib/rubydb/storage/record.rb +58 -58
  367. data/lib/rubydb/storage/row.rb +78 -78
  368. data/lib/rubydb/storage/serializer.rb +51 -51
  369. data/lib/rubydb/storage/storage_layout.rb +151 -151
  370. data/lib/rubydb/storage/storage_manager.rb +114 -114
  371. data/lib/rubydb/storage/tuple.rb +458 -461
  372. data/lib/rubydb/storage/visibility_map.rb +964 -973
  373. data/lib/rubydb/transactions/commit_manager.rb +219 -220
  374. data/lib/rubydb/transactions/isolation.rb +98 -98
  375. data/lib/rubydb/transactions/lock.rb +76 -76
  376. data/lib/rubydb/transactions/lock_manager.rb +359 -362
  377. data/lib/rubydb/transactions/savepoint.rb +142 -143
  378. data/lib/rubydb/transactions/transaction.rb +214 -215
  379. data/lib/rubydb/transactions/transaction_id.rb +84 -84
  380. data/lib/rubydb/transactions/transaction_log.rb +256 -257
  381. data/lib/rubydb/transactions/transaction_manager.rb +434 -435
  382. data/lib/rubydb/types/bigint.rb +36 -36
  383. data/lib/rubydb/types/blob.rb +37 -37
  384. data/lib/rubydb/types/boolean.rb +34 -34
  385. data/lib/rubydb/types/date.rb +39 -39
  386. data/lib/rubydb/types/decimal.rb +48 -48
  387. data/lib/rubydb/types/float.rb +34 -34
  388. data/lib/rubydb/types/integer.rb +36 -36
  389. data/lib/rubydb/types/json.rb +41 -41
  390. data/lib/rubydb/types/null.rb +34 -34
  391. data/lib/rubydb/types/smallint.rb +36 -36
  392. data/lib/rubydb/types/text.rb +37 -37
  393. data/lib/rubydb/types/time.rb +46 -46
  394. data/lib/rubydb/types/timestamp.rb +39 -39
  395. data/lib/rubydb/types/type.rb +119 -119
  396. data/lib/rubydb/types/uuid.rb +47 -47
  397. data/lib/rubydb/types/varchar.rb +37 -37
  398. data/lib/rubydb/version.rb +32 -32
  399. data/lib/rubydb/wal/archive.rb +190 -193
  400. data/lib/rubydb/wal/checkpoint.rb +181 -183
  401. data/lib/rubydb/wal/lsn.rb +94 -94
  402. data/lib/rubydb/wal/reader.rb +259 -260
  403. data/lib/rubydb/wal/record.rb +105 -105
  404. data/lib/rubydb/wal/segment.rb +193 -193
  405. data/lib/rubydb/wal/wal.rb +480 -452
  406. data/lib/rubydb/wal/writer.rb +236 -236
  407. data/lib/rubydb.rb +7 -7
  408. data/packaging/docker/docker-compose.failover.yml +43 -43
  409. data/packaging/homebrew/rubydb.rb +19 -19
  410. data/rubydb.gemspec +60 -57
  411. data/scripts/benchmark +7 -7
  412. data/scripts/durability_drill +37 -37
  413. data/scripts/fuzz +63 -63
  414. data/scripts/release +45 -40
  415. data/scripts/release_check +43 -43
  416. data/scripts/replication_failover_drill +268 -250
  417. data/scripts/replication_network_failover_drill +287 -255
  418. data/scripts/restore_drill +45 -45
  419. data/scripts/security +45 -0
  420. metadata +54 -1
@@ -1,302 +1,283 @@
1
- # frozen_string_literal: true
2
-
3
- module RubyDB
4
- module SQL
5
- module Planner
6
- # Analyzer - Performs semantic analysis and query rewriting
7
- class Analyzer
8
- attr_reader :errors, :warnings
9
-
10
- def initialize(catalog)
11
- @catalog = catalog
12
- @errors = []
13
- @warnings = []
14
- @binder = Binder.new(catalog)
15
- @type_checker = TypeChecker.new(catalog)
16
- end
17
-
18
- # Analyze a statement
19
- def analyze(statement)
20
- @errors = []
21
- @warnings = []
22
-
23
- # First pass: Bind identifiers
24
- bound_statement, bind_errors, bind_warnings = @binder.bind(statement)
25
- @errors.concat(bind_errors)
26
- @warnings.concat(bind_warnings)
27
-
28
- # Second pass: Type checking
29
- typed_statement, type_errors, type_warnings = @type_checker.check(bound_statement)
30
- @errors.concat(type_errors)
31
- @warnings.concat(type_warnings)
32
-
33
- # Third pass: Query rewriting (if no errors)
34
- if @errors.empty?
35
- rewritten_statement = rewrite(typed_statement)
36
- return [rewritten_statement, @errors, @warnings]
37
- end
38
-
39
- [typed_statement, @errors, @warnings]
40
- end
41
-
42
- # Perform query rewriting
43
- def rewrite(statement)
44
- # Rewrite '*' to explicit columns
45
- if statement.is_a?(AST::Select) && statement.has_star?
46
- statement = expand_star(statement)
47
- end
48
-
49
- # Normalize expressions
50
- statement = normalize_expressions(statement)
51
-
52
- # Remove redundant conditions
53
- statement = simplify_conditions(statement)
54
-
55
- statement
56
- end
57
-
58
- private
59
-
60
- def expand_star(select)
61
- table_info = @catalog.find_table(select.table_name)
62
- return select unless table_info
63
-
64
- # Replace star with all columns
65
- new_columns = table_info.columns.map do |col|
66
- expr = AST::Identifier.new(col.name, table: select.table_name)
67
- AST::SelectColumn.new(expr)
68
- end
69
-
70
- # Keep non-star columns
71
- non_star_columns = select.columns.reject { |c| c.expression.is_a?(AST::Star) }
72
-
73
- AST::Select.new(
74
- new_columns + non_star_columns,
75
- select.from,
76
- select.where,
77
- select.order_by,
78
- select.limit,
79
- select.offset,
80
- select.distinct
81
- )
82
- end
83
-
84
- def normalize_expressions(node)
85
- # Recursively normalize expression trees
86
- case node
87
- when AST::BinaryOp
88
- # Simplify constant expressions
89
- if node.left.is_a?(AST::Literal) && node.right.is_a?(AST::Literal)
90
- return evaluate_constant_expression(node)
91
- end
92
- node.left = normalize_expressions(node.left)
93
- node.right = normalize_expressions(node.right)
94
- node
95
-
96
- when AST::UnaryOp
97
- # Simplify constant unary expressions
98
- if node.operand.is_a?(AST::Literal)
99
- return evaluate_constant_unary(node)
100
- end
101
- node.operand = normalize_expressions(node.operand)
102
- node
103
-
104
- when AST::Between
105
- node.expression = normalize_expressions(node.expression)
106
- node.low = normalize_expressions(node.low)
107
- node.high = normalize_expressions(node.high)
108
- node
109
-
110
- when AST::In
111
- node.expression = normalize_expressions(node.expression)
112
- node.values = node.values.map { |v| normalize_expressions(v) }
113
- node
114
-
115
- when AST::IsNull
116
- node.expression = normalize_expressions(node.expression)
117
- node
118
-
119
- when AST::Select
120
- if node.where
121
- node.where = normalize_expressions(node.where)
122
- end
123
- if node.limit
124
- node.limit = normalize_expressions(node.limit)
125
- end
126
- if node.offset
127
- node.offset = normalize_expressions(node.offset)
128
- end
129
- node.order_by.each do |order_item|
130
- order_item.expression = normalize_expressions(order_item.expression)
131
- end
132
- node
133
-
134
- when AST::Insert
135
- node.values = node.values.map { |v| normalize_expressions(v) }
136
- node
137
-
138
- when AST::Update
139
- node.assignments.each do |assignment|
140
- assignment.value = normalize_expressions(assignment.value)
141
- end
142
- if node.where
143
- node.where = normalize_expressions(node.where)
144
- end
145
- node
146
-
147
- when AST::Delete
148
- if node.where
149
- node.where = normalize_expressions(node.where)
150
- end
151
- node
152
-
153
- else
154
- node
155
- end
156
- end
157
-
158
- def evaluate_constant_expression(expr)
159
- left_val = expr.left.value
160
- right_val = expr.right.value
161
-
162
- result = case expr.operator
163
- when Token::Type::PLUS
164
- left_val + right_val
165
- when Token::Type::MINUS
166
- left_val - right_val
167
- when Token::Type::STAR
168
- left_val * right_val
169
- when Token::Type::SLASH
170
- left_val / right_val if right_val != 0
171
- when Token::Type::PERCENT
172
- left_val % right_val if right_val != 0
173
- when Token::Type::EQ
174
- left_val == right_val
175
- when Token::Type::NE
176
- left_val != right_val
177
- when Token::Type::LT
178
- left_val < right_val
179
- when Token::Type::LTE
180
- left_val <= right_val
181
- when Token::Type::GT
182
- left_val > right_val
183
- when Token::Type::GTE
184
- left_val >= right_val
185
- else
186
- return expr
187
- end
188
-
189
- if result.nil?
190
- return AST::NullLiteral.new
191
- end
192
-
193
- token_type = result.is_a?(Integer) ? Token::Type::NUMBER : Token::Type::NUMBER
194
- AST::Literal.new(result, token_type)
195
- end
196
-
197
- def evaluate_constant_unary(expr)
198
- val = expr.operand.value
199
-
200
- result = case expr.operator
201
- when Token::Type::MINUS
202
- -val
203
- when Token::Type::PLUS
204
- +val
205
- when Token::Type::TILDE
206
- ~val if val.is_a?(Integer)
207
- else
208
- return expr
209
- end
210
-
211
- if result.nil?
212
- return AST::NullLiteral.new
213
- end
214
-
215
- token_type = result.is_a?(Integer) ? Token::Type::NUMBER : Token::Type::NUMBER
216
- AST::Literal.new(result, token_type)
217
- end
218
-
219
- def simplify_conditions(node)
220
- # Simplify WHERE conditions
221
- case node
222
- when AST::Select
223
- if node.where
224
- node.where = simplify_condition(node.where)
225
- end
226
- node
227
-
228
- when AST::Update
229
- if node.where
230
- node.where = simplify_condition(node.where)
231
- end
232
- node
233
-
234
- when AST::Delete
235
- if node.where
236
- node.where = simplify_condition(node.where)
237
- end
238
- node
239
-
240
- else
241
- node
242
- end
243
- end
244
-
245
- def simplify_condition(condition)
246
- case condition
247
- when AST::BinaryOp
248
- # Simplify AND/OR trees
249
- if condition.operator == Token::Type::AND
250
- left = simplify_condition(condition.left)
251
- right = simplify_condition(condition.right)
252
-
253
- # TRUE AND X => X
254
- if left.is_a?(AST::Literal) && left.value == true
255
- return right
256
- end
257
- # X AND TRUE => X
258
- if right.is_a?(AST::Literal) && right.value == true
259
- return left
260
- end
261
- # FALSE AND X => FALSE
262
- if left.is_a?(AST::Literal) && left.value == false
263
- return left
264
- end
265
- # X AND FALSE => FALSE
266
- if right.is_a?(AST::Literal) && right.value == false
267
- return right
268
- end
269
- end
270
-
271
- if condition.operator == Token::Type::OR
272
- left = simplify_condition(condition.left)
273
- right = simplify_condition(condition.right)
274
-
275
- # TRUE OR X => TRUE
276
- if left.is_a?(AST::Literal) && left.value == true
277
- return left
278
- end
279
- # X OR TRUE => TRUE
280
- if right.is_a?(AST::Literal) && right.value == true
281
- return right
282
- end
283
- # FALSE OR X => X
284
- if left.is_a?(AST::Literal) && left.value == false
285
- return right
286
- end
287
- # X OR FALSE => X
288
- if right.is_a?(AST::Literal) && right.value == false
289
- return left
290
- end
291
- end
292
-
293
- condition
294
-
295
- else
296
- condition
297
- end
298
- end
299
- end
300
- end
301
- end
302
- end
1
+ # frozen_string_literal: true
2
+
3
+ module RubyDB
4
+ module SQL
5
+ module Planner
6
+ # Analyzer - Performs semantic analysis and query rewriting
7
+ class Analyzer
8
+ attr_reader :errors, :warnings
9
+
10
+ def initialize(catalog)
11
+ @catalog = catalog
12
+ @errors = []
13
+ @warnings = []
14
+ @binder = Binder.new(catalog)
15
+ @type_checker = TypeChecker.new(catalog)
16
+ end
17
+
18
+ # Analyze a statement
19
+ def analyze(statement)
20
+ @errors = []
21
+ @warnings = []
22
+
23
+ # First pass: Bind identifiers
24
+ bound_statement, bind_errors, bind_warnings = @binder.bind(statement)
25
+ @errors.concat(bind_errors)
26
+ @warnings.concat(bind_warnings)
27
+
28
+ # Second pass: Type checking
29
+ typed_statement, type_errors, type_warnings = @type_checker.check(bound_statement)
30
+ @errors.concat(type_errors)
31
+ @warnings.concat(type_warnings)
32
+
33
+ # Third pass: Query rewriting (if no errors)
34
+ if @errors.empty?
35
+ rewritten_statement = rewrite(typed_statement)
36
+ return [rewritten_statement, @errors, @warnings]
37
+ end
38
+
39
+ [typed_statement, @errors, @warnings]
40
+ end
41
+
42
+ # Perform query rewriting
43
+ def rewrite(statement)
44
+ # Rewrite '*' to explicit columns
45
+ if statement.is_a?(AST::Select) && statement.has_star?
46
+ statement = expand_star(statement)
47
+ end
48
+
49
+ # Normalize expressions
50
+ statement = normalize_expressions(statement)
51
+
52
+ # Remove redundant conditions
53
+ simplify_conditions(statement)
54
+ end
55
+
56
+ private
57
+
58
+ def expand_star(select)
59
+ table_info = @catalog.find_table(select.table_name)
60
+ return select unless table_info
61
+
62
+ # Replace star with all columns
63
+ new_columns = table_info.columns.map do |col|
64
+ expr = AST::Identifier.new(col.name, table: select.table_name)
65
+ AST::SelectColumn.new(expr)
66
+ end
67
+
68
+ # Keep non-star columns
69
+ non_star_columns = select.columns.reject { |c| c.expression.is_a?(AST::Star) }
70
+
71
+ AST::Select.new(
72
+ new_columns + non_star_columns,
73
+ select.from,
74
+ select.where,
75
+ select.order_by,
76
+ select.limit,
77
+ select.offset,
78
+ select.distinct
79
+ )
80
+ end
81
+
82
+ def normalize_expressions(node)
83
+ # Recursively normalize expression trees
84
+ case node
85
+ when AST::BinaryOp
86
+ # Simplify constant expressions
87
+ if node.left.is_a?(AST::Literal) && node.right.is_a?(AST::Literal)
88
+ return evaluate_constant_expression(node)
89
+ end
90
+ node.left = normalize_expressions(node.left)
91
+ node.right = normalize_expressions(node.right)
92
+
93
+ when AST::UnaryOp
94
+ # Simplify constant unary expressions
95
+ if node.operand.is_a?(AST::Literal)
96
+ return evaluate_constant_unary(node)
97
+ end
98
+ node.operand = normalize_expressions(node.operand)
99
+
100
+ when AST::Between
101
+ node.expression = normalize_expressions(node.expression)
102
+ node.low = normalize_expressions(node.low)
103
+ node.high = normalize_expressions(node.high)
104
+
105
+ when AST::In
106
+ node.expression = normalize_expressions(node.expression)
107
+ node.values = node.values.map { |v| normalize_expressions(v) }
108
+
109
+ when AST::IsNull
110
+ node.expression = normalize_expressions(node.expression)
111
+
112
+ when AST::Select
113
+ if node.where
114
+ node.where = normalize_expressions(node.where)
115
+ end
116
+ if node.limit
117
+ node.limit = normalize_expressions(node.limit)
118
+ end
119
+ if node.offset
120
+ node.offset = normalize_expressions(node.offset)
121
+ end
122
+ node.order_by.each do |order_item|
123
+ order_item.expression = normalize_expressions(order_item.expression)
124
+ end
125
+
126
+ when AST::Insert
127
+ node.values = node.values.map { |v| normalize_expressions(v) }
128
+
129
+ when AST::Update
130
+ node.assignments.each do |assignment|
131
+ assignment.value = normalize_expressions(assignment.value)
132
+ end
133
+ if node.where
134
+ node.where = normalize_expressions(node.where)
135
+ end
136
+
137
+ when AST::Delete
138
+ if node.where
139
+ node.where = normalize_expressions(node.where)
140
+ end
141
+
142
+ end
143
+ node
144
+ end
145
+
146
+ def evaluate_constant_expression(expr)
147
+ left_val = expr.left.value
148
+ right_val = expr.right.value
149
+
150
+ result = case expr.operator
151
+ when Token::Type::PLUS
152
+ left_val + right_val
153
+ when Token::Type::MINUS
154
+ left_val - right_val
155
+ when Token::Type::STAR
156
+ left_val * right_val
157
+ when Token::Type::SLASH
158
+ left_val / right_val if right_val != 0
159
+ when Token::Type::PERCENT
160
+ left_val % right_val if right_val != 0
161
+ when Token::Type::EQ
162
+ left_val == right_val
163
+ when Token::Type::NE
164
+ left_val != right_val
165
+ when Token::Type::LT
166
+ left_val < right_val
167
+ when Token::Type::LTE
168
+ left_val <= right_val
169
+ when Token::Type::GT
170
+ left_val > right_val
171
+ when Token::Type::GTE
172
+ left_val >= right_val
173
+ else
174
+ return expr
175
+ end
176
+
177
+ if result.nil?
178
+ return AST::NullLiteral.new
179
+ end
180
+
181
+ token_type = Token::Type::NUMBER
182
+ AST::Literal.new(result, token_type)
183
+ end
184
+
185
+ def evaluate_constant_unary(expr)
186
+ val = expr.operand.value
187
+
188
+ result = case expr.operator
189
+ when Token::Type::MINUS
190
+ -val
191
+ when Token::Type::PLUS
192
+ +val
193
+ when Token::Type::TILDE
194
+ ~val if val.is_a?(Integer)
195
+ else
196
+ return expr
197
+ end
198
+
199
+ if result.nil?
200
+ return AST::NullLiteral.new
201
+ end
202
+
203
+ token_type = Token::Type::NUMBER
204
+ AST::Literal.new(result, token_type)
205
+ end
206
+
207
+ def simplify_conditions(node)
208
+ # Simplify WHERE conditions
209
+ case node
210
+ when AST::Select
211
+ if node.where
212
+ node.where = simplify_condition(node.where)
213
+ end
214
+
215
+ when AST::Update
216
+ if node.where
217
+ node.where = simplify_condition(node.where)
218
+ end
219
+
220
+ when AST::Delete
221
+ if node.where
222
+ node.where = simplify_condition(node.where)
223
+ end
224
+
225
+ end
226
+ node
227
+ end
228
+
229
+ def simplify_condition(condition)
230
+ case condition
231
+ when AST::BinaryOp
232
+ # Simplify AND/OR trees
233
+ if condition.operator == Token::Type::AND
234
+ left = simplify_condition(condition.left)
235
+ right = simplify_condition(condition.right)
236
+
237
+ # TRUE AND X => X
238
+ if left.is_a?(AST::Literal) && left.value == true
239
+ return right
240
+ end
241
+ # X AND TRUE => X
242
+ if right.is_a?(AST::Literal) && right.value == true
243
+ return left
244
+ end
245
+ # FALSE AND X => FALSE
246
+ if left.is_a?(AST::Literal) && left.value == false
247
+ return left
248
+ end
249
+ # X AND FALSE => FALSE
250
+ if right.is_a?(AST::Literal) && right.value == false
251
+ return right
252
+ end
253
+ end
254
+
255
+ if condition.operator == Token::Type::OR
256
+ left = simplify_condition(condition.left)
257
+ right = simplify_condition(condition.right)
258
+
259
+ # TRUE OR X => TRUE
260
+ if left.is_a?(AST::Literal) && left.value == true
261
+ return left
262
+ end
263
+ # X OR TRUE => TRUE
264
+ if right.is_a?(AST::Literal) && right.value == true
265
+ return right
266
+ end
267
+ # FALSE OR X => X
268
+ if left.is_a?(AST::Literal) && left.value == false
269
+ return right
270
+ end
271
+ # X OR FALSE => X
272
+ if right.is_a?(AST::Literal) && right.value == false
273
+ return left
274
+ end
275
+ end
276
+
277
+ end
278
+ condition
279
+ end
280
+ end
281
+ end
282
+ end
283
+ end