rubydb 0.1.0
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.
- checksums.yaml +7 -0
- data/.gitattributes +20 -0
- data/.github/ISSUE_TEMPLATE/bug.yml +0 -0
- data/.github/ISSUE_TEMPLATE/feature.yml +0 -0
- data/.github/ISSUE_TEMPLATE/performance.yml +0 -0
- data/.github/ISSUE_TEMPLATE/security.yml +0 -0
- data/.github/PULL_REQUEST_TEMPLATE.md +15 -0
- data/.github/dependabot.yml +0 -0
- data/.github/workflows/benchmark.yml +26 -0
- data/.github/workflows/compatibility.yml +63 -0
- data/.github/workflows/fuzz.yml +33 -0
- data/.github/workflows/lint.yml +21 -0
- data/.github/workflows/operations.yml +24 -0
- data/.github/workflows/production-validation.yml +111 -0
- data/.github/workflows/release.yml +77 -0
- data/.github/workflows/security.yml +37 -0
- data/.github/workflows/test.yml +26 -0
- data/.github/workflows/workload.yml +58 -0
- data/.gitignore +43 -0
- data/.rspec +4 -0
- data/.rubocop.yml +44 -0
- data/.ruby-version +1 -0
- data/.standard.yml +14 -0
- data/ARCHITECTURE.md +21 -0
- data/CHANGELOG.md +31 -0
- data/CODE_OF_CONDUCT.md +13 -0
- data/CONTRIBUTING.md +29 -0
- data/GOVERNANCE.md +16 -0
- data/Gemfile +17 -0
- data/Gemfile.lock +71 -0
- data/LICENSE +60 -0
- data/README.md +162 -0
- data/ROADMAP.md +27 -0
- data/Rakefile +71 -0
- data/SECURITY.md +54 -0
- data/SUPPORT.md +14 -0
- data/adapters/activerecord/Gemfile +11 -0
- data/adapters/activerecord/README.md +9 -0
- data/adapters/activerecord/lib/active_record/connection_adapters/rubydb_adapter.rb +887 -0
- data/adapters/activerecord/rubydb-activerecord.gemspec +27 -0
- data/adapters/activerecord/spec/rubydb_adapter_integration_spec.rb +151 -0
- data/adapters/ruby/README.md +18 -0
- data/adapters/sequel/README.md +11 -0
- data/bin/rubydb +19 -0
- data/bin/rubydb-server +126 -0
- data/config/development.yml +0 -0
- data/config/monitoring/prometheus-alerts.yml +39 -0
- data/config/production.yml +36 -0
- data/config/test.yml +0 -0
- data/docs/README.md +71 -0
- data/docs/architecture/concurrency.md +14 -0
- data/docs/architecture/current-state.md +125 -0
- data/docs/architecture/execution-engine.md +25 -0
- data/docs/architecture/indexes.md +19 -0
- data/docs/architecture/mvcc.md +19 -0
- data/docs/architecture/overview.md +13 -0
- data/docs/architecture/pages.md +11 -0
- data/docs/architecture/production-roadmap.md +82 -0
- data/docs/architecture/query-planner.md +20 -0
- data/docs/architecture/recovery.md +18 -0
- data/docs/architecture/sql-engine.md +12 -0
- data/docs/architecture/storage-engine.md +14 -0
- data/docs/architecture/transactions.md +10 -0
- data/docs/architecture/wal.md +28 -0
- data/docs/cli-cheatsheet.md +98 -0
- data/docs/cli.md +275 -0
- data/docs/contributing/architecture.md +9 -0
- data/docs/contributing/benchmarking.md +14 -0
- data/docs/contributing/development.md +16 -0
- data/docs/contributing/release-process.md +49 -0
- data/docs/contributing/testing.md +16 -0
- data/docs/debugging.md +229 -0
- data/docs/developer/branching.md +10 -0
- data/docs/developer/database-diff.md +10 -0
- data/docs/developer/local-development.md +17 -0
- data/docs/developer/snapshots.md +9 -0
- data/docs/developer/temporal-data.md +10 -0
- data/docs/developer-guide.md +297 -0
- data/docs/getting-started/first-database.md +16 -0
- data/docs/getting-started/first-query.md +13 -0
- data/docs/getting-started/installation.md +19 -0
- data/docs/getting-started/local-to-production.md +300 -0
- data/docs/getting-started/quickstart.md +17 -0
- data/docs/getting-started/rails.md +16 -0
- data/docs/hardening_backlog.md +93 -0
- data/docs/lessons-learned.md +112 -0
- data/docs/operations/backups.md +33 -0
- data/docs/operations/disaster-recovery.md +31 -0
- data/docs/operations/failover.md +30 -0
- data/docs/operations/monitoring.md +25 -0
- data/docs/operations/production-guide.md +295 -0
- data/docs/operations/production-runbook.md +45 -0
- data/docs/operations/replication.md +33 -0
- data/docs/operations/restore.md +6 -0
- data/docs/operations/runbook.md +34 -0
- data/docs/operations/upgrades.md +14 -0
- data/docs/operations/workload-testing.md +17 -0
- data/docs/production-readiness.md +118 -0
- data/docs/production_validation.md +150 -0
- data/docs/rails/active-record.md +11 -0
- data/docs/rails/compatibility-guide.md +90 -0
- data/docs/rails/database-yml.md +92 -0
- data/docs/rails/installation.md +17 -0
- data/docs/rails/migrations.md +17 -0
- data/docs/rails/production.md +82 -0
- data/docs/rails/troubleshooting.md +18 -0
- data/docs/release.md +59 -0
- data/docs/server/architecture.md +10 -0
- data/docs/server/authentication.md +10 -0
- data/docs/server/configuration.md +16 -0
- data/docs/server/connection-pooling.md +10 -0
- data/docs/server/deployment.md +10 -0
- data/docs/server/protocol.md +12 -0
- data/docs/sql/compatibility-guide.md +82 -0
- data/docs/sql/compatibility.md +39 -0
- data/docs/sql/data-types.md +10 -0
- data/docs/sql/functions.md +9 -0
- data/docs/sql/joins.md +9 -0
- data/docs/sql/operators.md +9 -0
- data/docs/sql/sqlite-compatibility.md +21 -0
- data/docs/sql/syntax.md +10 -0
- data/docs/sql/transactions.md +10 -0
- data/docs/troubleshooting.md +244 -0
- data/exe/rubydb +23 -0
- data/lib/rubydb/backup/archive.rb +334 -0
- data/lib/rubydb/backup/backup.rb +401 -0
- data/lib/rubydb/backup/incremental.rb +353 -0
- data/lib/rubydb/backup/restore.rb +290 -0
- data/lib/rubydb/backup/snapshot.rb +267 -0
- data/lib/rubydb/backup/verification.rb +279 -0
- data/lib/rubydb/branching/branch.rb +181 -0
- data/lib/rubydb/branching/branch_manager.rb +311 -0
- data/lib/rubydb/branching/branch_metadata.rb +140 -0
- data/lib/rubydb/branching/checkout.rb +166 -0
- data/lib/rubydb/branching/copy_on_write.rb +272 -0
- data/lib/rubydb/branching/diff.rb +138 -0
- data/lib/rubydb/branching/merge.rb +285 -0
- data/lib/rubydb/build_info.rb +15 -0
- data/lib/rubydb/catalog/catalog.rb +391 -0
- data/lib/rubydb/catalog/column.rb +112 -0
- data/lib/rubydb/catalog/constraint.rb +180 -0
- data/lib/rubydb/catalog/database.rb +184 -0
- data/lib/rubydb/catalog/index.rb +97 -0
- data/lib/rubydb/catalog/schema.rb +103 -0
- data/lib/rubydb/catalog/sequence.rb +90 -0
- data/lib/rubydb/catalog/system_catalog.rb +698 -0
- data/lib/rubydb/catalog/table.rb +178 -0
- data/lib/rubydb/catalog/trigger.rb +102 -0
- data/lib/rubydb/catalog/view.rb +66 -0
- data/lib/rubydb/cli/application.rb +163 -0
- data/lib/rubydb/cli/commands/backup.rb +81 -0
- data/lib/rubydb/cli/commands/branch.rb +72 -0
- data/lib/rubydb/cli/commands/checkout.rb +54 -0
- data/lib/rubydb/cli/commands/create.rb +58 -0
- data/lib/rubydb/cli/commands/diff.rb +77 -0
- data/lib/rubydb/cli/commands/doctor.rb +74 -0
- data/lib/rubydb/cli/commands/drop.rb +57 -0
- data/lib/rubydb/cli/commands/init.rb +102 -0
- data/lib/rubydb/cli/commands/inspect.rb +95 -0
- data/lib/rubydb/cli/commands/merge.rb +63 -0
- data/lib/rubydb/cli/commands/migrate.rb +62 -0
- data/lib/rubydb/cli/commands/restart.rb +39 -0
- data/lib/rubydb/cli/commands/restore.rb +121 -0
- data/lib/rubydb/cli/commands/shell.rb +365 -0
- data/lib/rubydb/cli/commands/snapshot.rb +79 -0
- data/lib/rubydb/cli/commands/start.rb +82 -0
- data/lib/rubydb/cli/commands/status.rb +92 -0
- data/lib/rubydb/cli/commands/stop.rb +47 -0
- data/lib/rubydb/cli/commands/vacuum.rb +58 -0
- data/lib/rubydb/cli/formatter.rb +221 -0
- data/lib/rubydb/cli/output.rb +168 -0
- data/lib/rubydb/client/client.rb +304 -0
- data/lib/rubydb/client/connection.rb +415 -0
- data/lib/rubydb/client/connection_pool.rb +168 -0
- data/lib/rubydb/client/connection_url.rb +96 -0
- data/lib/rubydb/client/prepared_statement.rb +60 -0
- data/lib/rubydb/client/result.rb +123 -0
- data/lib/rubydb/client/statement.rb +52 -0
- data/lib/rubydb/client/transaction.rb +130 -0
- data/lib/rubydb/concurrency/concurrency.rb +19 -0
- data/lib/rubydb/concurrency/deadlock_detector.rb +150 -0
- data/lib/rubydb/concurrency/latch.rb +101 -0
- data/lib/rubydb/concurrency/lock_graph.rb +165 -0
- data/lib/rubydb/concurrency/mutex.rb +183 -0
- data/lib/rubydb/concurrency/rw_lock.rb +180 -0
- data/lib/rubydb/concurrency/scheduler.rb +250 -0
- data/lib/rubydb/concurrency/worker_pool.rb +143 -0
- data/lib/rubydb/configuration/config.rb +170 -0
- data/lib/rubydb/configuration/defaults.rb +179 -0
- data/lib/rubydb/configuration/environment.rb +152 -0
- data/lib/rubydb/configuration/parser.rb +185 -0
- data/lib/rubydb/configuration/validation.rb +221 -0
- data/lib/rubydb/constants.rb +74 -0
- data/lib/rubydb/constraints/check.rb +181 -0
- data/lib/rubydb/constraints/constraint.rb +101 -0
- data/lib/rubydb/constraints/foreign_key.rb +130 -0
- data/lib/rubydb/constraints/not_null.rb +64 -0
- data/lib/rubydb/constraints/primary_key.rb +99 -0
- data/lib/rubydb/constraints/unique.rb +108 -0
- data/lib/rubydb/constraints/validator.rb +350 -0
- data/lib/rubydb/errors/authentication_error.rb +10 -0
- data/lib/rubydb/errors/authorization_error.rb +23 -0
- data/lib/rubydb/errors/client_error.rb +10 -0
- data/lib/rubydb/errors/configuration_error.rb +10 -0
- data/lib/rubydb/errors/connection_error.rb +10 -0
- data/lib/rubydb/errors/constraint_error.rb +23 -0
- data/lib/rubydb/errors/corruption_error.rb +10 -0
- data/lib/rubydb/errors/database_error.rb +10 -0
- data/lib/rubydb/errors/error.rb +20 -0
- data/lib/rubydb/errors/execution_error.rb +10 -0
- data/lib/rubydb/errors/parser_error.rb +10 -0
- data/lib/rubydb/errors/recovery_error.rb +10 -0
- data/lib/rubydb/errors/replication_error.rb +10 -0
- data/lib/rubydb/errors/server_error.rb +6 -0
- data/lib/rubydb/errors/storage_error.rb +10 -0
- data/lib/rubydb/errors/transaction_error.rb +10 -0
- data/lib/rubydb/execution/aggregate_executor.rb +138 -0
- data/lib/rubydb/execution/delete_executor.rb +112 -0
- data/lib/rubydb/execution/distinct_executor.rb +135 -0
- data/lib/rubydb/execution/executor.rb +1192 -0
- data/lib/rubydb/execution/expression.rb +193 -0
- data/lib/rubydb/execution/index_scan.rb +142 -0
- data/lib/rubydb/execution/insert_executor.rb +217 -0
- data/lib/rubydb/execution/join_executor.rb +249 -0
- data/lib/rubydb/execution/limit_executor.rb +85 -0
- data/lib/rubydb/execution/optimizer.rb +215 -0
- data/lib/rubydb/execution/plan.rb +361 -0
- data/lib/rubydb/execution/planner.rb +546 -0
- data/lib/rubydb/execution/predicate.rb +235 -0
- data/lib/rubydb/execution/scan.rb +49 -0
- data/lib/rubydb/execution/sequential_scan.rb +63 -0
- data/lib/rubydb/execution/sort_executor.rb +185 -0
- data/lib/rubydb/execution/update_executor.rb +162 -0
- data/lib/rubydb/functions/aggregate.rb +70 -0
- data/lib/rubydb/functions/date_functions.rb +278 -0
- data/lib/rubydb/functions/function.rb +85 -0
- data/lib/rubydb/functions/json_functions.rb +215 -0
- data/lib/rubydb/functions/numeric_functions.rb +346 -0
- data/lib/rubydb/functions/scalar.rb +52 -0
- data/lib/rubydb/functions/string_functions.rb +383 -0
- data/lib/rubydb/functions/system_functions.rb +246 -0
- data/lib/rubydb/history/as_of.rb +238 -0
- data/lib/rubydb/history/change.rb +105 -0
- data/lib/rubydb/history/history.rb +131 -0
- data/lib/rubydb/history/history_manager.rb +229 -0
- data/lib/rubydb/history/temporal_query.rb +202 -0
- data/lib/rubydb/history/timeline.rb +144 -0
- data/lib/rubydb/indexes/btree.rb +186 -0
- data/lib/rubydb/indexes/btree_cursor.rb +258 -0
- data/lib/rubydb/indexes/btree_node.rb +385 -0
- data/lib/rubydb/indexes/hash_index.rb +150 -0
- data/lib/rubydb/indexes/index.rb +71 -0
- data/lib/rubydb/indexes/index_manager.rb +406 -0
- data/lib/rubydb/indexes/index_scan.rb +470 -0
- data/lib/rubydb/migrations/migration.rb +254 -0
- data/lib/rubydb/migrations/migration_lock.rb +146 -0
- data/lib/rubydb/migrations/migration_manager.rb +176 -0
- data/lib/rubydb/migrations/migration_version.rb +71 -0
- data/lib/rubydb/migrations/schema_diff.rb +211 -0
- data/lib/rubydb/migrations/schema_version.rb +64 -0
- data/lib/rubydb/monitoring/events.rb +160 -0
- data/lib/rubydb/monitoring/health.rb +222 -0
- data/lib/rubydb/monitoring/logger.rb +193 -0
- data/lib/rubydb/monitoring/metrics.rb +359 -0
- data/lib/rubydb/monitoring/performance.rb +176 -0
- data/lib/rubydb/monitoring/statistics.rb +170 -0
- data/lib/rubydb/mvcc/garbage_collector.rb +199 -0
- data/lib/rubydb/mvcc/mvcc.rb +16 -0
- data/lib/rubydb/mvcc/snapshot.rb +147 -0
- data/lib/rubydb/mvcc/vacuum.rb +180 -0
- data/lib/rubydb/mvcc/version.rb +106 -0
- data/lib/rubydb/mvcc/version_store.rb +398 -0
- data/lib/rubydb/mvcc/visibility.rb +109 -0
- data/lib/rubydb/protocol/capabilities.rb +125 -0
- data/lib/rubydb/protocol/decoder.rb +145 -0
- data/lib/rubydb/protocol/encoder.rb +136 -0
- data/lib/rubydb/protocol/handshake.rb +305 -0
- data/lib/rubydb/protocol/message.rb +121 -0
- data/lib/rubydb/protocol/protocol.rb +277 -0
- data/lib/rubydb/protocol/version.rb +54 -0
- data/lib/rubydb/rails/adapter.rb +239 -0
- data/lib/rubydb/rails/connection.rb +314 -0
- data/lib/rubydb/rails/database_statements.rb +122 -0
- data/lib/rubydb/rails/migration.rb +131 -0
- data/lib/rubydb/rails/quoting.rb +109 -0
- data/lib/rubydb/rails/result.rb +120 -0
- data/lib/rubydb/rails/schema_statements.rb +339 -0
- data/lib/rubydb/rails/transaction.rb +105 -0
- data/lib/rubydb/rails/type.rb +126 -0
- data/lib/rubydb/recovery/checkpoint.rb +257 -0
- data/lib/rubydb/recovery/consistency.rb +467 -0
- data/lib/rubydb/recovery/corruption_detector.rb +5 -0
- data/lib/rubydb/recovery/crash_recovery.rb +387 -0
- data/lib/rubydb/recovery/recovery_manager.rb +206 -0
- data/lib/rubydb/recovery/redo.rb +237 -0
- data/lib/rubydb/recovery/undo.rb +206 -0
- data/lib/rubydb/replication/failover.rb +5 -0
- data/lib/rubydb/replication/fencing.rb +63 -0
- data/lib/rubydb/replication/primary.rb +450 -0
- data/lib/rubydb/replication/replica.rb +384 -0
- data/lib/rubydb/replication/replication_log.rb +200 -0
- data/lib/rubydb/replication/replication_manager.rb +308 -0
- data/lib/rubydb/replication/replication_slot.rb +295 -0
- data/lib/rubydb/replication/replication_stream.rb +201 -0
- data/lib/rubydb/rubydb.rb +560 -0
- data/lib/rubydb/security/access_control.rb +254 -0
- data/lib/rubydb/security/audit_log.rb +213 -0
- data/lib/rubydb/security/authentication.rb +302 -0
- data/lib/rubydb/security/authorization.rb +282 -0
- data/lib/rubydb/security/credentials.rb +196 -0
- data/lib/rubydb/security/password.rb +215 -0
- data/lib/rubydb/security/permissions.rb +74 -0
- data/lib/rubydb/security/role.rb +101 -0
- data/lib/rubydb/security/user.rb +86 -0
- data/lib/rubydb/server/connection.rb +366 -0
- data/lib/rubydb/server/connection_pool.rb +193 -0
- data/lib/rubydb/server/lifecycle.rb +228 -0
- data/lib/rubydb/server/listener.rb +136 -0
- data/lib/rubydb/server/request_handler.rb +276 -0
- data/lib/rubydb/server/server.rb +364 -0
- data/lib/rubydb/server/session.rb +369 -0
- data/lib/rubydb/server/worker.rb +210 -0
- data/lib/rubydb/server/worker_pool.rb +168 -0
- data/lib/rubydb/sql/ast/alter_table.rb +169 -0
- data/lib/rubydb/sql/ast/begin_transaction.rb +47 -0
- data/lib/rubydb/sql/ast/commit.rb +37 -0
- data/lib/rubydb/sql/ast/constraint.rb +83 -0
- data/lib/rubydb/sql/ast/create_database.rb +41 -0
- data/lib/rubydb/sql/ast/create_index.rb +61 -0
- data/lib/rubydb/sql/ast/create_schema.rb +52 -0
- data/lib/rubydb/sql/ast/create_table.rb +187 -0
- data/lib/rubydb/sql/ast/delete.rb +54 -0
- data/lib/rubydb/sql/ast/drop_database.rb +41 -0
- data/lib/rubydb/sql/ast/drop_index.rb +41 -0
- data/lib/rubydb/sql/ast/drop_schema.rb +49 -0
- data/lib/rubydb/sql/ast/drop_table.rb +49 -0
- data/lib/rubydb/sql/ast/explain.rb +64 -0
- data/lib/rubydb/sql/ast/expression.rb +604 -0
- data/lib/rubydb/sql/ast/insert.rb +82 -0
- data/lib/rubydb/sql/ast/node.rb +42 -0
- data/lib/rubydb/sql/ast/rollback.rb +63 -0
- data/lib/rubydb/sql/ast/savepoint.rb +59 -0
- data/lib/rubydb/sql/ast/select.rb +88 -0
- data/lib/rubydb/sql/ast/set_operation.rb +20 -0
- data/lib/rubydb/sql/ast/trigger.rb +29 -0
- data/lib/rubydb/sql/ast/update.rb +88 -0
- data/lib/rubydb/sql/ast/vacuum.rb +19 -0
- data/lib/rubydb/sql/ast/view.rb +32 -0
- data/lib/rubydb/sql/ast/with.rb +32 -0
- data/lib/rubydb/sql/grammar.rb +86 -0
- data/lib/rubydb/sql/keywords.rb +156 -0
- data/lib/rubydb/sql/lexer.rb +214 -0
- data/lib/rubydb/sql/operators.rb +100 -0
- data/lib/rubydb/sql/parser.rb +1185 -0
- data/lib/rubydb/sql/planner/analyzer.rb +302 -0
- data/lib/rubydb/sql/planner/binder.rb +550 -0
- data/lib/rubydb/sql/planner/type_checker.rb +431 -0
- data/lib/rubydb/sql/token.rb +210 -0
- data/lib/rubydb/storage/buffer_frame.rb +44 -0
- data/lib/rubydb/storage/buffer_pool.rb +155 -0
- data/lib/rubydb/storage/database_lock.rb +74 -0
- data/lib/rubydb/storage/deserializer.rb +342 -0
- data/lib/rubydb/storage/engine.rb +2338 -0
- data/lib/rubydb/storage/file_manager.rb +187 -0
- data/lib/rubydb/storage/free_space_map.rb +81 -0
- data/lib/rubydb/storage/page.rb +94 -0
- data/lib/rubydb/storage/page_allocator.rb +855 -0
- data/lib/rubydb/storage/page_header.rb +67 -0
- data/lib/rubydb/storage/page_manager.rb +131 -0
- data/lib/rubydb/storage/record.rb +58 -0
- data/lib/rubydb/storage/row.rb +78 -0
- data/lib/rubydb/storage/serializer.rb +51 -0
- data/lib/rubydb/storage/storage_layout.rb +151 -0
- data/lib/rubydb/storage/storage_manager.rb +114 -0
- data/lib/rubydb/storage/tuple.rb +461 -0
- data/lib/rubydb/storage/visibility_map.rb +984 -0
- data/lib/rubydb/transactions/commit_manager.rb +220 -0
- data/lib/rubydb/transactions/isolation.rb +98 -0
- data/lib/rubydb/transactions/lock.rb +76 -0
- data/lib/rubydb/transactions/lock_manager.rb +362 -0
- data/lib/rubydb/transactions/savepoint.rb +143 -0
- data/lib/rubydb/transactions/transaction.rb +215 -0
- data/lib/rubydb/transactions/transaction_id.rb +84 -0
- data/lib/rubydb/transactions/transaction_log.rb +257 -0
- data/lib/rubydb/transactions/transaction_manager.rb +435 -0
- data/lib/rubydb/types/bigint.rb +36 -0
- data/lib/rubydb/types/blob.rb +37 -0
- data/lib/rubydb/types/boolean.rb +34 -0
- data/lib/rubydb/types/date.rb +39 -0
- data/lib/rubydb/types/decimal.rb +48 -0
- data/lib/rubydb/types/float.rb +34 -0
- data/lib/rubydb/types/integer.rb +36 -0
- data/lib/rubydb/types/json.rb +41 -0
- data/lib/rubydb/types/null.rb +34 -0
- data/lib/rubydb/types/smallint.rb +36 -0
- data/lib/rubydb/types/text.rb +37 -0
- data/lib/rubydb/types/time.rb +46 -0
- data/lib/rubydb/types/timestamp.rb +39 -0
- data/lib/rubydb/types/type.rb +119 -0
- data/lib/rubydb/types/uuid.rb +47 -0
- data/lib/rubydb/types/varchar.rb +37 -0
- data/lib/rubydb/version.rb +33 -0
- data/lib/rubydb/wal/archive.rb +193 -0
- data/lib/rubydb/wal/checkpoint.rb +183 -0
- data/lib/rubydb/wal/lsn.rb +94 -0
- data/lib/rubydb/wal/reader.rb +260 -0
- data/lib/rubydb/wal/record.rb +105 -0
- data/lib/rubydb/wal/segment.rb +193 -0
- data/lib/rubydb/wal/wal.rb +452 -0
- data/lib/rubydb/wal/writer.rb +236 -0
- data/lib/rubydb.rb +7 -0
- data/packaging/docker/Dockerfile +36 -0
- data/packaging/docker/docker-compose.failover.yml +43 -0
- data/packaging/docker/entrypoint.sh +15 -0
- data/packaging/homebrew/rubydb.rb +19 -0
- data/packaging/systemd/rubydb.service +22 -0
- data/rubydb.gemspec +57 -0
- data/scripts/benchmark +7 -0
- data/scripts/durability_drill +37 -0
- data/scripts/format +0 -0
- data/scripts/fuzz +63 -0
- data/scripts/lint +0 -0
- data/scripts/release +50 -0
- data/scripts/release_check +43 -0
- data/scripts/replication_failover_drill +250 -0
- data/scripts/replication_network_failover_drill +255 -0
- data/scripts/restore_drill +45 -0
- data/scripts/security +0 -0
- data/scripts/setup +0 -0
- data/scripts/test +0 -0
- data/scripts/test-chaos +0 -0
- data/scripts/test-crash +0 -0
- data/scripts/test-integration +0 -0
- data/scripts/test-unit +0 -0
- data/visibility_map.json +1 -0
- metadata +538 -0
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RubyDB
|
|
4
|
+
module Transactions
|
|
5
|
+
|
|
6
|
+
# Import dependencies
|
|
7
|
+
require_relative "transaction"
|
|
8
|
+
require_relative "transaction_log"
|
|
9
|
+
|
|
10
|
+
# CommitManager - Manages two-phase commit and commit coordination
|
|
11
|
+
class CommitManager
|
|
12
|
+
attr_reader :stats
|
|
13
|
+
|
|
14
|
+
def initialize(transaction_manager, config = {})
|
|
15
|
+
@transaction_manager = transaction_manager
|
|
16
|
+
@config = config
|
|
17
|
+
@prepared_transactions = {}
|
|
18
|
+
@commit_queue = []
|
|
19
|
+
@stats = {
|
|
20
|
+
prepared_count: 0,
|
|
21
|
+
committed_count: 0,
|
|
22
|
+
rolled_back_count: 0,
|
|
23
|
+
in_doubt_count: 0,
|
|
24
|
+
two_phase_commits: 0
|
|
25
|
+
}
|
|
26
|
+
@lock = Mutex.new
|
|
27
|
+
@commit_thread = nil
|
|
28
|
+
|
|
29
|
+
start_commit_thread if config[:async_commit] != false
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
def commit(transaction)
|
|
33
|
+
@lock.synchronize do
|
|
34
|
+
# Two-phase commit
|
|
35
|
+
if @config[:two_phase_commit]
|
|
36
|
+
two_phase_commit(transaction)
|
|
37
|
+
else
|
|
38
|
+
one_phase_commit(transaction)
|
|
39
|
+
end
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def prepare(transaction)
|
|
44
|
+
@lock.synchronize do
|
|
45
|
+
# Validate that transaction can be prepared
|
|
46
|
+
return false unless transaction.active?
|
|
47
|
+
|
|
48
|
+
# Write prepare record to log
|
|
49
|
+
@transaction_manager.transaction_log.log_prepare(transaction)
|
|
50
|
+
|
|
51
|
+
# Store prepared transaction
|
|
52
|
+
@prepared_transactions[transaction.id] = {
|
|
53
|
+
transaction: transaction,
|
|
54
|
+
prepared_at: Time.now,
|
|
55
|
+
resources: transaction.modified_rows.keys
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
@stats[:prepared_count] += 1
|
|
59
|
+
true
|
|
60
|
+
end
|
|
61
|
+
end
|
|
62
|
+
|
|
63
|
+
def commit_prepared(transaction)
|
|
64
|
+
@lock.synchronize do
|
|
65
|
+
prepared = @prepared_transactions[transaction.id]
|
|
66
|
+
return false unless prepared
|
|
67
|
+
|
|
68
|
+
# Write commit record
|
|
69
|
+
@transaction_manager.transaction_log.log_commit(transaction)
|
|
70
|
+
|
|
71
|
+
# Commit changes
|
|
72
|
+
commit_changes(transaction)
|
|
73
|
+
|
|
74
|
+
@prepared_transactions.delete(transaction.id)
|
|
75
|
+
@stats[:committed_count] += 1
|
|
76
|
+
true
|
|
77
|
+
end
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
def rollback_prepared(transaction)
|
|
81
|
+
@lock.synchronize do
|
|
82
|
+
prepared = @prepared_transactions[transaction.id]
|
|
83
|
+
return false unless prepared
|
|
84
|
+
|
|
85
|
+
# Write rollback record
|
|
86
|
+
@transaction_manager.transaction_log.log_rollback(transaction)
|
|
87
|
+
|
|
88
|
+
# Rollback changes
|
|
89
|
+
rollback_changes(transaction)
|
|
90
|
+
|
|
91
|
+
@prepared_transactions.delete(transaction.id)
|
|
92
|
+
@stats[:rolled_back_count] += 1
|
|
93
|
+
true
|
|
94
|
+
end
|
|
95
|
+
end
|
|
96
|
+
|
|
97
|
+
def resolve_in_doubt
|
|
98
|
+
@lock.synchronize do
|
|
99
|
+
@prepared_transactions.each do |id, prepared|
|
|
100
|
+
next unless prepared[:transaction].in_doubt?
|
|
101
|
+
|
|
102
|
+
# Try to resolve by checking if commit was successful
|
|
103
|
+
if can_commit?(prepared[:transaction])
|
|
104
|
+
commit_prepared(prepared[:transaction])
|
|
105
|
+
else
|
|
106
|
+
rollback_prepared(prepared[:transaction])
|
|
107
|
+
end
|
|
108
|
+
end
|
|
109
|
+
end
|
|
110
|
+
end
|
|
111
|
+
|
|
112
|
+
def async_commit(transaction)
|
|
113
|
+
@lock.synchronize do
|
|
114
|
+
@commit_queue << {
|
|
115
|
+
transaction: transaction,
|
|
116
|
+
added_at: Time.now
|
|
117
|
+
}
|
|
118
|
+
end
|
|
119
|
+
end
|
|
120
|
+
|
|
121
|
+
private
|
|
122
|
+
|
|
123
|
+
def one_phase_commit(transaction)
|
|
124
|
+
# Simple commit - write to log and apply changes
|
|
125
|
+
@transaction_manager.transaction_log.log_commit(transaction)
|
|
126
|
+
commit_changes(transaction)
|
|
127
|
+
@stats[:committed_count] += 1
|
|
128
|
+
true
|
|
129
|
+
end
|
|
130
|
+
|
|
131
|
+
def two_phase_commit(transaction)
|
|
132
|
+
@stats[:two_phase_commits] += 1
|
|
133
|
+
|
|
134
|
+
# Phase 1: Prepare
|
|
135
|
+
unless prepare(transaction)
|
|
136
|
+
return false
|
|
137
|
+
end
|
|
138
|
+
|
|
139
|
+
# Phase 2: Commit
|
|
140
|
+
commit_prepared(transaction)
|
|
141
|
+
|
|
142
|
+
true
|
|
143
|
+
end
|
|
144
|
+
|
|
145
|
+
def commit_changes(transaction)
|
|
146
|
+
# Apply all changes
|
|
147
|
+
transaction.modified_rows.each do |row_id, info|
|
|
148
|
+
@transaction_manager.engine.update_row(
|
|
149
|
+
info[:table],
|
|
150
|
+
row_id,
|
|
151
|
+
info[:new]
|
|
152
|
+
)
|
|
153
|
+
end
|
|
154
|
+
|
|
155
|
+
# Update indexes
|
|
156
|
+
if @transaction_manager.engine.respond_to?(:index_manager)
|
|
157
|
+
transaction.modified_rows.each do |row_id, info|
|
|
158
|
+
# Update index entries
|
|
159
|
+
@transaction_manager.engine.index_manager.update_row(
|
|
160
|
+
info[:table],
|
|
161
|
+
info[:old],
|
|
162
|
+
info[:new]
|
|
163
|
+
)
|
|
164
|
+
end
|
|
165
|
+
end
|
|
166
|
+
end
|
|
167
|
+
|
|
168
|
+
def rollback_changes(transaction)
|
|
169
|
+
# Rollback in reverse order
|
|
170
|
+
transaction.modified_rows.each do |row_id, info|
|
|
171
|
+
@transaction_manager.engine.update_row(
|
|
172
|
+
info[:table],
|
|
173
|
+
row_id,
|
|
174
|
+
info[:old]
|
|
175
|
+
)
|
|
176
|
+
end
|
|
177
|
+
end
|
|
178
|
+
|
|
179
|
+
def can_commit?(transaction)
|
|
180
|
+
# Check if all resources are available
|
|
181
|
+
transaction.modified_rows.each do |row_id, info|
|
|
182
|
+
# Check if no other transaction modified the same row
|
|
183
|
+
@transaction_manager.active_transactions.each do |_, other|
|
|
184
|
+
next if other.id == transaction.id
|
|
185
|
+
if other.modified_rows.key?(row_id)
|
|
186
|
+
return false
|
|
187
|
+
end
|
|
188
|
+
end
|
|
189
|
+
end
|
|
190
|
+
|
|
191
|
+
true
|
|
192
|
+
end
|
|
193
|
+
|
|
194
|
+
def start_commit_thread
|
|
195
|
+
@commit_thread = Thread.new do
|
|
196
|
+
loop do
|
|
197
|
+
sleep(1) # Process every second
|
|
198
|
+
|
|
199
|
+
begin
|
|
200
|
+
# Process commit queue
|
|
201
|
+
while !@commit_queue.empty?
|
|
202
|
+
entry = @commit_queue.shift
|
|
203
|
+
commit(entry[:transaction])
|
|
204
|
+
end
|
|
205
|
+
|
|
206
|
+
# Resolve in-doubt transactions
|
|
207
|
+
resolve_in_doubt
|
|
208
|
+
rescue => e
|
|
209
|
+
# Log error but continue
|
|
210
|
+
end
|
|
211
|
+
end
|
|
212
|
+
end
|
|
213
|
+
end
|
|
214
|
+
|
|
215
|
+
def engine
|
|
216
|
+
@transaction_manager.engine
|
|
217
|
+
end
|
|
218
|
+
end
|
|
219
|
+
end
|
|
220
|
+
end
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RubyDB
|
|
4
|
+
module Transactions
|
|
5
|
+
# Isolation - Defines isolation levels and their behaviors
|
|
6
|
+
module Isolation
|
|
7
|
+
# Isolation levels
|
|
8
|
+
READ_UNCOMMITTED = :read_uncommitted
|
|
9
|
+
READ_COMMITTED = :read_committed
|
|
10
|
+
REPEATABLE_READ = :repeatable_read
|
|
11
|
+
SERIALIZABLE = :serializable
|
|
12
|
+
|
|
13
|
+
# Phenomena that can occur at each isolation level
|
|
14
|
+
PHENOMENA = {
|
|
15
|
+
READ_UNCOMMITTED => {
|
|
16
|
+
dirty_reads: true,
|
|
17
|
+
non_repeatable_reads: true,
|
|
18
|
+
phantom_reads: true,
|
|
19
|
+
serialization_anomalies: true
|
|
20
|
+
},
|
|
21
|
+
READ_COMMITTED => {
|
|
22
|
+
dirty_reads: false,
|
|
23
|
+
non_repeatable_reads: true,
|
|
24
|
+
phantom_reads: true,
|
|
25
|
+
serialization_anomalies: true
|
|
26
|
+
},
|
|
27
|
+
REPEATABLE_READ => {
|
|
28
|
+
dirty_reads: false,
|
|
29
|
+
non_repeatable_reads: false,
|
|
30
|
+
phantom_reads: true,
|
|
31
|
+
serialization_anomalies: true
|
|
32
|
+
},
|
|
33
|
+
SERIALIZABLE => {
|
|
34
|
+
dirty_reads: false,
|
|
35
|
+
non_repeatable_reads: false,
|
|
36
|
+
phantom_reads: false,
|
|
37
|
+
serialization_anomalies: false
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
def self.dirty_reads_allowed?(level)
|
|
42
|
+
PHENOMENA[level][:dirty_reads]
|
|
43
|
+
end
|
|
44
|
+
|
|
45
|
+
def self.non_repeatable_reads_allowed?(level)
|
|
46
|
+
PHENOMENA[level][:non_repeatable_reads]
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
def self.phantom_reads_allowed?(level)
|
|
50
|
+
PHENOMENA[level][:phantom_reads]
|
|
51
|
+
end
|
|
52
|
+
|
|
53
|
+
def self.serialization_anomalies_allowed?(level)
|
|
54
|
+
PHENOMENA[level][:serialization_anomalies]
|
|
55
|
+
end
|
|
56
|
+
|
|
57
|
+
def self.isolation_level_name(level)
|
|
58
|
+
level.to_s.upcase
|
|
59
|
+
end
|
|
60
|
+
|
|
61
|
+
def self.valid_level?(level)
|
|
62
|
+
PHENOMENA.key?(level)
|
|
63
|
+
end
|
|
64
|
+
|
|
65
|
+
def self.default_level
|
|
66
|
+
READ_COMMITTED
|
|
67
|
+
end
|
|
68
|
+
|
|
69
|
+
def self.highest_level
|
|
70
|
+
SERIALIZABLE
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
def self.lowest_level
|
|
74
|
+
READ_UNCOMMITTED
|
|
75
|
+
end
|
|
76
|
+
|
|
77
|
+
def self.next_higher(level)
|
|
78
|
+
case level
|
|
79
|
+
when READ_UNCOMMITTED then READ_COMMITTED
|
|
80
|
+
when READ_COMMITTED then REPEATABLE_READ
|
|
81
|
+
when REPEATABLE_READ then SERIALIZABLE
|
|
82
|
+
when SERIALIZABLE then SERIALIZABLE
|
|
83
|
+
else default_level
|
|
84
|
+
end
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
def self.next_lower(level)
|
|
88
|
+
case level
|
|
89
|
+
when SERIALIZABLE then REPEATABLE_READ
|
|
90
|
+
when REPEATABLE_READ then READ_COMMITTED
|
|
91
|
+
when READ_COMMITTED then READ_UNCOMMITTED
|
|
92
|
+
when READ_UNCOMMITTED then READ_UNCOMMITTED
|
|
93
|
+
else default_level
|
|
94
|
+
end
|
|
95
|
+
end
|
|
96
|
+
end
|
|
97
|
+
end
|
|
98
|
+
end
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RubyDB
|
|
4
|
+
module Transactions
|
|
5
|
+
# Lock - Represents a lock on a resource
|
|
6
|
+
class Lock
|
|
7
|
+
attr_reader :key, :type, :holders, :waiters, :created_at
|
|
8
|
+
|
|
9
|
+
# Lock types
|
|
10
|
+
SHARED = :shared
|
|
11
|
+
EXCLUSIVE = :exclusive
|
|
12
|
+
UPDATE = :update
|
|
13
|
+
INTENT = :intent
|
|
14
|
+
|
|
15
|
+
def initialize(key, type, holder = nil)
|
|
16
|
+
@key = key
|
|
17
|
+
@type = type
|
|
18
|
+
@holders = {}
|
|
19
|
+
@waiters = {}
|
|
20
|
+
@created_at = Time.now
|
|
21
|
+
|
|
22
|
+
add_holder(holder, type) if holder
|
|
23
|
+
end
|
|
24
|
+
|
|
25
|
+
def add_holder(transaction, type)
|
|
26
|
+
@holders[transaction.id] = type
|
|
27
|
+
@type = type if type == EXCLUSIVE
|
|
28
|
+
end
|
|
29
|
+
|
|
30
|
+
def remove_holder(transaction)
|
|
31
|
+
@holders.delete(transaction.id)
|
|
32
|
+
@type = SHARED if @holders.empty?
|
|
33
|
+
end
|
|
34
|
+
|
|
35
|
+
def add_waiter(transaction, type)
|
|
36
|
+
@waiters[transaction.id] = type
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
def remove_waiter(transaction)
|
|
40
|
+
@waiters.delete(transaction.id)
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def shared?
|
|
44
|
+
@type == SHARED
|
|
45
|
+
end
|
|
46
|
+
|
|
47
|
+
def exclusive?
|
|
48
|
+
@type == EXCLUSIVE
|
|
49
|
+
end
|
|
50
|
+
|
|
51
|
+
def update?
|
|
52
|
+
@type == UPDATE
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
def intent?
|
|
56
|
+
@type == INTENT
|
|
57
|
+
end
|
|
58
|
+
|
|
59
|
+
def holder_count
|
|
60
|
+
@holders.size
|
|
61
|
+
end
|
|
62
|
+
|
|
63
|
+
def waiter_count
|
|
64
|
+
@waiters.size
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
def to_s
|
|
68
|
+
"Lock(key=#{@key}, type=#{@type}, holders=#{@holders.size}, waiters=#{@waiters.size})"
|
|
69
|
+
end
|
|
70
|
+
|
|
71
|
+
def inspect
|
|
72
|
+
to_s
|
|
73
|
+
end
|
|
74
|
+
end
|
|
75
|
+
end
|
|
76
|
+
end
|